> For the complete documentation index, see [llms.txt](https://docs.onelitefeather.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onelitefeather.net/falco/tutorials/load-your-first-world-with-falco.md). # Load your first world with Falco By the end of this you will have a Minestom server that serves a stored Anvil world through `FalcoAnvilLoader`, lights it with `falco-light`, and shuts down without losing a chunk. You need Java 25, a Gradle project, and a saved Minecraft world directory. Nothing else. This takes about fifteen minutes. This tutorial follows one path: a world saved by Minecraft 26.1 or later. If your world predates 26.1, follow [How-to Load an Anvil world](/falco/how-to-guides/load-an-anvil-world.md) instead; it covers the older layout. ## Declare the dependencies 1. Add the OneLiteFeather repository and the Falco platform to `build.gradle.kts`: ```kotlin repositories { mavenCentral() maven("https://repo.onelitefeather.dev/releases") } dependencies { implementation(platform("net.onelitefeather:falco-bom:3.0.1")) implementation("net.onelitefeather:falco-anvil") implementation("net.onelitefeather:falco-light") implementation("net.minestom:minestom:2026.10.07-26.2") } ``` 2. Refresh the Gradle project. You should now see `net.onelitefeather.falco.anvil.FalcoAnvilLoader` resolve in your editor. ## Put the world where the loader will find it 1. Copy your saved world directory into your project as `worlds/lobby`, so that the region files sit at `worlds/lobby/dimensions/minecraft/overworld/region`. You should now see at least one `r...mca` file inside that `region` directory. ## Serve the world 1. Create the server class: ```java import net.kyori.adventure.key.Key; import net.minestom.server.MinecraftServer; import net.minestom.server.instance.InstanceContainer; import net.minestom.server.world.DimensionType; import net.onelitefeather.falco.anvil.FalcoAnvilLoader; import java.io.IOException; import java.nio.file.Path; public final class FirstServer { public static void main(String[] args) { MinecraftServer server = MinecraftServer.init(); InstanceContainer instance = MinecraftServer.getInstanceManager() .createInstanceContainer(DimensionType.OVERWORLD); Key dimension = DimensionType.OVERWORLD.key(); FalcoAnvilLoader loader = new FalcoAnvilLoader(Path.of("worlds", "lobby"), dimension); instance.setChunkLoader(loader); instance.enableAutoChunkLoad(true); Runtime.getRuntime().addShutdownHook(new Thread(() -> { try { loader.close(); } catch (IOException exception) { exception.printStackTrace(); } })); server.start("0.0.0.0", 25565); } } ``` 2. Run it. You should now see a log line at `INFO` from `FalcoAnvilLoader` naming the region directory it resolved and the dimension. Connect with a client and you are standing in your stored world, not in freshly generated terrain. ## Light it 1. Add two imports to the list at the top of `FirstServer.java`: ```java import net.onelitefeather.falco.light.ChunkLightScheduler; import net.onelitefeather.falco.light.ChunkLightService; ``` 2. Add the scheduler to `main`, just above `server.start`: ```java ChunkLightScheduler scheduler = new ChunkLightScheduler(new ChunkLightService()); instance.setChunkSupplier(scheduler.supplier()); ``` 3. Run it again, walk into a dark room, and place a torch. You should now see the blocks next to the torch lit within one tick, and the light fade with distance, without any call of your own. A room that stays dark after the torch is placed means the scheduler step was skipped. ## Shut it down cleanly 1. Stop the server with Ctrl+C. You should now see a second `FalcoAnvilLoader` line at `INFO`: the close summary, naming loaded chunks, skipped chunks, saved chunks and errors. `errors=0` is what a clean run looks like. If it is above zero the line is logged at `WARN` instead, so a shutdown that lost chunks does not read like a clean one. The levels and the second line are described in [Reference Logging](/falco/reference/logging.md). ## Next * [How-to Load an Anvil world](/falco/how-to-guides/load-an-anvil-world.md) covers the map-provider form and the cached-region limit. * [Explanation Choosing between Falco and the built-in loader](/falco/explanation/choosing-between-falco-and-the-built-in-loader.md) explains which of the differences between the two loaders actually carry a decision. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.onelitefeather.net/falco/tutorials/load-your-first-world-with-falco.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.