# shadows-of-fire/apothic-spawners architecture

> Architecture diagram of the GitHub repository shadows-of-fire/apothic-spawners, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shadows-of-fire/apothic-spawners
- Repository: https://github.com/shadows-of-fire/apothic-spawners

## Overview

Apothic Spawners is a Minecraft mod for harvesting and customizing mob spawners. In the main workflow, a player uses modifier items on a spawner; the spawner block resolves a modifier recipe, which applies bounded stat changes to the spawner tile. The stat registry supplies vanilla and mod-specific behavior. Other documented capabilities include silk-touch pickup, Capturing enchantment spawn-egg drops, advancement criteria, and stat tooltips, with optional Jade/JEI integrations. Some subsystem links rely on README documentation or indexed references; unsampled event and integration wiring is not inferred.

Main entry points: [`src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java) (Mod Entry), [`src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java`](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java) (Modifier Recipe), [`src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java`](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java) (Spawner Stats), [`src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java`](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java) (Spawner Tile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Spawner Runtime"]
  node_spawner_block["Spawner Block"]
  node_spawner_item["Spawner Item"]
  node_spawner_tile["Spawner Tile"]
  node_lying_level["Spawn Level<br/>[LyingLevel.java]"]
end

subgraph group_modifiers["Modifiers and Stats"]
  node_recipe_provider["Modifier Recipes"]
  node_modifier["Modifier Recipe"]
  node_stat_modifier["Stat Change<br/>[StatModifier.java]"]
  node_stats_registry[("Spawner Stats<br/>[SpawnerStats.java]")]
  node_stat_types["Stat Types<br/>[CustomStat.java]"]
  node_stat_api["Stat API<br/>[SpawnerStat.java]"]
end

subgraph group_content["Content and Progression"]
  node_enchantment_data["Capturing Enchantment"]
  node_loot_data["Spawner Loot"]
  node_advancements["Modifier Criteria"]
end

subgraph group_integration["Client Integrations"]
  node_jade["Jade Tooltip"]
  node_jei["JEI Category"]
  node_recipe_cache[("Recipe Cache")]
end

subgraph group_platform["Mod Platform"]
  node_mod_entry["Mod Entry"]
  node_config["Configuration<br/>[ASConfig.java]"]
  node_objects["Registered Objects<br/>[ASObjects.java]"]
  node_events["Game Events<br/>[ASEvents.java]"]
  node_client["Client Setup<br/>[ASClient.java]"]
end

node_player(("Player"))

node_player -->|"uses items"| node_spawner_block
node_spawner_block -->|"finds modifier"| node_modifier
node_modifier -->|"applies changes"| node_spawner_tile
node_modifier -->|"applies stats"| node_stat_modifier
node_stat_modifier -->|"resolves stat"| node_stats_registry
node_stats_registry -->|"registers stats"| node_stat_api
node_stats_registry -->|"uses types"| node_stat_types
node_recipe_provider -->|"emits recipes"| node_modifier
node_spawner_block -->|"accesses tile"| node_spawner_tile
node_mod_entry -->|"bootstraps"| node_objects
node_mod_entry -->|"registers events"| node_events
node_mod_entry -->|"loads config"| node_config
node_mod_entry -->|"sets up data"| node_enchantment_data
node_mod_entry -->|"sets up data"| node_loot_data
node_mod_entry -->|"sets up data"| node_recipe_provider
node_spawner_tile -->|"stores stat values"| node_stats_registry
node_spawner_item -.->|"represents block"| node_spawner_block
node_events -->|"reads echo stat"| node_stats_registry
node_advancements -->|"checks state"| node_spawner_tile
node_advancements -->|"checks modifier"| node_modifier
node_client -->|"uses cache"| node_recipe_cache
node_jei -->|"reads recipes"| node_recipe_cache
node_jei -->|"displays recipes"| node_modifier
node_jade -->|"renders stats"| node_stats_registry
node_spawner_tile -.->|"uses spawn level"| node_lying_level

click node_mod_entry "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java"
click node_config "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASConfig.java"
click node_objects "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASObjects.java"
click node_events "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASEvents.java"
click node_client "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASClient.java"
click node_spawner_block "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerBlock.java"
click node_spawner_item "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerItem.java"
click node_spawner_tile "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java"
click node_lying_level "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/LyingLevel.java"
click node_recipe_provider "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/data/ASRecipeProvider.java"
click node_modifier "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java"
click node_stat_modifier "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/StatModifier.java"
click node_stats_registry "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java"
click node_stat_types "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/CustomStat.java"
click node_stat_api "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStat.java"
click node_enchantment_data "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/data/ASEnchantmentProvider.java"
click node_loot_data "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/data/ASLootProvider.java"
click node_advancements "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/advancements/ModifierTrigger.java"
click node_jade "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerClientProvider.java"
click node_jei "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerCategory.java"
click node_recipe_cache "https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerRecipeCache.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_spawner_block,node_spawner_item,node_spawner_tile,node_lying_level toneBlue
class node_recipe_provider,node_modifier,node_stat_modifier,node_stats_registry,node_stat_types,node_stat_api toneAmber
class node_enchantment_data,node_loot_data,node_advancements toneMint
class node_jade,node_jei,node_recipe_cache toneRose
class node_mod_entry,node_config,node_objects,node_events,node_client,node_player toneIndigo
```

## Components

### Spawner Runtime

- [Spawner Block](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerBlock.java): `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerBlock.java`
- [Spawner Item](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerItem.java): `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerItem.java`
- [Spawner Tile](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java): `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java`
- [Spawn Level](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/block/LyingLevel.java): `src/main/java/dev/shadowsoffire/apothic_spawners/block/LyingLevel.java`

### Modifiers and Stats

- [Modifier Recipes](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/data/ASRecipeProvider.java): `src/main/java/dev/shadowsoffire/apothic_spawners/data/ASRecipeProvider.java`
- [Modifier Recipe](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java): `src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java`
- [Stat Change](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/StatModifier.java): `src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/StatModifier.java`
- [Spawner Stats](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java): `src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java`
- [Stat Types](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/CustomStat.java): `src/main/java/dev/shadowsoffire/apothic_spawners/stats/CustomStat.java`
- [Stat API](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStat.java): `src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStat.java`

### Content and Progression

- [Capturing Enchantment](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/data/ASEnchantmentProvider.java): `src/main/java/dev/shadowsoffire/apothic_spawners/data/ASEnchantmentProvider.java`
- [Spawner Loot](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/data/ASLootProvider.java): `src/main/java/dev/shadowsoffire/apothic_spawners/data/ASLootProvider.java`
- [Modifier Criteria](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/advancements/ModifierTrigger.java): `src/main/java/dev/shadowsoffire/apothic_spawners/advancements/ModifierTrigger.java`

### Client Integrations

- [Jade Tooltip](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerClientProvider.java): `src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerClientProvider.java`
- [JEI Category](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerCategory.java): `src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerCategory.java`
- [Recipe Cache](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerRecipeCache.java): `src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerRecipeCache.java`

### Mod Platform

- [Mod Entry](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java): `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`
- [Configuration](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASConfig.java): `src/main/java/dev/shadowsoffire/apothic_spawners/ASConfig.java`
- [Registered Objects](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASObjects.java): `src/main/java/dev/shadowsoffire/apothic_spawners/ASObjects.java`
- [Game Events](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASEvents.java): `src/main/java/dev/shadowsoffire/apothic_spawners/ASEvents.java`
- [Client Setup](https://github.com/shadows-of-fire/apothic-spawners/blob/26.1/src/main/java/dev/shadowsoffire/apothic_spawners/ASClient.java): `src/main/java/dev/shadowsoffire/apothic_spawners/ASClient.java`

### Other components

- **Player**

## Connections

- Player → Spawner Block: uses items (evidence: `README.md`)
- Spawner Block → Modifier Recipe: finds modifier (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerBlock.java`)
- Modifier Recipe → Spawner Tile: applies changes (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java`)
- Modifier Recipe → Stat Change: applies stats (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/SpawnerModifier.java`)
- Stat Change → Spawner Stats: resolves stat (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/modifiers/StatModifier.java`)
- Spawner Stats → Stat API: registers stats (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java`)
- Spawner Stats → Stat Types: uses types (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/stats/SpawnerStats.java`)
- Modifier Recipes → Modifier Recipe: emits recipes (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/data/ASRecipeProvider.java`)
- Spawner Block → Spawner Tile: accesses tile (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerBlock.java`)
- Mod Entry → Registered Objects: bootstraps (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`)
- Mod Entry → Game Events: registers events (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`)
- Mod Entry → Configuration: loads config (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`)
- Mod Entry → Capturing Enchantment: sets up data (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`)
- Mod Entry → Spawner Loot: sets up data (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`)
- Mod Entry → Modifier Recipes: sets up data (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ApothicSpawners.java`)
- Spawner Tile → Spawner Stats: stores stat values (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java`)
- Spawner Item → Spawner Block: represents block
- Game Events → Spawner Stats: reads echo stat (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ASEvents.java`)
- Modifier Criteria → Spawner Tile: checks state (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/advancements/ModifierTrigger.java`)
- Modifier Criteria → Modifier Recipe: checks modifier (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/advancements/ModifierTrigger.java`)
- Client Setup → Recipe Cache: uses cache (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/ASClient.java`)
- JEI Category → Recipe Cache: reads recipes (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerJEIPlugin.java`)
- JEI Category → Modifier Recipe: displays recipes (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerJEIPlugin.java`)
- Jade Tooltip → Spawner Stats: renders stats (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/compat/SpawnerClientProvider.java`)
- Spawner Tile → Spawn Level: uses spawn level (evidence: `src/main/java/dev/shadowsoffire/apothic_spawners/block/ApothSpawnerTile.java`)
