# ayfri/kore architecture

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

- Interactive diagram: https://gitdiagram.com/ayfri/kore
- Repository: https://github.com/ayfri/kore

## Overview

Kore is a Kotlin DSL for authoring Minecraft Java datapacks. The principal workflow is: a datapack author defines functions, commands, arguments, and data-driven resources; Kore serializes those models and emits files, ZIPs, or mod-loader artifacts consumed by Minecraft. Helper and OOP modules generate higher-level gameplay behavior, while experimental bindings import existing datapacks and generate Kotlin bindings. The graph emphasizes sampled runtime paths; broader documented capabilities are represented at their exact enclosing source directories where implementation excerpts were unavailable.

Main entry points: [`kore/src/commonMain/kotlin/io/github/ayfri/kore/Generator.kt`](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/Generator.kt) (Function Generation), [`bindings/src/jvmMain/kotlin/io/github/ayfri/kore/bindings/api/DatapackImporter.kt`](https://github.com/ayfri/kore/blob/master/bindings/src/jvmMain/kotlin/io/github/ayfri/kore/bindings/api/DatapackImporter.kt) (Datapack Importer), [`kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt`](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt) (Datapack Builder), [`kore/src/commonMain/kotlin/io/github/ayfri/kore/arguments/Argument.kt`](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/arguments/Argument.kt) (Argument Serialization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core Datapack DSL"]
  node_datapack["Datapack Builder<br/>[DataPack.kt]"]
  node_functions["Function Generation<br/>[Generator.kt]"]
  node_datapackoutput[("Generated Datapack<br/>[DataPack.kt]")]
end

subgraph group_model["Minecraft Data Model"]
  node_serialization["Argument Serialization<br/>[Argument.kt]"]
  node_datafeatures["Data Features"]
  node_worldgen["Worldgen Models<br/>[NoiseRouter.kt]"]
end

subgraph group_helpers["Gameplay Helpers"]
  node_scheduler["Scheduler Utilities<br/>[Scheduler.kt]"]
  node_inventory["Inventory Manager"]
  node_scoreboards["Scoreboard Manager"]
  node_vfx["VFX Engine<br/>[VfxEngine.kt]"]
  node_renderers["Text Renderers"]
end

subgraph group_bindings["Bindings Importer"]
  node_importer["Datapack Importer"]
  node_downloaders["Archive Downloaders<br/>[Downloader.kt]"]
  node_archive["Archive Sources<br/>[ArchiveSource.kt]"]
  node_bindinggen["Binding Generation<br/>[codeGenerators.kt]"]
  node_bindingsoutput["Kotlin Bindings<br/>[writer.kt]"]
end

subgraph group_oop["OOP Gameplay"]
  node_bossbars["Boss Bar Manager<br/>[BossBarManager.kt]"]
  node_oopgameplay["Gameplay Wrappers"]
end

node_author(("Datapack Author"))
node_minecraft(("Minecraft Java"))
node_archivehost(("Datapack Host"))

node_author -->|"defines datapack"| node_datapack
node_datapack -->|"creates functions"| node_functions
node_datapack -->|"generates files"| node_datapackoutput
node_functions -->|"serializes arguments"| node_serialization
node_serialization -->|"encodes resources"| node_datafeatures
node_datafeatures -->|"writes resources"| node_datapackoutput
node_worldgen -->|"configures worldgen"| node_datafeatures
node_datapackoutput -->|"loads datapack"| node_minecraft
node_scheduler -->|"generates functions"| node_functions
node_inventory -->|"generates listeners"| node_functions
node_scoreboards -->|"emits commands"| node_functions
node_vfx -->|"generates particles"| node_functions
node_renderers -->|"builds text"| node_serialization
node_bossbars -->|"registers bossbar"| node_datapack
node_oopgameplay -->|"generates gameplay"| node_functions
node_author -->|"imports datapack"| node_importer
node_importer -->|"obtains archive"| node_downloaders
node_downloaders -.->|"downloads archive"| node_archivehost
node_importer -->|"reads archive"| node_archive
node_importer -->|"explores resources"| node_bindinggen
node_bindinggen -->|"writes bindings"| node_bindingsoutput

click node_datapack "https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt"
click node_functions "https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/Generator.kt"
click node_serialization "https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/arguments/Argument.kt"
click node_datafeatures "https://github.com/ayfri/kore/tree/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/features"
click node_worldgen "https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/features/worldgen/noisesettings/NoiseRouter.kt"
click node_datapackoutput "https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt"
click node_scheduler "https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/Scheduler.kt"
click node_inventory "https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/inventorymanager/InventoryManager.kt"
click node_scoreboards "https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/ScoreboardManager.kt"
click node_vfx "https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/vfx/VfxEngine.kt"
click node_renderers "https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/text/MarkdownRenderer.kt"
click node_bossbars "https://github.com/ayfri/kore/blob/master/oop/src/commonMain/kotlin/io/github/ayfri/kore/bossbar/BossBarManager.kt"
click node_oopgameplay "https://github.com/ayfri/kore/tree/master/oop/src/commonMain/kotlin/io/github/ayfri/kore"
click node_importer "https://github.com/ayfri/kore/blob/master/bindings/src/jvmMain/kotlin/io/github/ayfri/kore/bindings/api/DatapackImporter.kt"
click node_downloaders "https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/download/Downloader.kt"
click node_archive "https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/ArchiveSource.kt"
click node_bindinggen "https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/generation/codeGenerators.kt"
click node_bindingsoutput "https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/writer.kt"

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_datapack,node_functions,node_datapackoutput toneBlue
class node_serialization,node_datafeatures,node_worldgen toneAmber
class node_scheduler,node_inventory,node_scoreboards,node_vfx,node_renderers toneMint
class node_importer,node_downloaders,node_archive,node_bindinggen,node_bindingsoutput toneRose
class node_bossbars,node_oopgameplay,node_author,node_minecraft,node_archivehost toneIndigo
```

## Components

### Core Datapack DSL

- [Datapack Builder](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt): `kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt`
- [Function Generation](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/Generator.kt): `kore/src/commonMain/kotlin/io/github/ayfri/kore/Generator.kt`
- [Generated Datapack](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt): `kore/src/commonMain/kotlin/io/github/ayfri/kore/DataPack.kt`

### Minecraft Data Model

- [Argument Serialization](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/arguments/Argument.kt): `kore/src/commonMain/kotlin/io/github/ayfri/kore/arguments/Argument.kt`
- [Data Features](https://github.com/ayfri/kore/tree/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/features): `kore/src/commonMain/kotlin/io/github/ayfri/kore/features`
- [Worldgen Models](https://github.com/ayfri/kore/blob/master/kore/src/commonMain/kotlin/io/github/ayfri/kore/features/worldgen/noisesettings/NoiseRouter.kt): `kore/src/commonMain/kotlin/io/github/ayfri/kore/features/worldgen/noisesettings/NoiseRouter.kt`

### Gameplay Helpers

- [Scheduler Utilities](https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/Scheduler.kt): `helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/Scheduler.kt`
- [Inventory Manager](https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/inventorymanager/InventoryManager.kt): `helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/inventorymanager/InventoryManager.kt`
- [Scoreboard Manager](https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/ScoreboardManager.kt): `helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/ScoreboardManager.kt`
- [VFX Engine](https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/vfx/VfxEngine.kt): `helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/vfx/VfxEngine.kt`
- [Text Renderers](https://github.com/ayfri/kore/blob/master/helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/text/MarkdownRenderer.kt): `helpers/src/commonMain/kotlin/io/github/ayfri/kore/helpers/text/MarkdownRenderer.kt`

### Bindings Importer

- [Datapack Importer](https://github.com/ayfri/kore/blob/master/bindings/src/jvmMain/kotlin/io/github/ayfri/kore/bindings/api/DatapackImporter.kt): `bindings/src/jvmMain/kotlin/io/github/ayfri/kore/bindings/api/DatapackImporter.kt`
- [Archive Downloaders](https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/download/Downloader.kt): `bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/download/Downloader.kt`
- [Archive Sources](https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/ArchiveSource.kt): `bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/ArchiveSource.kt`
- [Binding Generation](https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/generation/codeGenerators.kt): `bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/generation/codeGenerators.kt`
- [Kotlin Bindings](https://github.com/ayfri/kore/blob/master/bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/writer.kt): `bindings/src/commonMain/kotlin/io/github/ayfri/kore/bindings/writer.kt`

### OOP Gameplay

- [Boss Bar Manager](https://github.com/ayfri/kore/blob/master/oop/src/commonMain/kotlin/io/github/ayfri/kore/bossbar/BossBarManager.kt): `oop/src/commonMain/kotlin/io/github/ayfri/kore/bossbar/BossBarManager.kt`
- [Gameplay Wrappers](https://github.com/ayfri/kore/tree/master/oop/src/commonMain/kotlin/io/github/ayfri/kore): `oop/src/commonMain/kotlin/io/github/ayfri/kore`

### Other components

- **Datapack Author**
- **Minecraft Java**
- **Datapack Host**

## Connections

- Datapack Author → Datapack Builder: defines datapack
- Datapack Builder → Function Generation: creates functions
- Datapack Builder → Generated Datapack: generates files
- Function Generation → Argument Serialization: serializes arguments
- Argument Serialization → Data Features: encodes resources
- Data Features → Generated Datapack: writes resources
- Worldgen Models → Data Features: configures worldgen
- Generated Datapack → Minecraft Java: loads datapack
- Scheduler Utilities → Function Generation: generates functions
- Inventory Manager → Function Generation: generates listeners
- Scoreboard Manager → Function Generation: emits commands
- VFX Engine → Function Generation: generates particles
- Text Renderers → Argument Serialization: builds text
- Boss Bar Manager → Datapack Builder: registers bossbar
- Gameplay Wrappers → Function Generation: generates gameplay
- Datapack Author → Datapack Importer: imports datapack
- Datapack Importer → Archive Downloaders: obtains archive
- Archive Downloaders → Datapack Host: downloads archive
- Datapack Importer → Archive Sources: reads archive
- Datapack Importer → Binding Generation: explores resources
- Binding Generation → Kotlin Bindings: writes bindings
