#minecraft-server #graphite-minecraft #binary #serialization #binary-encoding #guarantees #19

graphite_binary

Efficient binary serialization for the graphite_minecraft project

1 unstable release

0.1.0 Sep 11, 2022

#1858 in Encoding

Download history 17/week @ 2023-12-18 16/week @ 2023-12-25 20/week @ 2024-01-08 8/week @ 2024-01-15 6/week @ 2024-02-05 23/week @ 2024-02-12 19/week @ 2024-02-19 43/week @ 2024-02-26 27/week @ 2024-03-04 26/week @ 2024-03-11 32/week @ 2024-03-18 51/week @ 2024-03-25 71/week @ 2024-04-01

188 downloads per month
Used in 10 crates (8 directly)

Apache-2.0

76KB
2K SLoC

Graphite -- CURRENTLY ON HIATUS

1.19.1 Minecraft Server

TODO

  • Complete protocol with all 1.19.1 Minecraft packets
  • Command dispatch system
  • Viewable objects (entities)
  • Allow multiple players to connect (and see each other)
  • Base lib crate that reexports everything
  • ItemStacks with NBT
  • Add layer for modifying the NBT of items easily
  • Player Input Handling (Left/Right Click Air/Block)
  • TextComponent things & macro
  • Allow chunk/world modification
  • Complete missing block placement (walls, double blocks, candles, etc.)
  • "Extras" subproject - raycasting, collision, ...

Subprojects

  • example_server: Example server using various Graphite components
  • server: The minecraft server. Entities, chunks, players, all that good stuff
  • concierge: Component that accepts new connections, handles status and login. Can be used to create proxies, servers, etc.
  • protocol: The minecraft protocol
  • net: Networking components and utilities
  • binary: Zero-copy serialization
  • command: Command dispatch and low-level creation
  • command_derive: Attribute macro to easily create commands
  • sticky: Collection(s) that guarantee the memory-location of its contents

Warning

Project is currently under heavy development, many things are completely non-functional

Building

Make sure to run git submodule update --init --recursive before building/running

How to run the example server

!!! Currently Graphite only supports modern versions of Linux with io_uring !!!
(An alternative network backend will be available eventually, but is not a priority)

$ cargo run --bin example_server

Dependencies

~0.6–1.1MB
~24K SLoC