# michaai/strange_hexes architecture

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

- Interactive diagram: https://gitdiagram.com/michaai/strange_hexes
- Repository: https://github.com/michaai/strange_hexes

## Overview

##### Main Components

a) Core Plugin Component:
- Entry point: StrangeHexes.java
- Configuration: ConfigLoader.java
- Discord Integration: DiscordIntegration.java

b) Generation System:
- WTFMapGenerator package as the main generation engine
- Multiple tiling strategies organized in hierarchical structure

**Top Level:**
**[Plugin Core] ←→ [Discord Integration]**
- ↓
**[Configuration System]**
- ↓
**[Map Generation Engine]**
- ↓

##### Detailed Component Breakdown

a) Plugin Core (Central Component):
- Connections to Configuration and Discord systems

b) Generation System (Largest Component):
- Divide into four main sections:
1. Generator Interface (BaseClusterGenerator)
2. Regular Tilings
3. Semi-regular Tilings
4. Uniform Tilings (Two & Three)

- Inheritance hierarchy from BaseShape
- Polygon types (Triangle, Square, Hexagon, Octagon, Dodecagon)

##### Specific Implementation Details

Use the following visual elements:

- Blue: Core plugin components
- Green: Generation systems
- Gray: Utility classes

##### Key Relationships to Highlight

- How MapGenerators interact with HexGenerators
- Demonstrate how the tiling systems (Regular, Semi-regular, Uniform) relate to each other

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Core
        SP[StrangeHexes Plugin]:::core
        CL[Config Loader]:::core
        DI[Discord Integration]:::core
    end

    subgraph "Map Generation System"
        MG[Base Map Generator]:::generator
        BCG[Base Cluster Generator]:::generator
        
        subgraph "Tiling Strategies"
            direction TB
            RT[Regular Tilings]:::generator
            SRT[Semi-regular Tilings]:::generator
            TUT[Two Uniform Tilings]:::generator
            ThUT[Three Uniform Tilings]:::generator
        end
    end

    subgraph "Shape System"
        direction TB
        BS[Base Shape]:::shape
        PB[Polygon Base]:::shape
        GS[Generated Shape]:::shape
        DS[Drawing System]:::shape
        
        subgraph "Polygon Types"
            direction TB
            TRI[Triangle]:::shape
            SQ[Square]:::shape
            HEX[Hexagon]:::shape
            OCT[Octagon]:::shape
            DOD[Dodecagon]:::shape
        end
    end

    %% Core Relationships
    SP --> CL
    SP --> DI
    SP --> MG

    %% Generator Relationships
    MG --> BCG
    BCG --> RT
    BCG --> SRT
    BCG --> TUT
    BCG --> ThUT

    %% Shape Relationships
    BS --> PB
    PB --> TRI
    PB --> SQ
    PB --> HEX
    PB --> OCT
    PB --> DOD
    BS --> GS
    GS --> DS

    %% Generation to Shape Relationships
    BCG --> BS

    %% Style Definitions
    classDef core fill:#3498db,stroke:#2980b9,color:white
    classDef generator fill:#2ecc71,stroke:#27ae60,color:white
    classDef shape fill:#f1c40f,stroke:#f39c12,color:black

    %% Click Events
    click SP "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/StrangeHexes.java"
    click CL "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/ConfigLoader.java"
    click DI "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/DiscordIntegration.java"
    click MG "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/WTFMapGenerator/MapGenerators/BaseMapGenerator.java"
    click BCG "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/WTFMapGenerator/HexGenerators/BaseClusterGenerator.java"
    click RT "https://github.com/MichaAI/strange_hexes/tree/master/src/StrangeHexes/WTFMapGenerator/HexGenerators/RegularTilings/"
    click SRT "https://github.com/MichaAI/strange_hexes/tree/master/src/StrangeHexes/WTFMapGenerator/HexGenerators/SemiregularTiligs/"
    click TUT "https://github.com/MichaAI/strange_hexes/tree/master/src/StrangeHexes/WTFMapGenerator/HexGenerators/TwoUniformTilings/"
    click ThUT "https://github.com/MichaAI/strange_hexes/tree/master/src/StrangeHexes/WTFMapGenerator/HexGenerators/ThreeUniformTilings/"
    click BS "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/WTFMapGenerator/Shapes/BaseShape.java"
    click PB "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/WTFMapGenerator/Shapes/Polygon.java"
    click GS "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/WTFMapGenerator/GeneratedShape.java"
    click DS "https://github.com/MichaAI/strange_hexes/blob/master/src/StrangeHexes/WTFMapGenerator/Drawers.java"
```
