# illusd/peanutengine architecture

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

- Interactive diagram: https://gitdiagram.com/illusd/peanutengine
- Repository: https://github.com/illusd/peanutengine

## Overview

PeanutEngine is presented as a Minecraft Bedrock server mod. The principal documented workflow is a player using `/pe:` commands or in-game actions to access server features. The tree contains a Java source payload and a Bedrock behavior-pack directory, but not the decoded runtime sources, so the feature branches below reflect README-documented capabilities rather than inspected internal calls. The README does not establish how the Java and Bedrock components divide responsibilities or how state is stored.

Main entry points: [`MOD/java/PeanutEnginePlugin.java.gz.b64.a`](https://github.com/illusd/peanutengine/blob/main/MOD/java/PeanutEnginePlugin.java.gz.b64.a) (PeanutEngine runtime), [`MOD/java`](https://github.com/illusd/peanutengine/tree/main/MOD/java) (Economy), [`MOD/bedrock/PeanutEngine_BP`](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP) (Vein mining)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Player access"]
  node_runtime["PeanutEngine runtime"]
  node_commands["Commands"]
end

subgraph group_economy["Economy"]
  node_economy["Economy"]
  node_money["Balance and pay"]
  node_auction["Item selling"]
  node_backpack["Backpack"]
end

subgraph group_travel["Travel and homes"]
  node_teleport["Player teleport"]
  node_random["Random teleport"]
  node_homes["Homes"]
  node_sleep["Bed return"]
end

subgraph group_world["World features"]
  node_claims["Land claims"]
  node_mining["Vein mining"]
  node_trees["Tree felling"]
  node_doors["Door sync"]
  node_nightvision["Offhand vision"]
  node_night["Skip night"]
  node_bed["Bed location"]
end

node_player(("Player"))

node_player -->|"uses"| node_commands
node_commands -.->|"invokes"| node_runtime
node_runtime -->|"provides"| node_economy
node_runtime -->|"provides"| node_teleport
node_runtime -->|"provides"| node_random
node_runtime -->|"provides"| node_homes
node_runtime -->|"provides"| node_sleep
node_runtime -->|"provides"| node_claims
node_runtime -->|"provides"| node_mining
node_runtime -->|"provides"| node_trees
node_runtime -->|"provides"| node_doors
node_runtime -->|"provides"| node_nightvision
node_runtime -->|"provides"| node_night
node_runtime -->|"provides"| node_bed
node_economy -->|"includes"| node_money
node_economy -->|"includes"| node_auction
node_economy -->|"includes"| node_backpack

click node_runtime "https://github.com/illusd/peanutengine/blob/main/MOD/java/PeanutEnginePlugin.java.gz.b64.a"
click node_commands "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_economy "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_money "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_auction "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_backpack "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_teleport "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_random "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_homes "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_sleep "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_claims "https://github.com/illusd/peanutengine/tree/main/MOD/java"
click node_mining "https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP"
click node_trees "https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP"
click node_doors "https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP"
click node_nightvision "https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP"
click node_night "https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP"
click node_bed "https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP"

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_runtime,node_commands toneBlue
class node_economy,node_money,node_auction,node_backpack toneAmber
class node_teleport,node_random,node_homes,node_sleep toneMint
class node_claims,node_mining,node_trees,node_doors,node_nightvision,node_night,node_bed toneRose
class node_player toneIndigo
```

## Components

### Player access

- [PeanutEngine runtime](https://github.com/illusd/peanutengine/blob/main/MOD/java/PeanutEnginePlugin.java.gz.b64.a): `MOD/java/PeanutEnginePlugin.java.gz.b64.a`
- [Commands](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`

### Economy

- [Economy](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Balance and pay](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Item selling](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Backpack](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`

### Travel and homes

- [Player teleport](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Random teleport](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Homes](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Bed return](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`

### World features

- [Land claims](https://github.com/illusd/peanutengine/tree/main/MOD/java): `MOD/java`
- [Vein mining](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP): `MOD/bedrock/PeanutEngine_BP`
- [Tree felling](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP): `MOD/bedrock/PeanutEngine_BP`
- [Door sync](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP): `MOD/bedrock/PeanutEngine_BP`
- [Offhand vision](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP): `MOD/bedrock/PeanutEngine_BP`
- [Skip night](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP): `MOD/bedrock/PeanutEngine_BP`
- [Bed location](https://github.com/illusd/peanutengine/tree/main/MOD/bedrock/PeanutEngine_BP): `MOD/bedrock/PeanutEngine_BP`

### Other components

- **Player**

## Connections

- Player → Commands: uses (evidence: `README.md`)
- Commands → PeanutEngine runtime: invokes
- PeanutEngine runtime → Economy: provides (evidence: `README.md`)
- PeanutEngine runtime → Player teleport: provides (evidence: `README.md`)
- PeanutEngine runtime → Random teleport: provides (evidence: `README.md`)
- PeanutEngine runtime → Homes: provides (evidence: `README.md`)
- PeanutEngine runtime → Bed return: provides (evidence: `README.md`)
- PeanutEngine runtime → Land claims: provides (evidence: `README.md`)
- PeanutEngine runtime → Vein mining: provides (evidence: `README.md`)
- PeanutEngine runtime → Tree felling: provides (evidence: `README.md`)
- PeanutEngine runtime → Door sync: provides (evidence: `README.md`)
- PeanutEngine runtime → Offhand vision: provides (evidence: `README.md`)
- PeanutEngine runtime → Skip night: provides (evidence: `README.md`)
- PeanutEngine runtime → Bed location: provides (evidence: `README.md`)
- Economy → Balance and pay: includes (evidence: `README.md`)
- Economy → Item selling: includes (evidence: `README.md`)
- Economy → Backpack: includes (evidence: `README.md`)
