# shigure-ruiseki/okcore architecture

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

- Interactive diagram: https://gitdiagram.com/shigure-ruiseki/okcore
- Repository: https://github.com/shigure-ruiseki/okcore

## Overview

OKCore is a reusable Minecraft core mod rather than a standalone user-facing workflow. Its runtime provides mod initialization, capability and ingredient abstractions, datapack recipes and tags, persistence, networking, and input/UI helpers for dependent mods. The graph emphasizes those documented capabilities and the sampled initialization, recipe/tag, storage, and persistence responsibilities. README claims and the file tree support several subsystem nodes, but unsampled implementations are linked only where the README or source index establishes the relationship.

Main entry points: [`src/main/java/ruiseki/okcore/init/ModBase.java`](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/init/ModBase.java) (Mod lifecycle), [`src/main/java/ruiseki/okcore/OKCore.java`](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/OKCore.java) (Mod entrypoint), [`src/main/java/ruiseki/commoncapabilities/api/ingredient/storage/IIngredientComponentStorage.java`](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/api/ingredient/storage/IIngredientComponentStorage.java) (Ingredient storage), [`src/main/java/ruiseki/okcore/capabilities/Capability.java`](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/capabilities/Capability.java) (Capability API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Core lifecycle"]
  node_okcore["Mod entrypoint<br/>[OKCore.java]"]
  node_modbase["Mod lifecycle<br/>[ModBase.java]"]
  node_config["Configuration<br/>[ConfigHandler.java]"]
  node_registry["Registry management"]
end

subgraph group_data["Datapack data"]
  node_data_manager["Datapack loading<br/>[DataManager.java]"]
  node_datapack_manager["Datapack manager"]
  node_recipes["Recipe loading<br/>[RecipeManager.java]"]
  node_tags["Tag loading<br/>[TagManager.java]"]
end

subgraph group_capabilities["Capabilities and ingredients"]
  node_cap_manager["Capability registry"]
  node_capability["Capability API<br/>[Capability.java]"]
  node_ingredient_api["Ingredient components"]
  node_ingredient_storage["Ingredient storage"]
  node_item_wrappers["Item storage adapters"]
  node_fluid_wrappers["Fluid storage adapters"]
  node_collections["Storage collections"]
end

subgraph group_runtime["Runtime services"]
  node_world_storage[("World persistence<br/>[WorldStorage.java]")]
  node_tile_nbt["Tile NBT storage"]
  node_network["Packet messaging<br/>[PacketHandler.java]"]
  node_input["Input events<br/>[KeyRegistry.java]"]
  node_gui["GUI helpers<br/>[GuiScreens.java]"]
end

subgraph group_integrations["Mod integrations"]
  node_vanilla["Vanilla adapters"]
  node_mekanism["Mekanism adapters"]
  node_enderio["Ender IO adapters"]
end

node_dependent_mod(("Dependent mod"))

node_dependent_mod -.->|"uses core"| node_okcore
node_okcore -->|"extends lifecycle"| node_modbase
node_okcore -->|"registers managers"| node_registry
node_okcore -->|"registers manager"| node_recipes
node_okcore -->|"registers manager"| node_tags
node_modbase -->|"loads configuration"| node_config
node_modbase -->|"initializes packets"| node_network
node_modbase -->|"registers keys"| node_input
node_modbase -->|"supports world data"| node_world_storage
node_modbase -.->|"supports UI"| node_gui
node_modbase -->|"injects capabilities"| node_cap_manager
node_cap_manager -->|"creates capabilities"| node_capability
node_data_manager -->|"loads datapacks"| node_datapack_manager
node_datapack_manager -->|"provides reload data"| node_recipes
node_datapack_manager -->|"provides reload data"| node_tags
node_ingredient_api -->|"defines storage API"| node_ingredient_storage
node_ingredient_storage -->|"wrapped by"| node_item_wrappers
node_ingredient_storage -->|"wrapped by"| node_fluid_wrappers
node_ingredient_storage -->|"composed as collection"| node_collections
node_vanilla -.->|"adapts capabilities"| node_capability
node_mekanism -.->|"adapts capabilities"| node_capability
node_enderio -.->|"adapts energy"| node_capability
node_tile_nbt -.->|"persists NBT"| node_world_storage

click node_okcore "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/OKCore.java"
click node_modbase "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/init/ModBase.java"
click node_config "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/config/ConfigHandler.java"
click node_registry "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/init/RegistryManager.java"
click node_data_manager "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/data/DataManager.java"
click node_datapack_manager "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/data/DatapackManager.java"
click node_recipes "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/recipe/RecipeManager.java"
click node_tags "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/tag/TagManager.java"
click node_cap_manager "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/capabilities/CapabilityManager.java"
click node_capability "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/capabilities/Capability.java"
click node_ingredient_api "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/api/ingredient/IngredientComponent.java"
click node_ingredient_storage "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/api/ingredient/storage/IIngredientComponentStorage.java"
click node_item_wrappers "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerItemStack.java"
click node_fluid_wrappers "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerFluidStack.java"
click node_collections "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/ingredient/storage/IngredientComponentStorageCollectionWrapper.java"
click node_world_storage "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/persist/world/WorldStorage.java"
click node_tile_nbt "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/tileentity/TileEntityNBTStorage.java"
click node_network "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/network/PacketHandler.java"
click node_input "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/client/key/KeyRegistry.java"
click node_gui "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/client/gui/GuiScreens.java"
click node_vanilla "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/modcompat/vanilla/VanillaModCompat.java"
click node_mekanism "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/modcompat/mekansim/MekanismModCompat.java"
click node_enderio "https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/modcompat/enderio/EnderIOModCompat.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_okcore,node_modbase,node_config,node_registry toneBlue
class node_data_manager,node_datapack_manager,node_recipes,node_tags toneAmber
class node_cap_manager,node_capability,node_ingredient_api,node_ingredient_storage,node_item_wrappers,node_fluid_wrappers,node_collections toneMint
class node_world_storage,node_tile_nbt,node_network,node_input,node_gui toneRose
class node_vanilla,node_mekanism,node_enderio,node_dependent_mod toneIndigo
```

## Components

### Core lifecycle

- [Mod entrypoint](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/OKCore.java): `src/main/java/ruiseki/okcore/OKCore.java`
- [Mod lifecycle](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/init/ModBase.java): `src/main/java/ruiseki/okcore/init/ModBase.java`
- [Configuration](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/config/ConfigHandler.java): `src/main/java/ruiseki/okcore/config/ConfigHandler.java`
- [Registry management](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/init/RegistryManager.java): `src/main/java/ruiseki/okcore/init/RegistryManager.java`

### Datapack data

- [Datapack loading](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/data/DataManager.java): `src/main/java/ruiseki/okcore/data/DataManager.java`
- [Datapack manager](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/data/DatapackManager.java): `src/main/java/ruiseki/okcore/data/DatapackManager.java`
- [Recipe loading](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/recipe/RecipeManager.java): `src/main/java/ruiseki/okcore/recipe/RecipeManager.java`
- [Tag loading](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/tag/TagManager.java): `src/main/java/ruiseki/okcore/tag/TagManager.java`

### Capabilities and ingredients

- [Capability registry](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/capabilities/CapabilityManager.java): `src/main/java/ruiseki/okcore/capabilities/CapabilityManager.java`
- [Capability API](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/capabilities/Capability.java): `src/main/java/ruiseki/okcore/capabilities/Capability.java`
- [Ingredient components](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/api/ingredient/IngredientComponent.java): `src/main/java/ruiseki/commoncapabilities/api/ingredient/IngredientComponent.java`
- [Ingredient storage](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/api/ingredient/storage/IIngredientComponentStorage.java): `src/main/java/ruiseki/commoncapabilities/api/ingredient/storage/IIngredientComponentStorage.java`
- [Item storage adapters](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerItemStack.java): `src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerItemStack.java`
- [Fluid storage adapters](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerFluidStack.java): `src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerFluidStack.java`
- [Storage collections](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/ingredient/storage/IngredientComponentStorageCollectionWrapper.java): `src/main/java/ruiseki/okcore/ingredient/storage/IngredientComponentStorageCollectionWrapper.java`

### Runtime services

- [World persistence](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/persist/world/WorldStorage.java): `src/main/java/ruiseki/okcore/persist/world/WorldStorage.java`
- [Tile NBT storage](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/tileentity/TileEntityNBTStorage.java): `src/main/java/ruiseki/okcore/tileentity/TileEntityNBTStorage.java`
- [Packet messaging](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/network/PacketHandler.java): `src/main/java/ruiseki/okcore/network/PacketHandler.java`
- [Input events](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/client/key/KeyRegistry.java): `src/main/java/ruiseki/okcore/client/key/KeyRegistry.java`
- [GUI helpers](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/okcore/client/gui/GuiScreens.java): `src/main/java/ruiseki/okcore/client/gui/GuiScreens.java`

### Mod integrations

- [Vanilla adapters](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/modcompat/vanilla/VanillaModCompat.java): `src/main/java/ruiseki/commoncapabilities/modcompat/vanilla/VanillaModCompat.java`
- [Mekanism adapters](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/modcompat/mekansim/MekanismModCompat.java): `src/main/java/ruiseki/commoncapabilities/modcompat/mekansim/MekanismModCompat.java`
- [Ender IO adapters](https://github.com/shigure-ruiseki/okcore/blob/master/src/main/java/ruiseki/commoncapabilities/modcompat/enderio/EnderIOModCompat.java): `src/main/java/ruiseki/commoncapabilities/modcompat/enderio/EnderIOModCompat.java`

### Other components

- **Dependent mod**

## Connections

- Dependent mod → Mod entrypoint: uses core
- Mod entrypoint → Mod lifecycle: extends lifecycle (evidence: `src/main/java/ruiseki/okcore/OKCore.java`)
- Mod entrypoint → Registry management: registers managers (evidence: `src/main/java/ruiseki/okcore/OKCore.java`)
- Mod entrypoint → Recipe loading: registers manager (evidence: `src/main/java/ruiseki/okcore/OKCore.java`)
- Mod entrypoint → Tag loading: registers manager (evidence: `src/main/java/ruiseki/okcore/OKCore.java`)
- Mod lifecycle → Configuration: loads configuration (evidence: `src/main/java/ruiseki/okcore/init/ModBase.java`)
- Mod lifecycle → Packet messaging: initializes packets (evidence: `src/main/java/ruiseki/okcore/init/ModBase.java`)
- Mod lifecycle → Input events: registers keys (evidence: `src/main/java/ruiseki/okcore/init/ModBase.java`)
- Mod lifecycle → World persistence: supports world data (evidence: `src/main/java/ruiseki/okcore/persist/world/WorldStorage.java`)
- Mod lifecycle → GUI helpers: supports UI
- Mod lifecycle → Capability registry: injects capabilities
- Capability registry → Capability API: creates capabilities (evidence: `src/main/java/ruiseki/okcore/capabilities/CapabilityManager.java`)
- Datapack loading → Datapack manager: loads datapacks (evidence: `src/main/java/ruiseki/okcore/data/DatapackManager.java`)
- Datapack manager → Recipe loading: provides reload data (evidence: `src/main/java/ruiseki/okcore/recipe/RecipeManager.java`)
- Datapack manager → Tag loading: provides reload data (evidence: `src/main/java/ruiseki/okcore/tag/TagManager.java`)
- Ingredient components → Ingredient storage: defines storage API (evidence: `src/main/java/ruiseki/commoncapabilities/api/ingredient/IngredientComponent.java`)
- Ingredient storage → Item storage adapters: wrapped by (evidence: `src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerItemStack.java`)
- Ingredient storage → Fluid storage adapters: wrapped by (evidence: `src/main/java/ruiseki/commoncapabilities/ingredient/storage/IngredientComponentStorageWrapperHandlerFluidStack.java`)
- Ingredient storage → Storage collections: composed as collection (evidence: `src/main/java/ruiseki/okcore/ingredient/storage/IngredientComponentStorageCollectionWrapper.java`)
- Vanilla adapters → Capability API: adapts capabilities
- Mekanism adapters → Capability API: adapts capabilities
- Ender IO adapters → Capability API: adapts energy
- Tile NBT storage → World persistence: persists NBT (evidence: `src/main/java/ruiseki/okcore/tileentity/TileEntityNBTStorage.java`)
