levelparser's Introduction

LevelParser

A Minecraft level parser.

Currently Supporting: Minecraft: Java Edition 1.19.x

This project only supports Anvil world files at the moment, but has been designed in such a way that alternative formats can also be used.

Usage

To start, you will need to create a LevelParser object like so:

LevelParser<AnvilLevel> parser = LevelParser.<AnvilLevel>builder()
        .input(Paths.get("input"))
        .output(Paths.get("output"))
        .reader(new AnvilLevelReader())
        .writer(new AnvilLevelWriter())
        .build();

Afterward, create a new AnvilLevel which you can do like so:

AnvilLevel level = new AnvilLevel(
        0, // minHeight
        256, // maxHeight
        0, // worldTime
        new LevelData( // levelData
                new LevelData.LevelVersion( // levelVersion
                        false, // snapshot
                        "main", // series
                        3120, // dataVersion
                        "1.19.2" // name
                ),
                "My World Name", // worldName
                1, // gameType (1 = creative mode)
                10, // spawnX
                0, // spawnY
                10, // spawnZ
                System.currentTimeMillis(), // lastPlayed
                false, // hardcore
                true, // allowCommands
                List.of("vanilla"), // enabledDataPacks
                List.of(), // disabledDataPacks
                new LevelData.WorldGenSettings( // worldGenSettings
                        false, // bonusChest
                        0, // seed
                        false, // generateFeatures
                        ... // dimensions
                )
        )
);

With this level, you can now manipulate it in any way. Once you are done modifying your level, you can write it by doing the following using your parser:

parser.writeLevel(level);

Repository

Gradle

repositories {
    maven("https://jitpack.io")
}

dependencies {
    implementation("com.github.Redned235.LevelParser:anvil:master-SNAPSHOT")
}

Maven:

<repositories>
    <repository>
        <id>jitpack</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.Redned235.LevelParser</groupId>
        <artifactId>anvil</artifactId>
        <version>master-SNAPSHOT</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

levelparser's People

Stargazers

Watchers

levelparser's Issues

Feature request: Load chunks on-demand

Currently, the library loads all the world chunks into the memory this can be useful for some but not for others. I'm suggesting adding a feature that allows loading the chunks only when it is necessary.

Recommend Projects