# kema99/hytale_better_store_public_for_hytale_team architecture

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

## Overview

This is a Hytale server-plugin template whose visible product code centers on mission menus and NPC merchants. The likely user journey is a player opening a mission interface, browsing mission information and pagination, then triggering mission actions; merchant NPCs form a separate gameplay branch. The supplied excerpts contain only build tooling, and the README is empty, so runtime links below are dashed and unverified rather than asserted as inspected calls.

Main entry points: [`hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI`](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI) (Mission Pages), [`hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Main.java`](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Main.java) (Plugin Entry), [`hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Spawns/MerchantKlopsSpawner.java`](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Spawns/MerchantKlopsSpawner.java) (Klops Spawner), [`hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Spawns/MerchantsSpawner.java`](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Spawns/MerchantsSpawner.java) (Temple Spawner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Plugin Lifecycle"]
  node_plugin["Plugin Entry<br/>[Main.java]"]
end

subgraph group_missions["Mission Gameplay"]
  node_missiondata["Mission Models"]
  node_missionconfig["Mission Definitions<br/>[Missions.json]"]
  node_missionbuild["Mission Builder"]
  node_missionaction["Mission Actions"]
end

subgraph group_interface["Player Interface"]
  node_command["Open UI Command<br/>[OpenUICommand.java]"]
  node_missionpages["Mission Pages"]
  node_pagination["Pagination"]
  node_missionui["Mission UI Assets"]
end

subgraph group_npcs["NPC Merchants"]
  node_merchantdata["Merchant Spawn Data"]
  node_klopsbuild["Klops Builder"]
  node_klopsspawn["Klops Spawner"]
  node_klopswatch["Klops Watchers"]
  node_templebuild["Temple Builder"]
  node_templespawn["Temple Spawner"]
  node_templewatch["Temple Watcher"]
  node_shopdata["Barter Shop Data"]
  node_npcdata["NPC Roles"]
end

node_server(("Hytale Server"))
node_player(("Player"))

node_server -.->|"loads"| node_plugin
node_player -.->|"invokes"| node_command
node_command -.->|"opens"| node_missionpages
node_missionpages -.->|"presents"| node_missiondata
node_missionpages -.->|"uses"| node_pagination
node_missionpages -.->|"renders with"| node_missionui
node_missionbuild -.->|"loads"| node_missionconfig
node_missionaction -.->|"opens"| node_missionpages
node_plugin -.->|"registers"| node_missionbuild
node_plugin -.->|"registers"| node_klopsspawn
node_plugin -.->|"registers"| node_templespawn
node_klopsspawn -.->|"uses"| node_klopsbuild
node_klopsbuild -.->|"uses"| node_merchantdata
node_klopsspawn -.->|"monitors"| node_klopswatch
node_templespawn -.->|"uses"| node_templebuild
node_templespawn -.->|"monitors"| node_templewatch
node_npcdata -.->|"configures"| node_shopdata

click node_plugin "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Main.java"
click node_missiondata "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Models/Missions"
click node_missionconfig "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/resources/Server/Missions/Missions.json"
click node_missionbuild "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Missions/Builders/MissionsBuilder.java"
click node_missionaction "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Missions/Actions/ActionOpenMissionMenu.java"
click node_merchantdata "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Models/GenericModels/MerchantSpawnData.java"
click node_klopsbuild "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Builders/MerchantKlopsBuilder.java"
click node_klopsspawn "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Spawns/MerchantKlopsSpawner.java"
click node_klopswatch "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Watchers"
click node_templebuild "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Builders/MerchantsBuilder.java"
click node_templespawn "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Spawns/MerchantsSpawner.java"
click node_templewatch "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Watchers/ForgottenTempleWatcher.java"
click node_command "https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Commands/OpenUICommand.java"
click node_missionpages "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI"
click node_pagination "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI/MissionsFuncionality/Pagination"
click node_missionui "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/resources/Common/UI/Custom/BetterStoreTrigger"
click node_shopdata "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/resources/Server/BarterShops"
click node_npcdata "https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/resources/Server/NPC/Roles"

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 toneBlue
class node_missiondata,node_missionconfig,node_missionbuild,node_missionaction toneAmber
class node_command,node_missionpages,node_pagination,node_missionui,node_server toneMint
class node_merchantdata,node_klopsbuild,node_klopsspawn,node_klopswatch,node_templebuild,node_templespawn,node_templewatch,node_shopdata,node_npcdata toneRose
class node_player toneIndigo
```

## Components

### Plugin Lifecycle

- [Plugin Entry](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Main.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Main.java`

### Mission Gameplay

- [Mission Models](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Models/Missions): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Models/Missions`
- [Mission Definitions](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/resources/Server/Missions/Missions.json): `hytale-template-plugin/src/main/resources/Server/Missions/Missions.json`
- [Mission Builder](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Missions/Builders/MissionsBuilder.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Missions/Builders/MissionsBuilder.java`
- [Mission Actions](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Missions/Actions/ActionOpenMissionMenu.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Missions/Actions/ActionOpenMissionMenu.java`

### Player Interface

- [Open UI Command](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Commands/OpenUICommand.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Commands/OpenUICommand.java`
- [Mission Pages](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI`
- [Pagination](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI/MissionsFuncionality/Pagination): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/UI/MissionsFuncionality/Pagination`
- [Mission UI Assets](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/resources/Common/UI/Custom/BetterStoreTrigger): `hytale-template-plugin/src/main/resources/Common/UI/Custom/BetterStoreTrigger`

### NPC Merchants

- [Merchant Spawn Data](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Models/GenericModels/MerchantSpawnData.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Models/GenericModels/MerchantSpawnData.java`
- [Klops Builder](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Builders/MerchantKlopsBuilder.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Builders/MerchantKlopsBuilder.java`
- [Klops Spawner](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Spawns/MerchantKlopsSpawner.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Spawns/MerchantKlopsSpawner.java`
- [Klops Watchers](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Watchers): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/Klops/Watchers`
- [Temple Builder](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Builders/MerchantsBuilder.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Builders/MerchantsBuilder.java`
- [Temple Spawner](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Spawns/MerchantsSpawner.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Spawns/MerchantsSpawner.java`
- [Temple Watcher](https://github.com/kema99/hytale_better_store_public_for_hytale_team/blob/main/hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Watchers/ForgottenTempleWatcher.java): `hytale-template-plugin/src/main/java/com/example/TemplatePlugin/TempleEntities/Watchers/ForgottenTempleWatcher.java`
- [Barter Shop Data](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/resources/Server/BarterShops): `hytale-template-plugin/src/main/resources/Server/BarterShops`
- [NPC Roles](https://github.com/kema99/hytale_better_store_public_for_hytale_team/tree/main/hytale-template-plugin/src/main/resources/Server/NPC/Roles): `hytale-template-plugin/src/main/resources/Server/NPC/Roles`

### Other components

- **Hytale Server**
- **Player**

## Connections

- Hytale Server → Plugin Entry: loads
- Player → Open UI Command: invokes
- Open UI Command → Mission Pages: opens
- Mission Pages → Mission Models: presents
- Mission Pages → Pagination: uses
- Mission Pages → Mission UI Assets: renders with
- Mission Builder → Mission Definitions: loads
- Mission Actions → Mission Pages: opens
- Plugin Entry → Mission Builder: registers
- Plugin Entry → Klops Spawner: registers
- Plugin Entry → Temple Spawner: registers
- Klops Spawner → Klops Builder: uses
- Klops Builder → Merchant Spawn Data: uses
- Klops Spawner → Klops Watchers: monitors
- Temple Spawner → Temple Builder: uses
- Temple Spawner → Temple Watcher: monitors
- NPC Roles → Barter Shop Data: configures
