# ctarron/item_destruction_warning architecture

> Architecture diagram of the GitHub repository ctarron/item_destruction_warning, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ctarron/item_destruction_warning
- Repository: https://github.com/ctarron/item_destruction_warning

## Overview

##### Project type and purpose
- This is a Minecraft “datapack” — a pure data‑driven mod that plugs into the Minecraft engine.
- Purpose: watch for certain “important” items being destroyed or despawning, and send a chat notification when that happens.

##### File structure
- Top‐level:
- pack.mcmeta – datapack manifest
- data/ – contains all namespaced data under two namespaces:
◦ ctarron_destruction_warning/ – your custom namespace
· function/ – MCFunction scripts (load, tick, check_for_hoppers, etc.)
· predicate/ – JSON filters for logic decisions
· tags/item/ – lists of items marked “important” or “important_named”
◦ minecraft/ – hooks into vanilla behavior
· tags/function/ – load.json, tick.json to register your functions with the engine
- No “binary” code or external services—everything is JSON and plaintext functions that the engine interprets.

##### Review README insights
- Confirms the goal (“send a chat message when an important item despawns or is destroyed”).
- Enumerates which items are always “important” vs. only important when named.

##### Main components
a. Minecraft Engine & Datapack Loader
b. Namespaced datapack (ctarron_destruction_warning)
– Functions (load.mcfunction, tick.mcfunction, check_for_hoppers.mcfunction, etc.)
– Predicates (has_marker_passenger.json, is_important.json, etc.)
– Tags (lists of items under tags/item/*.json)
c. Vanilla integration namespace (minecraft/tags/function)
– load.json (calls ctarron:load)
– tick.json (calls ctarron:tick)
d. Chat Output subsystem (in‐game player chat)

##### Relationships & interactions
1. On startup, the engine reads pack.mcmeta → registers the datapack
2. Engine reads minecraft/tags/function/load.json → calls ctarron_destruction_warning:function/load.mcfunction
3. Engine’s tick loop invokes ctarron_destruction_warning:function/tick.mcfunction every game tick via minecraft/tags/function/tick.json
4. tick.mcfunction orchestrates:
- calls check_for_hoppers (detects carried items)
- calls has_despawned (compares current items to previous state)
- uses predicates (is_important, is_important_when_named) to filter items
- when a target is found, calls message.mcfunction to send chat
5. Tags JSON provide the item‐lists that predicates query

##### Architectural patterns & design principles
- Event‑driven: functions triggered on load & on every tick
- Data‑driven: JSON predicates and tags completely drive logic and item definitions
- Namespace isolation: separates your datapack logic (ctarron_destruction_warning) from vanilla (minecraft)

##### Final checklist
– All components clearly labeled
– Layered layout: Engine → Loader → Namespaced datapack (split into functions + data) → Player chat

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Engine Layer
    Engine["Minecraft Engine & Datapack Loader"]:::engine

    %% Vanilla Integration
    subgraph "Vanilla Integration (minecraft/tags/function)"
        LoadTag["load.json"]:::data
        TickTag["tick.json"]:::data
    end

    %% Datapack Namespace
    subgraph "ctarron_destruction_warning"
        subgraph "Functions" 
            LoadFunc["load.mcfunction"]:::logic
            TickFunc["tick.mcfunction"]:::logic
            CheckHoppers["check_for_hoppers.mcfunction"]:::logic
            HasDespawned["has_despawned.mcfunction"]:::logic
            MarkItem["mark_item.mcfunction"]:::logic
            SelectedMarker["selected_marker.mcfunction"]:::logic
            Message["message.mcfunction"]:::logic
        end
        subgraph "Data Definitions"
            subgraph "Predicates"
                HasMarker["has_marker_passenger.json"]:::data
                IsImportant["is_important.json"]:::data
                IsNamed["is_important_when_named.json"]:::data
                MarkerRides["marker_rides_item.json"]:::data
            end
            subgraph "Tags"
                ImportantTag["important.json"]:::data
                ImportantNamedTag["important_named.json"]:::data
            end
        end
    end

    %% Output
    Chat["Player Chat"]:::output

    %% Connections
    Engine -->|"registers datapack via pack.mcmeta"| Engine
    Engine -->|"on load event"| LoadTag
    Engine -->|"on tick event"| TickTag

    LoadTag -->|"calls"| LoadFunc
    TickTag -->|"calls"| TickFunc

    TickFunc -->|"invoke"| CheckHoppers
    TickFunc -->|"invoke"| HasDespawned
    CheckHoppers -->|"uses predicates"| HasMarker
    HasDespawned -->|"uses predicates"| IsImportant
    HasDespawned -->|"uses predicates"| IsNamed
    HasMarker -->|"filters via tag lists"| ImportantTag
    IsNamed -->|"filters via tag lists"| ImportantNamedTag

    HasDespawned -->|"when target found"| Message
    Message -->|"send chat"| Chat

    %% Click Events
    click Engine "https://github.com/ctarron/item_destruction_warning/blob/main/pack.mcmeta"
    click LoadTag "https://github.com/ctarron/item_destruction_warning/blob/main/data/minecraft/tags/function/load.json"
    click TickTag "https://github.com/ctarron/item_destruction_warning/blob/main/data/minecraft/tags/function/tick.json"
    click LoadFunc "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/load.mcfunction"
    click TickFunc "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/tick.mcfunction"
    click CheckHoppers "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/check_for_hoppers.mcfunction"
    click HasDespawned "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/has_despawned.mcfunction"
    click MarkItem "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/mark_item.mcfunction"
    click SelectedMarker "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/selected_marker.mcfunction"
    click Message "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/function/message.mcfunction"
    click HasMarker "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/predicate/has_marker_passenger.json"
    click IsImportant "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/predicate/is_important.json"
    click IsNamed "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/predicate/is_important_when_named.json"
    click MarkerRides "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/predicate/marker_rides_item.json"
    click ImportantTag "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/tags/item/important.json"
    click ImportantNamedTag "https://github.com/ctarron/item_destruction_warning/blob/main/data/ctarron_destruction_warning/tags/item/important_named.json"

    %% Styles
    classDef engine fill:#f5b041,stroke:#333,stroke-width:1px
    classDef logic fill:#27ae60,stroke:#333,stroke-width:1px
    classDef data fill:#3498db,stroke:#333,stroke-width:1px
    classDef output fill:#8e44ad,stroke:#333,stroke-width:1px
```
