# ashyboxy/cart_engine architecture

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

- Interactive diagram: https://gitdiagram.com/ashyboxy/cart_engine
- Repository: https://github.com/ashyboxy/cart_engine

## Overview

##### Main Components

a) Core Components:
- Minecraft Game Core
- Cart Engine Mod Core (CartEngine.java)
- Client-Side Module (CartEngineClient.java)
- Mixin System Components

##### Architecture Representation

Top Layer (Client-Side):
- It to CartEngineClient.java component
- Client-side mixins (cart_engine.client.mixins.json)

Middle Layer (Mod Core):
- It to both client and server components

Bottom Layer (Game Modifications):
- Mixin system components:
- AbstractMinecartEntityMixin
- TestMixin
- To the vanilla Minecraft components they modify

##### Specific Elements

Use the following visual elements:

##### Key Relationships

a) Initialization Flow:
- Fabric Mod Loader → CartEngine.java
- CartEngine.java → CartEngineClient.java (client-side only)

b) Mixin Interactions:
- How AbstractMinecartEntityMixin modifies vanilla minecart behavior
- TestMixin's target and modifications

##### Configuration Elements

A section showing configuration files:
- fabric.mod.json
- cart_engine.mixins.json
- cart_engine.client.mixins.json

##### Important Details

- The separation between client and server-side code
- The mixin-based modification system
- The mod's integration points with Minecraft's core systems

##### Technical Context

Notes about:
- Fabric mod loader dependency
- Minecraft version compatibility
- Required libraries or dependencies

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client Layer"
        MC[Minecraft Client]
        CEC[Cart Engine Client]:::client
    end

    subgraph "Mod Core Layer"
        FML[Fabric Mod Loader]
        CE[Cart Engine]:::core
        FMJ[fabric.mod.json]:::config
    end

    subgraph "Mixin Layer"
        MIX[Mixin System]
        CMJ["cart_engine.mixins.json"]:::config
        CCMJ["cart_engine.client.mixins.json"]:::config
        AMEM[Abstract Minecart Entity Mixin]:::mixin
        TM[Test Mixin]:::mixin
    end

    subgraph "Minecraft Base Layer"
        MCB[Minecraft Base Game]
        ME[Minecart Entity]:::minecraft
    end

    %% Connections
    FML --> CE
    CE --> CEC
    CEC --> MC
    
    CE --> MIX
    MIX --> AMEM
    MIX --> TM
    
    AMEM -.-> ME
    TM -.-> MCB
    
    FMJ --> CE
    CMJ --> MIX
    CCMJ --> MIX

    %% Click Events
    click CE "https://github.com/AshyBoxy/cart_engine/blob/master/src/main/java/xyz/ashyboxy/mc/cart_engine/CartEngine.java"
    click CEC "https://github.com/AshyBoxy/cart_engine/blob/master/src/client/java/xyz/ashyboxy/mc/cart_engine/CartEngineClient.java"
    click AMEM "https://github.com/AshyBoxy/cart_engine/blob/master/src/main/java/xyz/ashyboxy/mc/cart_engine/mixin/AbstractMinecartEntityMixin.java"
    click TM "https://github.com/AshyBoxy/cart_engine/blob/master/src/main/java/xyz/ashyboxy/mc/cart_engine/mixin/TestMixin.java"
    click FMJ "https://github.com/AshyBoxy/cart_engine/blob/master/src/main/resources/fabric.mod.json"
    click CMJ "https://github.com/AshyBoxy/cart_engine/blob/master/src/main/resources/cart_engine.mixins.json"
    click CCMJ "https://github.com/AshyBoxy/cart_engine/blob/master/src/client/resources/cart_engine.client.mixins.json"

    %% Styling
    classDef client fill:#3498db,stroke:#2980b9,color:white
    classDef core fill:#2ecc71,stroke:#27ae60,color:white
    classDef mixin fill:#e67e22,stroke:#d35400,color:white
    classDef minecraft fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef config fill:#9b59b6,stroke:#8e44ad,color:white

    %% Legend
    subgraph Legend
        L1[Client Components]:::client
        L2[Core Components]:::core
        L3[Mixin Components]:::mixin
        L4[Minecraft Components]:::minecraft
        L5[Configuration Files]:::config
        L6["--> Direct Dependency"]
        L7["-.-> Runtime Modification"]
    end
```
