#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

#1993 in Encoding

Download history 26/week @ 2024-03-11 32/week @ 2024-03-18 51/week @ 2024-03-25 71/week @ 2024-04-01 19/week @ 2024-04-08 22/week @ 2024-04-15 27/week @ 2024-04-22 25/week @ 2024-04-29 30/week @ 2024-05-06 29/week @ 2024-05-13 29/week @ 2024-05-20 16/week @ 2024-05-27 20/week @ 2024-06-03 28/week @ 2024-06-10 16/week @ 2024-06-17 34/week @ 2024-06-24

98 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

~2MB
~40K SLoC