# imyvmcircle/imyvmvillagershop architecture

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

- Interactive diagram: https://gitdiagram.com/imyvmcircle/imyvmvillagershop
- Repository: https://github.com/imyvmcircle/imyvmvillagershop

## Overview

Imyvm Villager Shop is a Fabric mod for player- and administrator-owned villager shops. Players create shops through commands or a guided GUI, populate them from inventories and containers, then manage stock or trade through shop interfaces; administrators also search and administer shops. Source excerpts show the main lifecycle wiring, persistence, item handling and GUI/command entry points. Several README-described admin and management behaviors are included, but their detailed implementation paths are not fully evidenced in the excerpts.

Main entry points: [`src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt) (Mod lifecycle), [`src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt`](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt) (Shop entity), [`src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt`](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt) (Commands), [`src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt`](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt) (Manage shop GUI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Mod entry and commands"]
  node_main["Mod lifecycle"]
  node_commands["Commands<br/>[CommandRegistry.kt]"]
  node_config_command["Config commands<br/>[ConfigChange.kt]"]
end

subgraph group_shop_ui["Shop interfaces"]
  node_create_gui["Create shop GUI<br/>[ShopCreateGui.kt]"]
  node_manage_gui["Manage shop GUI<br/>[ShopManageGui.kt]"]
  node_trade_gui["Trade GUI<br/>[ShopTradeGui.kt]"]
  node_confirm_gui["Confirmation GUI"]
  node_gui_helpers["GUI helpers<br/>[GuiHelpers.kt]"]
end

subgraph group_domain["Shop domain"]
  node_shop_entity["Shop entity<br/>[ShopEntity.kt]"]
  node_shop_spawn["Villager spawning<br/>[spawnVillager.kt]"]
  node_items["Item and stock handling<br/>[ItemManager.kt]"]
end

subgraph group_services["Services and persistence"]
  node_shop_service["Shop persistence and search<br/>[ShopService.kt]"]
  node_db_settings["Database connection<br/>[DbSettings.kt]"]
  node_config["Mod configuration<br/>[ModConfig.kt]"]
  node_translator["Translations<br/>[Translator.kt]"]
  node_economy["Economy adapter<br/>[EconomyData.kt]"]
  node_database[("Configured database")]
end

subgraph group_game["Minecraft integration"]
  node_player_connect["Player connect event"]
  node_player_mixin["Connection hook"]
  node_merchant_mixin["Merchant screen hook"]
end

node_player(("Player"))
node_game_server(("Minecraft server"))
node_economy_mod["Economy mod"]

node_player -->|"runs commands"| node_commands
node_player -->|"creates shop"| node_create_gui
node_player -->|"manages shop"| node_manage_gui
node_player -->|"trades at"| node_trade_gui
node_main -->|"registers"| node_commands
node_main -->|"initializes"| node_shop_service
node_main -->|"opens for owner"| node_manage_gui
node_main -->|"opens for customer"| node_trade_gui
node_main -->|"registers listener"| node_player_connect
node_commands -->|"opens"| node_create_gui
node_commands -->|"opens"| node_manage_gui
node_commands -->|"uses pending confirmation"| node_confirm_gui
node_commands -->|"creates and administers"| node_shop_entity
node_config_command -->|"changes options"| node_config
node_create_gui -->|"submits shop"| node_shop_entity
node_create_gui -->|"builds stock entries"| node_items
node_manage_gui -->|"updates shop"| node_shop_entity
node_manage_gui -->|"adds and removes stock"| node_items
node_trade_gui -->|"trades against"| node_shop_entity
node_trade_gui -->|"uses item data"| node_items
node_shop_entity -->|"persists changes"| node_shop_service
node_shop_entity -->|"holds shop items"| node_items
node_shop_entity -->|"checks shop fees"| node_economy
node_shop_service -->|"serializes item lists"| node_items
node_shop_service -->|"queries and updates"| node_database
node_db_settings -->|"connects"| node_database
node_main -->|"selects database"| node_db_settings
node_main -->|"loads configuration"| node_config
node_main -.->|"loads shop entities"| node_shop_spawn
node_shop_entity -.->|"spawns villager"| node_shop_spawn
node_translator -->|"reads language option"| node_config
node_main -->|"uses translations"| node_translator
node_player_mixin -->|"fires callback"| node_player_connect
node_merchant_mixin -->|"translates merchant labels"| node_translator
node_player_connect -.->|"triggers listener"| node_main
node_main -->|"credits income"| node_economy
node_economy -->|"uses player data"| node_economy_mod
node_main -->|"registers lifecycle hooks"| node_game_server

click node_main "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt"
click node_commands "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt"
click node_config_command "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/commands/ConfigChange.kt"
click node_create_gui "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopCreateGui.kt"
click node_manage_gui "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt"
click node_trade_gui "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopTradeGui.kt"
click node_confirm_gui "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/PendingConfirmGui.kt"
click node_gui_helpers "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/GuiHelpers.kt"
click node_shop_entity "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt"
click node_shop_spawn "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/shops/spawnVillager.kt"
click node_items "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/items/ItemManager.kt"
click node_shop_service "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/ShopService.kt"
click node_db_settings "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/DbSettings.kt"
click node_config "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/ModConfig.kt"
click node_translator "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/Translator.kt"
click node_economy "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/EconomyData.kt"
click node_player_connect "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/java/com/imyvm/villagerShop/events/PlayerConnectCallback.java"
click node_player_mixin "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/java/com/imyvm/villagerShop/mixin/PlayerManagerMixin.java"
click node_merchant_mixin "https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/java/com/imyvm/villagerShop/mixin/VirtualMerchantScreenHandlerMixin.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_commands,node_config_command toneBlue
class node_create_gui,node_manage_gui,node_trade_gui,node_confirm_gui,node_gui_helpers toneAmber
class node_shop_entity,node_shop_spawn,node_items,node_game_server toneMint
class node_shop_service,node_db_settings,node_config,node_translator,node_economy,node_database toneRose
class node_player_connect,node_player_mixin,node_merchant_mixin,node_player,node_economy_mod toneIndigo
```

## Components

### Mod entry and commands

- [Mod lifecycle](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt): `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`
- [Commands](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt): `src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt`
- [Config commands](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/commands/ConfigChange.kt): `src/main/kotlin/com/imyvm/villagerShop/commands/ConfigChange.kt`

### Shop interfaces

- [Create shop GUI](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopCreateGui.kt): `src/main/kotlin/com/imyvm/villagerShop/gui/ShopCreateGui.kt`
- [Manage shop GUI](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt): `src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt`
- [Trade GUI](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/ShopTradeGui.kt): `src/main/kotlin/com/imyvm/villagerShop/gui/ShopTradeGui.kt`
- [Confirmation GUI](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/PendingConfirmGui.kt): `src/main/kotlin/com/imyvm/villagerShop/gui/PendingConfirmGui.kt`
- [GUI helpers](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/gui/GuiHelpers.kt): `src/main/kotlin/com/imyvm/villagerShop/gui/GuiHelpers.kt`

### Shop domain

- [Shop entity](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt): `src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt`
- [Villager spawning](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/shops/spawnVillager.kt): `src/main/kotlin/com/imyvm/villagerShop/shops/spawnVillager.kt`
- [Item and stock handling](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/items/ItemManager.kt): `src/main/kotlin/com/imyvm/villagerShop/items/ItemManager.kt`

### Services and persistence

- [Shop persistence and search](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/ShopService.kt): `src/main/kotlin/com/imyvm/villagerShop/apis/ShopService.kt`
- [Database connection](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/DbSettings.kt): `src/main/kotlin/com/imyvm/villagerShop/apis/DbSettings.kt`
- [Mod configuration](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/ModConfig.kt): `src/main/kotlin/com/imyvm/villagerShop/apis/ModConfig.kt`
- [Translations](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/Translator.kt): `src/main/kotlin/com/imyvm/villagerShop/apis/Translator.kt`
- [Economy adapter](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/kotlin/com/imyvm/villagerShop/apis/EconomyData.kt): `src/main/kotlin/com/imyvm/villagerShop/apis/EconomyData.kt`
- **Configured database**

### Minecraft integration

- [Player connect event](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/java/com/imyvm/villagerShop/events/PlayerConnectCallback.java): `src/main/java/com/imyvm/villagerShop/events/PlayerConnectCallback.java`
- [Connection hook](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/java/com/imyvm/villagerShop/mixin/PlayerManagerMixin.java): `src/main/java/com/imyvm/villagerShop/mixin/PlayerManagerMixin.java`
- [Merchant screen hook](https://github.com/imyvmcircle/imyvmvillagershop/blob/master/src/main/java/com/imyvm/villagerShop/mixin/VirtualMerchantScreenHandlerMixin.java): `src/main/java/com/imyvm/villagerShop/mixin/VirtualMerchantScreenHandlerMixin.java`

### Other components

- **Player**
- **Minecraft server**
- **Economy mod**

## Connections

- Player → Commands: runs commands (evidence: `README.MD`)
- Player → Create shop GUI: creates shop (evidence: `README.MD`)
- Player → Manage shop GUI: manages shop (evidence: `README.MD`)
- Player → Trade GUI: trades at (evidence: `README.MD`)
- Mod lifecycle → Commands: registers (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Shop persistence and search: initializes (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Manage shop GUI: opens for owner (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Trade GUI: opens for customer (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Player connect event: registers listener (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Commands → Create shop GUI: opens (evidence: `src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt`)
- Commands → Manage shop GUI: opens (evidence: `src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt`)
- Commands → Confirmation GUI: uses pending confirmation (evidence: `src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt`)
- Commands → Shop entity: creates and administers (evidence: `src/main/kotlin/com/imyvm/villagerShop/commands/CommandRegistry.kt`)
- Config commands → Mod configuration: changes options (evidence: `src/main/kotlin/com/imyvm/villagerShop/commands/ConfigChange.kt`)
- Create shop GUI → Shop entity: submits shop (evidence: `src/main/kotlin/com/imyvm/villagerShop/gui/ShopCreateGui.kt`)
- Create shop GUI → Item and stock handling: builds stock entries (evidence: `src/main/kotlin/com/imyvm/villagerShop/gui/ShopCreateGui.kt`)
- Manage shop GUI → Shop entity: updates shop (evidence: `src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt`)
- Manage shop GUI → Item and stock handling: adds and removes stock (evidence: `src/main/kotlin/com/imyvm/villagerShop/gui/ShopManageGui.kt`)
- Trade GUI → Shop entity: trades against (evidence: `src/main/kotlin/com/imyvm/villagerShop/gui/ShopTradeGui.kt`)
- Trade GUI → Item and stock handling: uses item data (evidence: `src/main/kotlin/com/imyvm/villagerShop/gui/ShopTradeGui.kt`)
- Shop entity → Shop persistence and search: persists changes (evidence: `src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt`)
- Shop entity → Item and stock handling: holds shop items (evidence: `src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt`)
- Shop entity → Economy adapter: checks shop fees (evidence: `src/main/kotlin/com/imyvm/villagerShop/shops/ShopEntity.kt`)
- Shop persistence and search → Item and stock handling: serializes item lists (evidence: `src/main/kotlin/com/imyvm/villagerShop/apis/ShopService.kt`)
- Shop persistence and search → Configured database: queries and updates (evidence: `src/main/kotlin/com/imyvm/villagerShop/apis/ShopService.kt`)
- Database connection → Configured database: connects (evidence: `src/main/kotlin/com/imyvm/villagerShop/apis/DbSettings.kt`)
- Mod lifecycle → Database connection: selects database (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Mod configuration: loads configuration (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Villager spawning: loads shop entities
- Shop entity → Villager spawning: spawns villager
- Translations → Mod configuration: reads language option (evidence: `src/main/kotlin/com/imyvm/villagerShop/apis/Translator.kt`)
- Mod lifecycle → Translations: uses translations (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Connection hook → Player connect event: fires callback (evidence: `src/main/java/com/imyvm/villagerShop/mixin/PlayerManagerMixin.java`)
- Merchant screen hook → Translations: translates merchant labels (evidence: `src/main/java/com/imyvm/villagerShop/mixin/VirtualMerchantScreenHandlerMixin.java`)
- Player connect event → Mod lifecycle: triggers listener (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Mod lifecycle → Economy adapter: credits income (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
- Economy adapter → Economy mod: uses player data (evidence: `src/main/kotlin/com/imyvm/villagerShop/apis/EconomyData.kt`)
- Mod lifecycle → Minecraft server: registers lifecycle hooks (evidence: `src/main/kotlin/com/imyvm/villagerShop/VillagerShopMain.kt`)
