A Rust framework for building Minecraft: Java Edition servers.

Built on top of Bevy ECS, ChunkEdge is an effort to create a Minecraft-compatible server completely from scratch in Rust. You can think of ChunkEdge as a game engine for Minecraft servers similar to the Minestom project. It doesn't do much by default, but by writing game logic yourself and leveraging Bevy's powerful plugin system, you can make almost anything.

Opinionated features like dynamic scripting, dedicated executables, and vanilla game mechanics are all expected to be built as optional plugins. This level of modularity is desirable for those looking to build highly custom experiences in Minecraft such as minigame servers.

ChunkEdge aims to be the following:

• Complete. Abstractions for the full breadth of the Minecraft protocol.
• Flexible. ChunkEdge can be easily extended from within user code. Direct access to the Minecraft protocol is provided.
• Modular. Pick and choose the components you need. Some crates can also be reused in projects that don't use the full ChunkEdge framework.
• Intuitive. An API that is easy to use and difficult to misuse. Extensive documentation and examples are important.
• Efficient. Optimal use of system resources with multiple CPU cores in mind.
• Up-to-date. Tries to be up-to-date with the most recent stable version of Minecraft. Currently Minecraft 1.21.5 is supported. Support for multiple versions at once is not planned. However, you can use a proxy (for example ViaProxy combined with Velocity) to allow players on both older and newer clients to connect to your server.

Here are some noteworthy achievements:

• chunkedge_nbt: A speedy new library for Minecraft's Named Binary Tag (NBT) format.
• Authentication, encryption, and compression
• Block states
• Chunks
• Entities and metadata
• Bounding volume hierarchy for fast spatial entity queries
• Player list and player skins
• Dimensions, biomes, and worlds
• JSON Text API
• A Fabric mod for extracting data from the game into JSON files. These files are processed by a build script to generate Rust code for the project. The JSON files can be used in other projects as well.
• Inventories
• Items
• Particles
• Anvil file format (read-only)
• Proxy support (Velocity)

To create your own server project using ChunkEdge, please see the Getting Started guide.

Other usefull resources from the documentation include:

• Full API Documentation (rustdoc)
• General docs page with links to guides and the FAQ

After cloning the repository, run this command to try an example.

cargo r -r --example parkour

List all available examples with:

cargo run --example

Recommended examples to try are parkour, game_of_life, terrain, and cow_sphere.

Open your Minecraft client and connect to the address localhost. If all goes well, you should be able to play the example.

Contributions are welcome! Please see CONTRIBUTING.md. You can use GitHub Discussions to discuss the project and ask questions.

The source code in this repository is licensed under the MIT License, except where otherwise noted.

The project name, logo, icons, and other branding assets are not licensed under the MIT License. They are reserved by the repository owner Job Paardekooper and may not be used in a way that suggests endorsement, affiliation, or official status without prior written permission.

This project is a fork of valence-rs/valence, combined with code from the then-open Minecraft protocol update PR / branch.