How pumpkin-mc/pumpkin works
Pumpkin is a Rust Minecraft server. A player connects through the Java or Bedrock protocol, interacts with server-managed player, command, inventory, and world systems, and receives game-state updates. The server also loads configuration and plugins; world processing includes chunk lifecycle and lighting. The graph reflects documented capabilities and indexed source references; several major subsystems are represented at directory level because their implementation was not sampled.
Main entry points: mod.rs Server orchestration · player.rs Player state · net Network services · level.rs World management
Components 20
Server runtime
- Server orchestration
crates/pumpkin/src/server/mod.rs - Server startup
crates/pumpkin/src/main.rs - Tick control
crates/pumpkin/src/server/tick_rate_manager.rs
Network and configuration
- Java and Bedrock
crates/pumpkin-protocol/src - Network services
crates/pumpkin/src/net - Server configuration
crates/pumpkin-config/src
Player gameplay
- Command processing
crates/pumpkin-command/src - Player state
crates/pumpkin/src/entity/player.rs - Inventory handling
crates/pumpkin-inventory/src/screen_handler.rs - Crafting recipes
crates/pumpkin-inventory/src/crafting/crafting_screen_handler.rs - Entity equipment
crates/pumpkin-inventory/src/entity_equipment.rs
World simulation
- World management
crates/pumpkin-world/src/level.rs - Chunk lifecycle
crates/pumpkin-world/src/chunk_system/chunk_state.rs - Chunk generation
crates/pumpkin-world/src/chunk_system/generation_cache.rs - Light propagation
crates/pumpkin-world/src/lighting/engine.rs - Light storage
crates/pumpkin-world/src/lighting/storage.rs
Extensions
- Plugin system
crates/pumpkin/src/plugin - Plugin API
crates/pumpkin-plugin-api/src - Game tests
crates/pumpkin/src/server/server_test_manager.rs
Other components
- Minecraft player
Connections 18
- Minecraft player → Network services: connects through
- Network services → Java and Bedrock: handles packets
- Server startup → Server orchestration: starts
crates/pumpkin/src/main.rs - Server orchestration → Network services: manages
crates/pumpkin/src/server/mod.rs - Server orchestration → World management: manages
crates/pumpkin/src/server/mod.rs - Server orchestration → Player state: manages
crates/pumpkin/src/server/mod.rs - Server orchestration → Command processing: configures
crates/pumpkin/src/server/mod.rs - Server orchestration → Plugin system: initializes
crates/pumpkin/src/server/mod.rs - Server orchestration → Tick control: ticks
crates/pumpkin/src/server/mod.rs - Server orchestration → Server configuration: uses settings
- Player state → Inventory handling: uses screens
- Crafting recipes → Inventory handling: builds screen
crates/pumpkin-inventory/src/crafting/crafting_screen_handler.rs - Player state → Entity equipment: tracks equipment
- World management → Chunk lifecycle: manages chunks
crates/pumpkin-world/src/chunk_system/chunk_state.rs - Chunk lifecycle → Chunk generation: requests generation
crates/pumpkin-world/src/chunk_system/generation_cache.rs - Light propagation → Light storage: reads and writes
crates/pumpkin-world/src/lighting/engine.rs - Plugin system → Plugin API: exposes
- Server orchestration → Game tests: runs tests
crates/pumpkin/src/server/mod.rs