# mogu6321/bedwars_datapack architecture

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

- Interactive diagram: https://gitdiagram.com/mogu6321/bedwars_datapack
- Repository: https://github.com/mogu6321/bedwars_datapack

## Overview

##### Project type and purpose
- Type: A Minecraft “datapack” that re-implements the Hypixel BedWars minigame.
- Purpose: Provide game logic (generator spawns, shops, player tracking, maps) via Minecraft’s datapack system.

##### File structure
- Top-level:
– pack.mcmeta / readme.md – metadata and docs.
– spyglass.json – optional visual config
– data/ – main namespace directory.
- Under data/: three namespaces:
– minecraft/ – built-in advancement & tag overrides.
– map/ – one Function per arena map for initial setup.
– mogu/ – custom namespace with subfolders:
- dimension / dimension_type – JSON definitions for each arena “world.”
- function/ – grouped by feature: generator, item, player, reset, shop.
- predicate / tags / dialog – auxiliary data for conditions, UI, block categories.

##### README
- Confirms it’s a BedWars clone datapack, still in development.

##### Main components & interactions
a. Minecraft Server / Engine (host runtime)
b. Datapack Loader
– Reads pack.mcmeta, loads JSON definitions (dimension, tags, predicates).
– Registers functions under namespaces.
c. Namespaces and Modules
1. – one‐time or on-command map initialization routines (acropolis.mcfunction, etc.)
2. minecraft – advancement and tag “plumbing” at game start
3. mogu namespace:
- dimension & dimension_type – define custom worlds and their properties
- function/generator – logic for diamond, emerald, custom ore generators, timers
- function/shop – UI pages, item purchases, inventory tracking
- function/item – tower building, shop item distributions
- function/player – player stat tracking, item-count checks
- function/reset – game-state resets for generators, items, players
- predicate & tags – conditional checks, categorizations for items/blocks
d. Data/JSON resources
– Define behaviors, spawn rules, UI dialogs (data/mogu/dialog), block tags (data/mogu/tags), and advancement roots.

##### Architectural patterns & design principles
- Namespaced, modular design – each feature in its own folder under mogu/function
- Data-driven: JSON files drive configuration (dimensions, predicates, tags)
- Event-triggered flows: tick.json in minecraft/tags/function triggers main loops.
- Layering:
– Initialization (map, dimension) → Runtime loops (generator timers, shop UI) → Reset phases

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Minecraft Server"
        DPL["Datapack Loader"]:::loader
        DOC["Documentation & Metadata"]:::config
        VIS["Visual Config"]:::config

        subgraph "Built-in Namespace"
            ADV["Advancements"]:::config
            TICK["Tick Event Tag"]:::config
        end

        subgraph "Map Initialization Modules"
            MAP["Map Modules"]:::init
        end

        subgraph "Custom Namespace (mogu)"
            subgraph "Configurations"
                DIM["Dimension Configurations"]:::config
                DTYPE["Dimension Types"]:::config
            end
            subgraph "Function Modules"
                GEN["Generator Logic"]:::logic
                SHOP["Shop Logic"]:::logic
                ITEM["Item Logic"]:::logic
                PLAYER["Player Tracking Logic"]:::logic
                RESET["Reset Logic"]:::logic
            end
            subgraph "Supporting Data"
                PRED["Predicates"]:::config
                TAGS["Block Tags"]:::config
                DLOG["UI Dialog Definitions"]:::config
            end
        end
    end

    DPL -->|"loads JSON"| ADV
    DPL -->|"loads JSON"| TICK
    DPL -->|"loads JSON"| DIM
    DPL -->|"loads JSON"| DTYPE
    DPL -->|"loads JSON"| PRED
    DPL -->|"loads JSON"| TAGS
    DPL -->|"loads JSON"| DLOG
    DPL -->|"reads metadata"| DOC
    DPL -->|"reads config"| VIS
    DPL -->|"loads functions"| MAP

    TICK -->|"tick event"| GEN
    MAP -->|"init command"| DPL

    SHOP -->|"calls item logic"| ITEM
    RESET -->|"resets generators"| GEN
    RESET -->|"resets players"| PLAYER

    click DPL "https://github.com/mogu6321/bedwars_datapack/blob/main/pack.mcmeta"
    click DOC "https://github.com/mogu6321/bedwars_datapack/blob/main/readme.md"
    click VIS "https://github.com/mogu6321/bedwars_datapack/blob/main/spyglass.json"
    click ADV "https://github.com/mogu6321/bedwars_datapack/tree/main/data/minecraft/advancement"
    click TICK "https://github.com/mogu6321/bedwars_datapack/blob/main/data/minecraft/tags/function/tick.json"
    click MAP "https://github.com/mogu6321/bedwars_datapack/blob/main/data/map/*.mcfunction"
    click DIM "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/dimension"
    click DTYPE "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/dimension_type"
    click GEN "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/function/generator"
    click SHOP "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/function/shop"
    click ITEM "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/function/item"
    click PLAYER "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/function/player"
    click RESET "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/function/reset"
    click PRED "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/predicate"
    click TAGS "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/tags"
    click DLOG "https://github.com/mogu6321/bedwars_datapack/tree/main/data/mogu/dialog"

    classDef loader fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef config fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef logic fill:#90EE90,stroke:#333,stroke-width:1px
    classDef init fill:#FFA500,stroke:#333,stroke-width:1px
```
