Composition

Composition is a new Minecraft server written from the ground-up in Rust.

Composition is targeting Minecraft version 1.19.4, protocol version 762. The main goal is to get a working server, then optimize for speed (multi-threading/kubernetes/etc).

Features

• Server status (favicon included)
• Authentication
• Encryption/compression
• World
  • World generation
    • Flat world generation
    • More complex world generation
  • World updates (placing/breaking blocks)
  • World saving (probably custom format)
• Chat
  • Player chat
  • System chat
  • Console input
  • Commands
• Collisions and physics
  • Player movement
• Entities
  • Spawning
  • AI
• Inventory
  • Items
  • Chests/Shulkers/etc.
  • Crafting/Smelting/etc.
• Plugins (WASM)
• Future ideas (k8s, mods, anti-cheat, etc.)

Project Structure

Composition is broken up into multiple crates to speed up build times and improve modularity.

• composition-core implements the main server logic, such as handling clients and loading world chunks. It also sets up logging and loads the main configuration. This is the main binary that is exported with cargo build.
• composition-protocol handles the types and packets needed for network communication as well as general Minecraft types, such as entities, items, and blocks. The library was designed to be able to used by anyone looking to implement a Minecraft server.
• composition-world generates the world and updates the entities and blocks within it. In the future, the world might be extracted into its own server so that multiple "server cores" can process players on the same world.
• composition-parsing is a utility library that helps with parsing.

Useful Resources

• Protocol Specification
• Normal Login Sequence
• Server Ping
• Map Format