# laboulangerie/laboulangeriemmo architecture

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

- Interactive diagram: https://gitdiagram.com/laboulangerie/laboulangeriemmo
- Repository: https://github.com/laboulangerie/laboulangeriemmo

## Overview

##### Main Components Identification
The system should be divided into these primary components:

a) Core Plugin Architecture:
- Main Plugin Class (LaBoulangerieMmo.java)
- API Layer
- Event System
- Command System

b) Feature Modules:
- Talent System
- Abilities System
- XP/Leveling System
- Combo System
- Leaderboard System
- Blockus System (seems to be a block tracking system)

##### Integration Components
- BetonQuest Integration
- MythicMobs Integration
- WorldGuard Support
- PlaceholderAPI Integration (via MmoExpansion)

**[Plugin Core Layer]**
- ↑↓
**[Feature Modules Layer]**
- ↑↓
**[Integration Layer]**
- ↑↓
**[Minecraft Server API]**

##### Component Relationships

a) Core Components:
- MmoPlayerManager ←→ MmoPlayer (manages player data)
- AbilitiesRegistry ←→ AbilityArchetype (ability system)
- TalentsRegistry ←→ TalentArchetype (talent system)
- XpBoostManager ←→ XpBoostObj (XP management)

b) Feature Interactions:
- How the Combo System feeds into Abilities
- LeaderBoard system to player statistics
- Link Blockus system to block tracking features

##### Detailed Component Breakdown

For each major component, show:
- Input/Output relationships
- Data flow direction
- Dependencies on other components
- External service interactions

##### Implementation Details

Specific implementation patterns:
- Event-driven architecture for ability triggers
- Player data management system
- Integration points with Minecraft server API
- Configuration loading and management

##### The event-driven architecture for abilities and talents

Keep the abstraction level high enough to show the overall architecture while including enough detail to understand the relationships between components. Use UML notation where appropriate, but prioritize clarity over strict UML compliance.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Core
        Main["Main Plugin Class"]:::core
        API["API Layer"]:::api
        EventSys["Event System"]:::core
        CmdSys["Command System"]:::core
    end

    subgraph Features
        TalentSys["Talent System"]:::feature
        AbilitySys["Abilities System"]:::feature
        XPSys["XP/Leveling System"]:::feature
        ComboSys["Combo System"]:::feature
        LeaderSys["Leaderboard System"]:::feature
        BlockusSys["Blockus System"]:::feature
    end

    subgraph API_Components
        PlayerMgr["Player Management"]:::api
        AbilityAPI["Ability System API"]:::api
        TalentAPI["Talent System API"]:::api
        XPBoostAPI["XP Boost System"]:::api
    end

    subgraph Integrations
        BetonQuest["BetonQuest"]:::integration
        MythicMobs["MythicMobs"]:::integration
        WorldGuard["WorldGuard"]:::integration
        PlaceholderAPI["PlaceholderAPI"]:::integration
    end

    subgraph Data
        Redis["Redis"]:::database
        JSON["JSON Serialization"]:::database
    end

    Main --> API
    Main --> EventSys
    Main --> CmdSys

    API --> API_Components
    API_Components --> Features

    BlockusSys --> Redis
    Features --> EventSys
    Features --> JSON

    EventSys --> Integrations
    API --> Integrations

    %% Component Mappings
    click Main "https://github.com/LaBoulangerie/LaBoulangerieMMO/blob/master/src/main/java/net/laboulangerie/laboulangeriemmo/LaBoulangerieMmo.java"
    click PlayerMgr "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/api/player"
    click AbilityAPI "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/api/ability"
    click TalentAPI "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/api/talent"
    click XPBoostAPI "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/api/xpboost"
    click ComboSys "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/combo"
    click LeaderSys "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/mapleaderboard"
    click BlockusSys "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/blockus"
    click AbilitySys "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/abilities"
    click XPSys "https://github.com/LaBoulangerie/LaBoulangerieMMO/blob/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/XpBar.java"
    click EventSys "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/events"
    click CmdSys "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/commands"
    click BetonQuest "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/betonquest"
    click MythicMobs "https://github.com/LaBoulangerie/LaBoulangerieMMO/blob/master/src/main/java/net/laboulangerie/laboulangeriemmo/utils/MythicMobsSupport.java"
    click WorldGuard "https://github.com/LaBoulangerie/LaBoulangerieMMO/blob/master/src/main/java/net/laboulangerie/laboulangeriemmo/utils/WolrdGuardSupport.java"
    click PlaceholderAPI "https://github.com/LaBoulangerie/LaBoulangerieMMO/blob/master/src/main/java/net/laboulangerie/laboulangeriemmo/expansions/MmoExpansion.java"
    click JSON "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/json"
    click Redis "https://github.com/LaBoulangerie/LaBoulangerieMMO/tree/master/src/main/java/net/laboulangerie/laboulangeriemmo/core/blockus/redis"

    classDef core fill:#2374ab
    classDef api fill:#57b894
    classDef feature fill:#ffb627
    classDef integration fill:#9b5de5
    classDef database fill:#f15bb5
```
