How pumpkin-mc/pumpkin-java-multiversion works
This is a Pumpkin WASM protocol-translation plugin: it registers supported Java versions and intercepts client/server packets, translating old-client traffic to and from Pumpkin’s current protocol. Translation spans packet IDs and payloads, then domain-specific layouts such as chunks, inventory, entities, registries, chat, and login; remap tables and legacy encoders support those conversions. The README documents broad version coverage and chunk-format adaptation. Some subsystem links are omitted where sampled excerpts do not establish the caller; optional integration is not inferred.
Main entry points: lib.rs Version handlers · translator.rs Packet translator · translate Payload translators · entity_data.rs Entity metadata
Components 14
Plugin runtime
- Version handlers
src/lib.rs
Packet routing
- Packet translator
src/packet/translator.rs - Packet ID lookup
src/legacy/ids.rs
Payload translation
- Payload translators
src/translate - Chunk formats
src/translate/chunk.rs - Inventory items
src/translate/inventory.rs - Entity metadata
src/translate/entity_data.rs - Clientbound requests
src/translate/serverbound.rs
Compatibility data
- ID remappings
src/remap - Legacy packet layouts
src/legacy - Join tags
src/translate/tags.rs - Entity tracking
src/translate/entity_data.rs
Other components
- Older Java client
- Pumpkin server
Connections 18
- Older Java client → Version handlers: sends packets
src/lib.rs - Pumpkin server → Version handlers: emits packets
src/lib.rs - Version handlers → Packet translator: translates packets
src/lib.rs - Packet translator → Packet ID lookup: maps IDs
src/packet/translator.rs - Packet translator → Payload translators: dispatches payloads
src/packet/translator.rs - Packet translator → Clientbound requests: dispatches requests
src/packet/translator.rs - Payload translators → Chunk formats: delegates chunks
src/translate/mod.rs - Payload translators → Inventory items: delegates inventory
src/translate/mod.rs - Payload translators → Entity metadata: delegates metadata
src/translate/mod.rs - Chunk formats → ID remappings: maps block states
src/translate/chunk.rs - Inventory items → ID remappings: maps item IDs
src/translate/inventory.rs - Entity metadata → ID remappings: maps registry IDs
src/translate/entity_data.rs - Version handlers → Join tags: adds join tags
src/lib.rs - Version handlers → Entity tracking: tracks viewers
src/lib.rs - Entity metadata → Entity tracking: tracks entity types
src/translate/entity_data.rs - Packet translator → Legacy packet layouts: uses legacy layouts
src/packet/translator.rs - Version handlers → Older Java client: returns translated packets
src/lib.rs - Version handlers → Pumpkin server: forwards translated packets
src/lib.rs