# kris-dreemurr-dev/mosssafes architecture

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

- Interactive diagram: https://gitdiagram.com/kris-dreemurr-dev/mosssafes
- Repository: https://github.com/kris-dreemurr-dev/mosssafes

## Overview

MossSafes is a Spigot/Paper plugin for password-protected chest safes. Players create safes with a command and chat input, then authenticate by interacting and entering a password; successful access authorizes them, while incorrect passwords trigger an electric shock. The README also documents double-chest expansion and persistence of safe details. Source excerpts do not include runtime classes, so implementation-level connections are shown as unverified rather than asserted.

Main entry points: [`src/main/java/org/example/mosscrafts/mossSafes/MossSafes.java`](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/MossSafes.java) (Plugin Entrypoint), [`src/main/java/org/example/mosscrafts/mossSafes/listeners/InteractListener.java`](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/listeners/InteractListener.java) (Interaction Events), [`src/main/java/org/example/mosscrafts/mossSafes/managers/SafeManager.java`](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/managers/SafeManager.java) (Safe Manager), [`src/main/java/org/example/mosscrafts/mossSafes/commands/SafeCommand.java`](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/commands/SafeCommand.java) (Safe Command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin Runtime"]
  node_plugin["Plugin Entrypoint<br/>[MossSafes.java]"]
  node_manifest["Plugin Manifest<br/>[plugin.yml]"]
end

subgraph group_safe["Safe Lifecycle"]
  node_command["Safe Command<br/>[SafeCommand.java]"]
  node_blocks["Block Events<br/>[BlockListener.java]"]
  node_manager["Safe Manager<br/>[SafeManager.java]"]
end

subgraph group_access["Access Control"]
  node_interact["Interaction Events"]
end

subgraph group_storage["Safe Storage"]
  node_store[("Safe Records<br/>[safes.yml]")]
end

node_player(("Player"))
node_server["Minecraft Server"]

node_player -->|"creates safe"| node_command
node_player -->|"requests access"| node_interact
node_player -->|"enters password"| node_interact
node_interact -->|"grants or shocks"| node_player
node_blocks -.->|"expands safe"| node_manager
node_command -.->|"registers safe"| node_manager
node_interact -.->|"checks authorization"| node_manager
node_manager -.->|"persists records"| node_store
node_server -.->|"loads plugin"| node_plugin
node_plugin -.->|"registers command"| node_command
node_plugin -.->|"registers listener"| node_blocks
node_plugin -.->|"registers listener"| node_interact
node_manifest -.->|"declares plugin"| node_plugin

click node_plugin "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/MossSafes.java"
click node_manifest "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/resources/plugin.yml"
click node_command "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/commands/SafeCommand.java"
click node_blocks "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/listeners/BlockListener.java"
click node_interact "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/listeners/InteractListener.java"
click node_manager "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/managers/SafeManager.java"
click node_store "https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/resources/safes.yml"

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_manifest toneBlue
class node_command,node_blocks,node_manager toneAmber
class node_interact,node_server toneMint
class node_store toneRose
class node_player toneIndigo
```

## Components

### Plugin Runtime

- [Plugin Entrypoint](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/MossSafes.java): `src/main/java/org/example/mosscrafts/mossSafes/MossSafes.java`
- [Plugin Manifest](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/resources/plugin.yml): `src/main/resources/plugin.yml`

### Safe Lifecycle

- [Safe Command](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/commands/SafeCommand.java): `src/main/java/org/example/mosscrafts/mossSafes/commands/SafeCommand.java`
- [Block Events](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/listeners/BlockListener.java): `src/main/java/org/example/mosscrafts/mossSafes/listeners/BlockListener.java`
- [Safe Manager](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/managers/SafeManager.java): `src/main/java/org/example/mosscrafts/mossSafes/managers/SafeManager.java`

### Access Control

- [Interaction Events](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/java/org/example/mosscrafts/mossSafes/listeners/InteractListener.java): `src/main/java/org/example/mosscrafts/mossSafes/listeners/InteractListener.java`

### Safe Storage

- [Safe Records](https://github.com/kris-dreemurr-dev/mosssafes/blob/master/src/main/resources/safes.yml): `src/main/resources/safes.yml`

### Other components

- **Player**
- **Minecraft Server**

## Connections

- Player → Safe Command: creates safe (evidence: `README.md`)
- Player → Interaction Events: requests access (evidence: `README.md`)
- Player → Interaction Events: enters password (evidence: `README.md`)
- Interaction Events → Player: grants or shocks (evidence: `README.md`)
- Block Events → Safe Manager: expands safe
- Safe Command → Safe Manager: registers safe
- Interaction Events → Safe Manager: checks authorization
- Safe Manager → Safe Records: persists records
- Minecraft Server → Plugin Entrypoint: loads plugin
- Plugin Entrypoint → Safe Command: registers command
- Plugin Entrypoint → Block Events: registers listener
- Plugin Entrypoint → Interaction Events: registers listener
- Plugin Manifest → Plugin Entrypoint: declares plugin
