MCPcopy Index your code
hub / github.com/ZeppelinMC/Zeppelin

github.com/ZeppelinMC/Zeppelin @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
4,364 symbols 7,693 edges 1,350 files 178 documented · 4%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

zeppelinbanner (1)

Zeppelin

Highly optimized server implementation written in Go for Minecraft 1.21.3

Discord Server

Goal

A fast, efficient, and reliable server, with a plugin API and clean code

Protocol Coverage

  • Packet encryption (AES/CFB8)

  • Packet compression (Zlib)

  • Authentication

  • Named Binary Tag (NBT)

  • Text formatting

  • Chat signing

Progress

  • Chunk encoding and manipulation

  • Region/Anvil decoding and encoding (temp disabled)

  • WIP terrain generation

  • Player movement including metadata

API

Protocol:

  • NBT: protocol/nbt

  • .properties: protocol/properties

  • text formatting: protocol/text

  • network and packets: protocol/net

Server:

  • Commands: server/command (server.CommandManager) - can register custom commands

  • World: server/world (server.World) - can register custom dimensions, modify chunks etc

  • Registry: server/registry - shared registry constants

  • Container (inventory): server/container

  • Player: server/player (Session.Player())

  • Session: server/session (api) | server/session/std (impl)

Boot Arguments

--no-plugins: skips plugin loading

--memprof: uses memory profiler

--cpuprof: uses cpu profiler

--xmem=<amount>: limits memory usage to amount, for example: --xmem=1gib

Acknowledgements

Angel - help with chunk related calculations (0x8D989E86)

Extension points exported contracts — how you extend this code

Encodeable (Interface)
Encodeable is a clientbound packet [87 implementers]
protocol/net/packet/packet.go
BlockEntityHaver (Interface)
A block state haver is one that also has a block state [39 implementers]
server/world/block/0block.go
Caller (Interface)
(no doc) [2 implementers]
server/command/manager.go
Decodeable (Interface)
Decodeable is a serverbound packet [86 implementers]
protocol/net/packet/packet.go
Block (Interface)
(no doc) [1061 implementers]
server/world/chunk/section/block.go
StatusProvider (FuncType)
(no doc)
protocol/net/config.go
Usable (Interface)
A usable block is a block which performs a certain action when left clicked
server/world/block/0block.go
BlockCustomPlaceSoundHaver (Interface)
A block custom place sound haver is one that has a custom place sound
server/world/block/0block.go

Core symbols most depended-on inside this repo

RegisterBlock
called by 1060
server/world/chunk/section/blockRegister.go
VarInt
called by 213
protocol/net/io/encoding/reader.go
Type
called by 155
server/entity/entity.go
atoi
called by 132
server/world/block/0block.go
Bool
called by 89
protocol/net/io/encoding/reader.go
Float
called by 64
protocol/net/io/encoding/reader.go
writeByte
called by 47
protocol/nbt/encoder.go
Set
called by 45
protocol/net/io/encoding/encoding.go

Shape

Method 2,853
Struct 1,289
Function 168
TypeAlias 44
Interface 9
FuncType 1

Languages

Go100%

Modules by API surface

server/entity/entity.go30 symbols
protocol/net/io/encoding/reader.go29 symbols
protocol/net/metadata/metadata.go28 symbols
util/log/log.go26 symbols
protocol/net/io/encoding/writer.go26 symbols
protocol/nbt/decoder.go24 symbols
protocol/net/io/encoding/encoding.go22 symbols
server/world/dimension/dimension.go20 symbols
protocol/nbt/qnbt/primitive.go20 symbols
protocol/net/conn.go19 symbols
protocol/nbt/staticReader.go19 symbols
protocol/nbt/encoder.go18 symbols

For agents

$ claude mcp add Zeppelin \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact