# okiner7/limitlessenchants architecture

> Architecture diagram of the GitHub repository okiner7/limitlessenchants, 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/okiner7/limitlessenchants
- Repository: https://github.com/okiner7/limitlessenchants

## Overview

LimitlessEnchants is a Paper/Purpur server plugin for configurable enchantment levels and anvil behavior. Players use `/le` to open the configuration menus or place items in an anvil; the plugin applies configured merging, cost, and effects. Commands also reload settings and switch English/Russian messages. The excerpts show the main runtime wiring and GUI-to-configuration updates; bStats is documented, but its runtime wiring is only visible in the plugin entry point. The graph omits finer anvil internals not fully shown in the excerpts.

Main entry points: [`src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`](https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java) (Plugin entry and commands), [`src/main/java/net/vinio/limitlessenchants/ConfigGUI.java`](https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/ConfigGUI.java) (Configuration menus), [`src/main/java/net/vinio/limitlessenchants/AnvilListener.java`](https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/AnvilListener.java) (Anvil merging and costs), [`src/main/resources/config.yml`](https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/config.yml) (YAML settings and messages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin runtime"]
  node_plugin["Plugin entry and commands"]
  node_pluginmeta["Plugin commands and permissions<br/>[plugin.yml]"]
  node_bstats["bStats metrics"]
end

subgraph group_anvil["Anvil mechanics"]
  node_anvil["Anvil merging and costs<br/>[AnvilListener.java]"]
end

subgraph group_configuration["Configuration"]
  node_gui["Configuration menus<br/>[ConfigGUI.java]"]
  node_yaml["YAML settings and messages<br/>[config.yml]"]
  node_locales["English and Russian messages<br/>[messages_en.yml]"]
end

node_player(("Player"))
node_server["Paper server"]

node_server -->|"enables"| node_plugin
node_plugin -->|"registers listener"| node_anvil
node_plugin -->|"registers listener"| node_gui
node_plugin -->|"initializes metrics"| node_bstats
node_plugin -->|"opens menu"| node_gui
node_plugin -->|"loads settings"| node_yaml
node_plugin -->|"loads messages"| node_locales
node_player -->|"runs command"| node_plugin
node_player -->|"uses anvil"| node_anvil
node_gui -->|"saves settings"| node_yaml
node_gui -->|"reloads settings"| node_plugin
node_anvil -->|"reads limits"| node_plugin
node_pluginmeta -.->|"declares command"| node_plugin

click node_plugin "https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java"
click node_gui "https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/ConfigGUI.java"
click node_anvil "https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/AnvilListener.java"
click node_yaml "https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/config.yml"
click node_locales "https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/messages_en.yml"
click node_pluginmeta "https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/plugin.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_pluginmeta,node_bstats toneBlue
class node_anvil toneAmber
class node_gui,node_yaml,node_locales,node_server toneMint
class node_player toneIndigo
```

## Components

### Plugin runtime

- [Plugin entry and commands](https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java): `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`
- [Plugin commands and permissions](https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/plugin.yml): `src/main/resources/plugin.yml`
- **bStats metrics**

### Anvil mechanics

- [Anvil merging and costs](https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/AnvilListener.java): `src/main/java/net/vinio/limitlessenchants/AnvilListener.java`

### Configuration

- [Configuration menus](https://github.com/okiner7/limitlessenchants/blob/main/src/main/java/net/vinio/limitlessenchants/ConfigGUI.java): `src/main/java/net/vinio/limitlessenchants/ConfigGUI.java`
- [YAML settings and messages](https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/config.yml): `src/main/resources/config.yml`
- [English and Russian messages](https://github.com/okiner7/limitlessenchants/blob/main/src/main/resources/messages_en.yml): `src/main/resources/messages_en.yml`

### Other components

- **Player**
- **Paper server**

## Connections

- Paper server → Plugin entry and commands: enables (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Plugin entry and commands → Anvil merging and costs: registers listener (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Plugin entry and commands → Configuration menus: registers listener (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Plugin entry and commands → bStats metrics: initializes metrics (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Plugin entry and commands → Configuration menus: opens menu (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Plugin entry and commands → YAML settings and messages: loads settings (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Plugin entry and commands → English and Russian messages: loads messages (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Player → Plugin entry and commands: runs command (evidence: `src/main/java/net/vinio/limitlessenchants/LimitlessEnchants.java`)
- Player → Anvil merging and costs: uses anvil (evidence: `src/main/java/net/vinio/limitlessenchants/AnvilListener.java`)
- Configuration menus → YAML settings and messages: saves settings (evidence: `src/main/java/net/vinio/limitlessenchants/ConfigGUI.java`)
- Configuration menus → Plugin entry and commands: reloads settings (evidence: `src/main/java/net/vinio/limitlessenchants/ConfigGUI.java`)
- Anvil merging and costs → Plugin entry and commands: reads limits (evidence: `src/main/java/net/vinio/limitlessenchants/AnvilListener.java`)
- Plugin commands and permissions → Plugin entry and commands: declares command
