# oguzcanyilmazlar/farmer-v6 architecture

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

- Interactive diagram: https://gitdiagram.com/oguzcanyilmazlar/farmer-v6
- Repository: https://github.com/oguzcanyilmazlar/farmer-v6

## Overview

Farmer is a Minecraft server plugin that creates region- or island-bound virtual collectors. Players buy or open a Farmer, manage users and settings, then collect, withdraw, or sell stocked items through its GUIs; configured modules add automatic harvesting, selling, production, and related features. The graph captures the documented workflow and sampled relationships. Some module and persistence details are unsampled, so uncertain links are omitted rather than inferred.

Main entry points: [`src/main/java/xyz/geik/farmer/Main.java`](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/Main.java) (Plugin startup), [`src/main/java/xyz/geik/farmer/guis/MainGui.java`](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/MainGui.java) (Storage GUI), [`src/main/java/xyz/geik/farmer/model/Farmer.java`](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/Farmer.java) (Farmer state), [`src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java`](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java) (Farmer manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Plugin lifecycle"]
  node_main["Plugin startup<br/>[Main.java]"]
  node_config["Configuration<br/>[ConfigFile.java]"]
  node_language["Language settings<br/>[LangFile.java]"]
end

subgraph group_domain["Farmer domain"]
  node_database[("SQL persistence<br/>[SQL.java]")]
  node_manager["Farmer manager<br/>[FarmerManager.java]"]
  node_farmer["Farmer state<br/>[Farmer.java]"]
  node_inventory["Stored inventory<br/>[FarmerInv.java]"]
  node_items["Stock item<br/>[FarmerItem.java]"]
  node_levels["Capacity levels<br/>[FarmerLevel.java]"]
  node_users["Farmer users<br/>[User.java]"]
  node_roles["User permissions<br/>[FarmerPerm.java]"]
end

subgraph group_interaction["Player interaction"]
  node_command["Farmer command<br/>[FarmerCommand.java]"]
  node_main_gui["Storage GUI<br/>[MainGui.java]"]
  node_manage_gui["Management GUI<br/>[ManageGui.java]"]
  node_users_gui["Users GUI<br/>[UsersGui.java]"]
  node_gui_helpers["GUI item helpers<br/>[GuiHelper.java]"]
  node_group_items["Stock display items<br/>[GroupItems.java]"]
end

subgraph group_capabilities["Collection modules"]
  node_autoharvest["Automatic harvesting<br/>[AutoHarvest.java]"]
  node_autoseller["Automatic selling<br/>[AutoSeller.java]"]
  node_production["Production tracking<br/>[Production.java]"]
  node_spawner["Spawner killer<br/>[SpawnerKiller.java]"]
  node_voucher["Vouchers<br/>[Voucher.java]"]
  node_geyser["Geyser support<br/>[Geyser.java]"]
end

subgraph group_platform["Platform integration"]
  node_integration["Region integrations<br/>[Integrations.java]"]
end

node_player(("Player"))
node_admin(("Administrator"))
node_region_service{{"Island and claim plugins"}}

node_player -->|"runs commands"| node_command
node_command -->|"manages Farmers"| node_manager
node_command -->|"opens storage"| node_main_gui
node_player -->|"uses storage"| node_main_gui
node_main_gui -->|"reads Farmer"| node_farmer
node_main_gui -->|"withdraws stock"| node_inventory
node_main_gui -->|"opens management"| node_manage_gui
node_main_gui -->|"builds controls"| node_gui_helpers
node_main_gui -->|"renders stock"| node_group_items
node_player -->|"manages settings"| node_manage_gui
node_manage_gui -.->|"manages users"| node_users_gui
node_admin -->|"administers Farmers"| node_manager
node_manager -->|"tracks Farmers"| node_farmer
node_manager -->|"persists changes"| node_database
node_farmer -->|"owns stock"| node_inventory
node_farmer -->|"tracks users"| node_users
node_farmer -->|"uses level"| node_levels
node_users -->|"holds role"| node_roles
node_inventory -->|"stores items"| node_items
node_inventory -->|"uses capacity"| node_levels
node_main -->|"loads settings"| node_config
node_main -->|"loads language"| node_language
node_main -->|"loads Farmers"| node_database
node_main -->|"registers integrations"| node_integration
node_integration -->|"registers providers"| node_region_service
node_region_service -.->|"provides region data"| node_integration
node_main -->|"registers module"| node_autoharvest
node_farmer -->|"exposes harvest state"| node_autoharvest
node_main -.->|"registers module"| node_autoseller
node_main -.->|"registers module"| node_production
node_main -.->|"registers module"| node_spawner
node_main -.->|"registers module"| node_voucher
node_main -.->|"registers module"| node_geyser

click node_main "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/Main.java"
click node_config "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/configuration/ConfigFile.java"
click node_language "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/configuration/LangFile.java"
click node_database "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/database/SQL.java"
click node_manager "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java"
click node_farmer "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/Farmer.java"
click node_inventory "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/inventory/FarmerInv.java"
click node_items "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/inventory/FarmerItem.java"
click node_levels "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/FarmerLevel.java"
click node_users "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/user/User.java"
click node_roles "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/user/FarmerPerm.java"
click node_command "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/commands/FarmerCommand.java"
click node_main_gui "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/MainGui.java"
click node_manage_gui "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/ManageGui.java"
click node_users_gui "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/UsersGui.java"
click node_gui_helpers "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/helpers/gui/GuiHelper.java"
click node_group_items "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/helpers/gui/GroupItems.java"
click node_autoharvest "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/autoharvest/AutoHarvest.java"
click node_autoseller "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/autoseller/AutoSeller.java"
click node_production "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/production/Production.java"
click node_spawner "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/spawnerkiller/SpawnerKiller.java"
click node_voucher "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/voucher/Voucher.java"
click node_geyser "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/geyser/Geyser.java"
click node_integration "https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/integrations/Integrations.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_main,node_config,node_language toneBlue
class node_database,node_manager,node_farmer,node_inventory,node_items,node_levels,node_users,node_roles toneAmber
class node_command,node_main_gui,node_manage_gui,node_users_gui,node_gui_helpers,node_group_items toneMint
class node_autoharvest,node_autoseller,node_production,node_spawner,node_voucher,node_geyser toneRose
class node_integration,node_player,node_admin,node_region_service toneIndigo
```

## Components

### Plugin lifecycle

- [Plugin startup](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/Main.java): `src/main/java/xyz/geik/farmer/Main.java`
- [Configuration](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/configuration/ConfigFile.java): `src/main/java/xyz/geik/farmer/configuration/ConfigFile.java`
- [Language settings](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/configuration/LangFile.java): `src/main/java/xyz/geik/farmer/configuration/LangFile.java`

### Farmer domain

- [SQL persistence](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/database/SQL.java): `src/main/java/xyz/geik/farmer/database/SQL.java`
- [Farmer manager](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java): `src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java`
- [Farmer state](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/Farmer.java): `src/main/java/xyz/geik/farmer/model/Farmer.java`
- [Stored inventory](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/inventory/FarmerInv.java): `src/main/java/xyz/geik/farmer/model/inventory/FarmerInv.java`
- [Stock item](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/inventory/FarmerItem.java): `src/main/java/xyz/geik/farmer/model/inventory/FarmerItem.java`
- [Capacity levels](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/FarmerLevel.java): `src/main/java/xyz/geik/farmer/model/FarmerLevel.java`
- [Farmer users](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/user/User.java): `src/main/java/xyz/geik/farmer/model/user/User.java`
- [User permissions](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/model/user/FarmerPerm.java): `src/main/java/xyz/geik/farmer/model/user/FarmerPerm.java`

### Player interaction

- [Farmer command](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/commands/FarmerCommand.java): `src/main/java/xyz/geik/farmer/commands/FarmerCommand.java`
- [Storage GUI](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/MainGui.java): `src/main/java/xyz/geik/farmer/guis/MainGui.java`
- [Management GUI](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/ManageGui.java): `src/main/java/xyz/geik/farmer/guis/ManageGui.java`
- [Users GUI](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/guis/UsersGui.java): `src/main/java/xyz/geik/farmer/guis/UsersGui.java`
- [GUI item helpers](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/helpers/gui/GuiHelper.java): `src/main/java/xyz/geik/farmer/helpers/gui/GuiHelper.java`
- [Stock display items](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/helpers/gui/GroupItems.java): `src/main/java/xyz/geik/farmer/helpers/gui/GroupItems.java`

### Collection modules

- [Automatic harvesting](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/autoharvest/AutoHarvest.java): `src/main/java/xyz/geik/farmer/modules/autoharvest/AutoHarvest.java`
- [Automatic selling](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/autoseller/AutoSeller.java): `src/main/java/xyz/geik/farmer/modules/autoseller/AutoSeller.java`
- [Production tracking](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/production/Production.java): `src/main/java/xyz/geik/farmer/modules/production/Production.java`
- [Spawner killer](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/spawnerkiller/SpawnerKiller.java): `src/main/java/xyz/geik/farmer/modules/spawnerkiller/SpawnerKiller.java`
- [Vouchers](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/voucher/Voucher.java): `src/main/java/xyz/geik/farmer/modules/voucher/Voucher.java`
- [Geyser support](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/modules/geyser/Geyser.java): `src/main/java/xyz/geik/farmer/modules/geyser/Geyser.java`

### Platform integration

- [Region integrations](https://github.com/oguzcanyilmazlar/farmer-v6/blob/main/src/main/java/xyz/geik/farmer/integrations/Integrations.java): `src/main/java/xyz/geik/farmer/integrations/Integrations.java`

### Other components

- **Player**
- **Administrator**
- **Island and claim plugins**

## Connections

- Player → Farmer command: runs commands
- Farmer command → Farmer manager: manages Farmers (evidence: `src/main/java/xyz/geik/farmer/commands/FarmerCommand.java`)
- Farmer command → Storage GUI: opens storage (evidence: `src/main/java/xyz/geik/farmer/commands/FarmerCommand.java`)
- Player → Storage GUI: uses storage
- Storage GUI → Farmer state: reads Farmer (evidence: `src/main/java/xyz/geik/farmer/guis/MainGui.java`)
- Storage GUI → Stored inventory: withdraws stock (evidence: `src/main/java/xyz/geik/farmer/guis/MainGui.java`)
- Storage GUI → Management GUI: opens management (evidence: `src/main/java/xyz/geik/farmer/guis/MainGui.java`)
- Storage GUI → GUI item helpers: builds controls (evidence: `src/main/java/xyz/geik/farmer/guis/MainGui.java`)
- Storage GUI → Stock display items: renders stock (evidence: `src/main/java/xyz/geik/farmer/guis/MainGui.java`)
- Player → Management GUI: manages settings
- Management GUI → Users GUI: manages users (evidence: `src/main/java/xyz/geik/farmer/guis/ManageGui.java`)
- Administrator → Farmer manager: administers Farmers
- Farmer manager → Farmer state: tracks Farmers (evidence: `src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java`)
- Farmer manager → SQL persistence: persists changes (evidence: `src/main/java/xyz/geik/farmer/api/managers/FarmerManager.java`)
- Farmer state → Stored inventory: owns stock (evidence: `src/main/java/xyz/geik/farmer/model/Farmer.java`)
- Farmer state → Farmer users: tracks users (evidence: `src/main/java/xyz/geik/farmer/model/Farmer.java`)
- Farmer state → Capacity levels: uses level (evidence: `src/main/java/xyz/geik/farmer/model/Farmer.java`)
- Farmer users → User permissions: holds role (evidence: `src/main/java/xyz/geik/farmer/model/user/User.java`)
- Stored inventory → Stock item: stores items (evidence: `src/main/java/xyz/geik/farmer/model/inventory/FarmerInv.java`)
- Stored inventory → Capacity levels: uses capacity (evidence: `src/main/java/xyz/geik/farmer/model/inventory/FarmerInv.java`)
- Plugin startup → Configuration: loads settings (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → Language settings: loads language (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → SQL persistence: loads Farmers (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → Region integrations: registers integrations (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Region integrations → Island and claim plugins: registers providers (evidence: `src/main/java/xyz/geik/farmer/integrations/Integrations.java`)
- Island and claim plugins → Region integrations: provides region data
- Plugin startup → Automatic harvesting: registers module (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Farmer state → Automatic harvesting: exposes harvest state (evidence: `src/main/java/xyz/geik/farmer/model/Farmer.java`)
- Plugin startup → Automatic selling: registers module (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → Production tracking: registers module (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → Spawner killer: registers module (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → Vouchers: registers module (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
- Plugin startup → Geyser support: registers module (evidence: `src/main/java/xyz/geik/farmer/Main.java`)
