# marcelektro/mcp-919 architecture

> Architecture diagram of the GitHub repository marcelektro/mcp-919, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcelektro/mcp-919
- Repository: https://github.com/marcelektro/mcp-919

## Overview

This repository is a Minecraft 1.8.9 MCP decompilation, accompanied by Python runtime utilities for locating, copying, and starting a Minecraft client. The Java source represents the game itself: client interaction, player/entity behavior, blocks and items, and world state. The sampled Python files show client-copy and launch relationships; the README identifies the Java tree as a decompiled project, but does not document a complete decompile-to-run pipeline. Several Java subsystems are represented from the tree and SOURCE INDEX rather than individually inspected.

Main entry points: [`src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java) (Player controller), [`src/minecraft/net/minecraft/item/crafting/CraftingManager.java`](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/crafting/CraftingManager.java) (Crafting recipes), [`runtime/clientCopy.py`](https://github.com/marcelektro/mcp-919/blob/main/runtime/clientCopy.py) (Client copy), [`src/minecraft/net/minecraft/block/Block.java`](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/Block.java) (Block behavior)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tools["Runtime utilities"]
  node_clientcopy["Client copy<br/>[clientCopy.py]"]
  node_discovery["Minecraft discovery"]
  node_commands["Runtime commands<br/>[commands.py]"]
  node_clientlaunch["Client launcher<br/>[startclient.py]"]
end

subgraph group_client["Client and networking"]
  node_minecraft["Minecraft client<br/>[Minecraft.java]"]
  node_controller["Player controller"]
  node_network["Network manager"]
  node_broadcast["Broadcast controller"]
end

subgraph group_gameplay["Gameplay domain"]
  node_entity["Entity behavior<br/>[Entity.java]"]
  node_player["Player behavior<br/>[EntityPlayer.java]"]
  node_blocks["Block behavior<br/>[Block.java]"]
  node_materials["Block materials<br/>[Material.java]"]
  node_blockstate["Block state model<br/>[BlockState.java]"]
  node_blockregistry["Block registry<br/>[Blocks.java]"]
  node_item["Item model<br/>[Item.java]"]
  node_itemstack["Item stacks<br/>[ItemStack.java]"]
  node_crafting["Crafting recipes"]
end

subgraph group_world["World and storage"]
  node_world["World simulation<br/>[World.java]"]
  node_blockpos["Block coordinates<br/>[BlockPos.java]"]
  node_chunkstorage["Chunk block storage"]
  node_mapstorage[("Saved map data<br/>[MapStorage.java]")]
  node_nbt["NBT data"]
end

node_user(("Player or operator"))

node_user -.->|"requests copy"| node_clientcopy
node_clientcopy -->|"discovers install"| node_discovery
node_clientcopy -->|"uses commands"| node_commands
node_clientlaunch -->|"uses commands"| node_commands
node_controller -->|"uses client state"| node_minecraft
node_controller -->|"reads blocks"| node_blocks
node_controller -->|"checks material"| node_materials
node_controller -->|"reads block state"| node_blockstate
node_controller -->|"acts for player"| node_player
node_controller -->|"uses item stacks"| node_itemstack
node_crafting -->|"uses blocks"| node_blocks
node_crafting -->|"uses block catalog"| node_blockregistry
node_crafting -->|"uses items"| node_item
node_crafting -->|"produces stacks"| node_itemstack
node_chunkstorage -->|"stores block states"| node_blocks
node_chunkstorage -->|"stores states"| node_blockstate
node_mapstorage -->|"loads and saves"| node_nbt
node_mapstorage -.->|"world saved data"| node_world
node_minecraft -->|"initializes stream"| node_broadcast
node_user -.->|"plays through"| node_controller

click node_clientcopy "https://github.com/marcelektro/mcp-919/blob/main/runtime/clientCopy.py"
click node_discovery "https://github.com/marcelektro/mcp-919/blob/main/runtime/MinecraftDiscovery.py"
click node_commands "https://github.com/marcelektro/mcp-919/blob/main/runtime/commands.py"
click node_clientlaunch "https://github.com/marcelektro/mcp-919/blob/main/runtime/startclient.py"
click node_minecraft "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/Minecraft.java"
click node_controller "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java"
click node_network "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/network/NetworkManager.java"
click node_broadcast "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/stream/BroadcastController.java"
click node_entity "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/entity/Entity.java"
click node_player "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/entity/player/EntityPlayer.java"
click node_blocks "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/Block.java"
click node_materials "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/material/Material.java"
click node_blockstate "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/state/BlockState.java"
click node_blockregistry "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/init/Blocks.java"
click node_item "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/Item.java"
click node_itemstack "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/ItemStack.java"
click node_crafting "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/crafting/CraftingManager.java"
click node_world "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/world/World.java"
click node_blockpos "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/util/BlockPos.java"
click node_chunkstorage "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/world/chunk/storage/ExtendedBlockStorage.java"
click node_mapstorage "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/world/storage/MapStorage.java"
click node_nbt "https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/nbt/NBTTagCompound.java"

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_clientcopy,node_discovery,node_commands,node_clientlaunch toneBlue
class node_minecraft,node_controller,node_network,node_broadcast toneAmber
class node_entity,node_player,node_blocks,node_materials,node_blockstate,node_blockregistry,node_item,node_itemstack,node_crafting toneMint
class node_world,node_blockpos,node_chunkstorage,node_mapstorage,node_nbt toneRose
class node_user toneIndigo
```

## Components

### Runtime utilities

- [Client copy](https://github.com/marcelektro/mcp-919/blob/main/runtime/clientCopy.py): `runtime/clientCopy.py`
- [Minecraft discovery](https://github.com/marcelektro/mcp-919/blob/main/runtime/MinecraftDiscovery.py): `runtime/MinecraftDiscovery.py`
- [Runtime commands](https://github.com/marcelektro/mcp-919/blob/main/runtime/commands.py): `runtime/commands.py`
- [Client launcher](https://github.com/marcelektro/mcp-919/blob/main/runtime/startclient.py): `runtime/startclient.py`

### Client and networking

- [Minecraft client](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/Minecraft.java): `src/minecraft/net/minecraft/client/Minecraft.java`
- [Player controller](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java): `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`
- [Network manager](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/network/NetworkManager.java): `src/minecraft/net/minecraft/network/NetworkManager.java`
- [Broadcast controller](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/client/stream/BroadcastController.java): `src/minecraft/net/minecraft/client/stream/BroadcastController.java`

### Gameplay domain

- [Entity behavior](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/entity/Entity.java): `src/minecraft/net/minecraft/entity/Entity.java`
- [Player behavior](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/entity/player/EntityPlayer.java): `src/minecraft/net/minecraft/entity/player/EntityPlayer.java`
- [Block behavior](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/Block.java): `src/minecraft/net/minecraft/block/Block.java`
- [Block materials](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/material/Material.java): `src/minecraft/net/minecraft/block/material/Material.java`
- [Block state model](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/block/state/BlockState.java): `src/minecraft/net/minecraft/block/state/BlockState.java`
- [Block registry](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/init/Blocks.java): `src/minecraft/net/minecraft/init/Blocks.java`
- [Item model](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/Item.java): `src/minecraft/net/minecraft/item/Item.java`
- [Item stacks](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/ItemStack.java): `src/minecraft/net/minecraft/item/ItemStack.java`
- [Crafting recipes](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/item/crafting/CraftingManager.java): `src/minecraft/net/minecraft/item/crafting/CraftingManager.java`

### World and storage

- [World simulation](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/world/World.java): `src/minecraft/net/minecraft/world/World.java`
- [Block coordinates](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/util/BlockPos.java): `src/minecraft/net/minecraft/util/BlockPos.java`
- [Chunk block storage](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/world/chunk/storage/ExtendedBlockStorage.java): `src/minecraft/net/minecraft/world/chunk/storage/ExtendedBlockStorage.java`
- [Saved map data](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/world/storage/MapStorage.java): `src/minecraft/net/minecraft/world/storage/MapStorage.java`
- [NBT data](https://github.com/marcelektro/mcp-919/blob/main/src/minecraft/net/minecraft/nbt/NBTTagCompound.java): `src/minecraft/net/minecraft/nbt/NBTTagCompound.java`

### Other components

- **Player or operator**

## Connections

- Player or operator → Client copy: requests copy
- Client copy → Minecraft discovery: discovers install (evidence: `runtime/clientCopy.py`)
- Client copy → Runtime commands: uses commands (evidence: `runtime/clientCopy.py`)
- Client launcher → Runtime commands: uses commands (evidence: `runtime/startclient.py`)
- Player controller → Minecraft client: uses client state (evidence: `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`)
- Player controller → Block behavior: reads blocks (evidence: `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`)
- Player controller → Block materials: checks material (evidence: `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`)
- Player controller → Block state model: reads block state (evidence: `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`)
- Player controller → Player behavior: acts for player (evidence: `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`)
- Player controller → Item stacks: uses item stacks (evidence: `src/minecraft/net/minecraft/client/multiplayer/PlayerControllerMP.java`)
- Crafting recipes → Block behavior: uses blocks (evidence: `src/minecraft/net/minecraft/item/crafting/CraftingManager.java`)
- Crafting recipes → Block registry: uses block catalog (evidence: `src/minecraft/net/minecraft/item/crafting/CraftingManager.java`)
- Crafting recipes → Item model: uses items (evidence: `src/minecraft/net/minecraft/item/crafting/CraftingManager.java`)
- Crafting recipes → Item stacks: produces stacks (evidence: `src/minecraft/net/minecraft/item/crafting/CraftingManager.java`)
- Chunk block storage → Block behavior: stores block states (evidence: `src/minecraft/net/minecraft/world/chunk/storage/ExtendedBlockStorage.java`)
- Chunk block storage → Block state model: stores states (evidence: `src/minecraft/net/minecraft/world/chunk/storage/ExtendedBlockStorage.java`)
- Saved map data → NBT data: loads and saves (evidence: `src/minecraft/net/minecraft/world/storage/MapStorage.java`)
- Saved map data → World simulation: world saved data (evidence: `src/minecraft/net/minecraft/world/World.java`)
- Minecraft client → Broadcast controller: initializes stream (evidence: `src/minecraft/net/minecraft/client/Minecraft.java`)
- Player or operator → Player controller: plays through
