# thealejo160/terogenshin architecture

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

- Interactive diagram: https://gitdiagram.com/thealejo160/terogenshin
- Repository: https://github.com/thealejo160/terogenshin

## Overview

TeroGenshin is a Minecraft server plugin that adds Genshin-inspired elemental combat, reactions, equipment bonuses, regions, and mob shields. Players or server events initiate effects through commands and listeners; elemental state is applied to targets, reactions and damage are resolved, and visual feedback is shown. The graph includes major capabilities visible in the source tree. Edges are limited to startup registrations and dependencies named in the SOURCE INDEX or shown in excerpts; unsampled subsystem wiring is not assumed.

Main entry points: [`src/main/java/Temple/teroGenshin/TeroGenshin.java`](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/TeroGenshin.java) (Plugin bootstrap), [`src/main/java/Temple/teroGenshin/Managers/ElementsManager.java`](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ElementsManager.java) (Element application), [`src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java`](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java) (Reaction resolution), [`src/main/java/Temple/teroGenshin/Elements/ElementType.java`](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Elements/ElementType.java) (Element types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin runtime"]
  node_plugin["Plugin bootstrap<br/>[TeroGenshin.java]"]
  node_commands["Commands"]
  node_listeners["Event listeners"]
end

subgraph group_combat["Elemental combat"]
  node_elements["Element types<br/>[ElementType.java]"]
  node_elementstate["Element application"]
  node_reactions["Reaction resolution"]
  node_reactiontypes["Reaction types<br/>[ReactionType.java]"]
  node_damage["Damage calculation"]
  node_bloom["Bloom effects<br/>[Florecimiento.java]"]
  node_holograms["Combat holograms<br/>[HologramUtil.java]"]
  node_state["Target state<br/>[EntityState.java]"]
end

subgraph group_equipment["Equipment systems"]
  node_items["Elemental item registry<br/>[ItemManager.java]"]
  node_inventory["Inventory bonuses"]
  node_armor["Armor effects"]
  node_artifacts["Artifact effects"]
end

subgraph group_integrations["Mob integrations"]
  node_mythic["Mythic mob rules"]
  node_shields["Mob shields"]
  node_placeholders["Placeholder expansion"]
end

subgraph group_world["World features"]
  node_regions["Region restrictions"]
  node_ambient["Ambient elements"]
end

node_player(("Player / server event"))

node_plugin -->|"registers"| node_commands
node_plugin -->|"registers"| node_listeners
node_plugin -->|"initializes"| node_items
node_plugin -->|"initializes"| node_elementstate
node_plugin -->|"initializes"| node_reactions
node_plugin -->|"initializes"| node_damage
node_player -.->|"invokes"| node_commands
node_player -.->|"triggers"| node_listeners
node_listeners -->|"applies elements"| node_elementstate
node_elementstate -->|"uses types"| node_elements
node_elementstate -->|"applies bonuses"| node_inventory
node_elementstate -->|"stores state"| node_state
node_reactions -->|"selects reaction"| node_reactiontypes
node_reactions -->|"uses damage"| node_damage
node_reactions -->|"dispatches bloom"| node_bloom
node_reactions -->|"shows reaction"| node_holograms
node_bloom -->|"evaluates damage"| node_damage
node_items -->|"maps elements"| node_elements
node_inventory -->|"uses types"| node_elements
node_inventory -->|"reads bonuses"| node_artifacts
node_mythic -->|"parses immunity"| node_elements
node_shields -->|"reads mob data"| node_mythic
node_shields -->|"configures shield"| node_elements
node_placeholders -->|"looks up items"| node_items
node_placeholders -->|"reads bonuses"| node_inventory
node_elementstate -->|"checks restrictions"| node_regions
node_ambient -.->|"applies ambient state"| node_elementstate
node_plugin -.->|"initializes"| node_shields
node_plugin -->|"initializes"| node_mythic
node_plugin -.->|"initializes"| node_placeholders
node_plugin -.->|"registers features"| node_regions
node_listeners -.->|"applies effects"| node_armor

click node_plugin "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/TeroGenshin.java"
click node_commands "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Commands/GenshinCommand.java"
click node_listeners "https://github.com/thealejo160/terogenshin/tree/master/src/main/java/Temple/teroGenshin/Listeners"
click node_elements "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Elements/ElementType.java"
click node_elementstate "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ElementsManager.java"
click node_reactions "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java"
click node_reactiontypes "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Reactions/ReactionType.java"
click node_damage "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/DamageManagers.java"
click node_bloom "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Reactions/DendroReactions/Florecimiento/Florecimiento.java"
click node_holograms "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/HologramUtil.java"
click node_items "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ItemManager.java"
click node_inventory "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/Inventory/InventorySlots.java"
click node_armor "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/Armor/ArmorFunctions.java"
click node_artifacts "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/Artifact/ArtifactFunctions.java"
click node_mythic "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/MythicMobsManager.java"
click node_shields "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/shields/ShieldsManager.java"
click node_placeholders "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/PlaceHoldersManager.java"
click node_regions "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Regions/RegionRestrictions.java"
click node_ambient "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Listeners/AmbientElementsListener.java"
click node_state "https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/States/EntityState.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_plugin,node_commands,node_listeners toneBlue
class node_elements,node_elementstate,node_reactions,node_reactiontypes,node_damage,node_bloom,node_holograms,node_state toneAmber
class node_items,node_inventory,node_armor,node_artifacts,node_player toneMint
class node_mythic,node_shields,node_placeholders toneRose
class node_regions,node_ambient toneIndigo
```

## Components

### Plugin runtime

- [Plugin bootstrap](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/TeroGenshin.java): `src/main/java/Temple/teroGenshin/TeroGenshin.java`
- [Commands](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Commands/GenshinCommand.java): `src/main/java/Temple/teroGenshin/Commands/GenshinCommand.java`
- [Event listeners](https://github.com/thealejo160/terogenshin/tree/master/src/main/java/Temple/teroGenshin/Listeners): `src/main/java/Temple/teroGenshin/Listeners`

### Elemental combat

- [Element types](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Elements/ElementType.java): `src/main/java/Temple/teroGenshin/Elements/ElementType.java`
- [Element application](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ElementsManager.java): `src/main/java/Temple/teroGenshin/Managers/ElementsManager.java`
- [Reaction resolution](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java): `src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java`
- [Reaction types](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Reactions/ReactionType.java): `src/main/java/Temple/teroGenshin/Reactions/ReactionType.java`
- [Damage calculation](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/DamageManagers.java): `src/main/java/Temple/teroGenshin/Managers/DamageManagers.java`
- [Bloom effects](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Reactions/DendroReactions/Florecimiento/Florecimiento.java): `src/main/java/Temple/teroGenshin/Reactions/DendroReactions/Florecimiento/Florecimiento.java`
- [Combat holograms](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/HologramUtil.java): `src/main/java/Temple/teroGenshin/Functions/HologramUtil.java`
- [Target state](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/States/EntityState.java): `src/main/java/Temple/teroGenshin/States/EntityState.java`

### Equipment systems

- [Elemental item registry](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/ItemManager.java): `src/main/java/Temple/teroGenshin/Managers/ItemManager.java`
- [Inventory bonuses](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/Inventory/InventorySlots.java): `src/main/java/Temple/teroGenshin/Functions/Inventory/InventorySlots.java`
- [Armor effects](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/Armor/ArmorFunctions.java): `src/main/java/Temple/teroGenshin/Functions/Armor/ArmorFunctions.java`
- [Artifact effects](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Functions/Artifact/ArtifactFunctions.java): `src/main/java/Temple/teroGenshin/Functions/Artifact/ArtifactFunctions.java`

### Mob integrations

- [Mythic mob rules](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/MythicMobsManager.java): `src/main/java/Temple/teroGenshin/Managers/MythicMobsManager.java`
- [Mob shields](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/shields/ShieldsManager.java): `src/main/java/Temple/teroGenshin/shields/ShieldsManager.java`
- [Placeholder expansion](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Managers/PlaceHoldersManager.java): `src/main/java/Temple/teroGenshin/Managers/PlaceHoldersManager.java`

### World features

- [Region restrictions](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Regions/RegionRestrictions.java): `src/main/java/Temple/teroGenshin/Regions/RegionRestrictions.java`
- [Ambient elements](https://github.com/thealejo160/terogenshin/blob/master/src/main/java/Temple/teroGenshin/Listeners/AmbientElementsListener.java): `src/main/java/Temple/teroGenshin/Listeners/AmbientElementsListener.java`

### Other components

- **Player / server event**

## Connections

- Plugin bootstrap → Commands: registers (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Event listeners: registers (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Elemental item registry: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Element application: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Reaction resolution: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Damage calculation: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Player / server event → Commands: invokes
- Player / server event → Event listeners: triggers
- Event listeners → Element application: applies elements (evidence: `src/main/java/Temple/teroGenshin/Listeners/ProjectileElementListener.java`)
- Element application → Element types: uses types (evidence: `src/main/java/Temple/teroGenshin/Managers/ElementsManager.java`)
- Element application → Inventory bonuses: applies bonuses (evidence: `src/main/java/Temple/teroGenshin/Managers/ElementsManager.java`)
- Element application → Target state: stores state (evidence: `src/main/java/Temple/teroGenshin/Managers/ElementsManager.java`)
- Reaction resolution → Reaction types: selects reaction (evidence: `src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java`)
- Reaction resolution → Damage calculation: uses damage (evidence: `src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java`)
- Reaction resolution → Bloom effects: dispatches bloom (evidence: `src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java`)
- Reaction resolution → Combat holograms: shows reaction (evidence: `src/main/java/Temple/teroGenshin/Managers/ReactionsManager.java`)
- Bloom effects → Damage calculation: evaluates damage (evidence: `src/main/java/Temple/teroGenshin/Reactions/DendroReactions/Florecimiento/Florecimiento.java`)
- Elemental item registry → Element types: maps elements (evidence: `src/main/java/Temple/teroGenshin/Managers/ItemManager.java`)
- Inventory bonuses → Element types: uses types (evidence: `src/main/java/Temple/teroGenshin/Functions/Inventory/InventorySlots.java`)
- Inventory bonuses → Artifact effects: reads bonuses (evidence: `src/main/java/Temple/teroGenshin/Functions/Inventory/InventorySlots.java`)
- Mythic mob rules → Element types: parses immunity (evidence: `src/main/java/Temple/teroGenshin/Managers/MythicMobsManager.java`)
- Mob shields → Mythic mob rules: reads mob data (evidence: `src/main/java/Temple/teroGenshin/shields/ShieldsManager.java`)
- Mob shields → Element types: configures shield (evidence: `src/main/java/Temple/teroGenshin/shields/ShieldsManager.java`)
- Placeholder expansion → Elemental item registry: looks up items (evidence: `src/main/java/Temple/teroGenshin/Managers/PlaceHoldersManager.java`)
- Placeholder expansion → Inventory bonuses: reads bonuses (evidence: `src/main/java/Temple/teroGenshin/Managers/PlaceHoldersManager.java`)
- Element application → Region restrictions: checks restrictions (evidence: `src/main/java/Temple/teroGenshin/Managers/ElementsManager.java`)
- Ambient elements → Element application: applies ambient state
- Plugin bootstrap → Mob shields: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Mythic mob rules: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Placeholder expansion: initializes (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Plugin bootstrap → Region restrictions: registers features (evidence: `src/main/java/Temple/teroGenshin/TeroGenshin.java`)
- Event listeners → Armor effects: applies effects
