# pumpkin-mc/pumpkin-java-multiversion architecture

> Architecture diagram of the GitHub repository pumpkin-mc/pumpkin-java-multiversion, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pumpkin-mc/pumpkin-java-multiversion
- Repository: https://github.com/pumpkin-mc/pumpkin-java-multiversion

## Overview

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: [`src/lib.rs`](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/lib.rs) (Version handlers), [`src/packet/translator.rs`](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/packet/translator.rs) (Packet translator), [`src/translate`](https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/translate) (Payload translators), [`src/translate/entity_data.rs`](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/entity_data.rs) (Entity metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin runtime"]
  node_plugin["Version handlers<br/>[lib.rs]"]
end

subgraph group_routing["Packet routing"]
  node_translator["Packet translator<br/>[translator.rs]"]
  node_packetids["Packet ID lookup<br/>[ids.rs]"]
end

subgraph group_domains["Payload translation"]
  node_payload["Payload translators"]
  node_chunks["Chunk formats<br/>[chunk.rs]"]
  node_inventory["Inventory items<br/>[inventory.rs]"]
  node_entitydata["Entity metadata<br/>[entity_data.rs]"]
  node_serverbound["Clientbound requests<br/>[serverbound.rs]"]
end

subgraph group_support["Compatibility data"]
  node_remaps["ID remappings"]
  node_legacy["Legacy packet layouts"]
  node_tags["Join tags<br/>[tags.rs]"]
  node_state[("Entity tracking<br/>[entity_data.rs]")]
end

node_client(("Older Java client"))
node_pumpkin(("Pumpkin server"))

node_client -->|"sends packets"| node_plugin
node_pumpkin -->|"emits packets"| node_plugin
node_plugin -->|"translates packets"| node_translator
node_translator -->|"maps IDs"| node_packetids
node_translator -->|"dispatches payloads"| node_payload
node_translator -->|"dispatches requests"| node_serverbound
node_payload -.->|"delegates chunks"| node_chunks
node_payload -.->|"delegates inventory"| node_inventory
node_payload -.->|"delegates metadata"| node_entitydata
node_chunks -->|"maps block states"| node_remaps
node_inventory -->|"maps item IDs"| node_remaps
node_entitydata -->|"maps registry IDs"| node_remaps
node_plugin -->|"adds join tags"| node_tags
node_plugin -->|"tracks viewers"| node_state
node_entitydata -->|"tracks entity types"| node_state
node_translator -.->|"uses legacy layouts"| node_legacy
node_plugin -->|"returns translated packets"| node_client
node_plugin -->|"forwards translated packets"| node_pumpkin

click node_plugin "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/lib.rs"
click node_translator "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/packet/translator.rs"
click node_packetids "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/legacy/ids.rs"
click node_payload "https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/translate"
click node_chunks "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/chunk.rs"
click node_inventory "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/inventory.rs"
click node_entitydata "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/entity_data.rs"
click node_serverbound "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/serverbound.rs"
click node_remaps "https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/remap"
click node_legacy "https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/legacy"
click node_tags "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/tags.rs"
click node_state "https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/entity_data.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_client toneBlue
class node_translator,node_packetids toneAmber
class node_payload,node_chunks,node_inventory,node_entitydata,node_serverbound,node_pumpkin toneMint
class node_remaps,node_legacy,node_tags,node_state toneRose
```

## Components

### Plugin runtime

- [Version handlers](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/lib.rs): `src/lib.rs`

### Packet routing

- [Packet translator](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/packet/translator.rs): `src/packet/translator.rs`
- [Packet ID lookup](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/legacy/ids.rs): `src/legacy/ids.rs`

### Payload translation

- [Payload translators](https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/translate): `src/translate`
- [Chunk formats](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/chunk.rs): `src/translate/chunk.rs`
- [Inventory items](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/inventory.rs): `src/translate/inventory.rs`
- [Entity metadata](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/entity_data.rs): `src/translate/entity_data.rs`
- [Clientbound requests](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/serverbound.rs): `src/translate/serverbound.rs`

### Compatibility data

- [ID remappings](https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/remap): `src/remap`
- [Legacy packet layouts](https://github.com/pumpkin-mc/pumpkin-java-multiversion/tree/master/src/legacy): `src/legacy`
- [Join tags](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/tags.rs): `src/translate/tags.rs`
- [Entity tracking](https://github.com/pumpkin-mc/pumpkin-java-multiversion/blob/master/src/translate/entity_data.rs): `src/translate/entity_data.rs`

### Other components

- **Older Java client**
- **Pumpkin server**

## Connections

- Older Java client → Version handlers: sends packets (evidence: `src/lib.rs`)
- Pumpkin server → Version handlers: emits packets (evidence: `src/lib.rs`)
- Version handlers → Packet translator: translates packets (evidence: `src/lib.rs`)
- Packet translator → Packet ID lookup: maps IDs (evidence: `src/packet/translator.rs`)
- Packet translator → Payload translators: dispatches payloads (evidence: `src/packet/translator.rs`)
- Packet translator → Clientbound requests: dispatches requests (evidence: `src/packet/translator.rs`)
- Payload translators → Chunk formats: delegates chunks (evidence: `src/translate/mod.rs`)
- Payload translators → Inventory items: delegates inventory (evidence: `src/translate/mod.rs`)
- Payload translators → Entity metadata: delegates metadata (evidence: `src/translate/mod.rs`)
- Chunk formats → ID remappings: maps block states (evidence: `src/translate/chunk.rs`)
- Inventory items → ID remappings: maps item IDs (evidence: `src/translate/inventory.rs`)
- Entity metadata → ID remappings: maps registry IDs (evidence: `src/translate/entity_data.rs`)
- Version handlers → Join tags: adds join tags (evidence: `src/lib.rs`)
- Version handlers → Entity tracking: tracks viewers (evidence: `src/lib.rs`)
- Entity metadata → Entity tracking: tracks entity types (evidence: `src/translate/entity_data.rs`)
- Packet translator → Legacy packet layouts: uses legacy layouts (evidence: `src/packet/translator.rs`)
- Version handlers → Older Java client: returns translated packets (evidence: `src/lib.rs`)
- Version handlers → Pumpkin server: forwards translated packets (evidence: `src/lib.rs`)
