# chasmlol/skycraft architecture

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

- Interactive diagram: https://gitdiagram.com/chasmlol/skycraft
- Repository: https://github.com/chasmlol/skycraft

## Overview

SkyCraft bridges Minecraft and Skyrim rather than replacing either game. Minecraft supplies player physics, inventory, blocks, and multiplayer; the Fabric client synchronizes player state and Skyrim geometry over shared memory, while the SKSE plugin applies movement, collision, digging, combat, and rendering inside Skyrim. The principal loop is Minecraft play → shared-state exchange → Skyrim world interaction and rendering. The README documents capabilities whose detailed implementation was not sampled; those links are shown at product level rather than as claims about specific internal calls.

Main entry points: [`fabric/src/client/java/dev/skycraft/client/SkyClient.java`](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyClient.java) (Player Sync), [`fabric/src/main/java/dev/skycraft/link/SkyLink.java`](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/link/SkyLink.java) (Shared Memory Link), [`skse/src/Game.cpp`](https://github.com/chasmlol/skycraft/blob/main/skse/src/Game.cpp) (Game Runtime), [`fabric/src/main/java/dev/skycraft/world/SkyCollision.java`](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/world/SkyCollision.java) (Collision Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fabric_client["Fabric Client"]
  node_client_lifecycle["Client Lifecycle"]
  node_client_sync["Player Sync<br/>[SkyClient.java]"]
  node_input["Input Bridge<br/>[InputBridge.java]"]
  node_client_dig["Dig Client<br/>[SkyDigClient.java]"]
  node_world_export["World Export<br/>[WorldExporter.java]"]
  node_avatar_export["Avatar Export"]
end

subgraph group_fabric_gameplay["Minecraft Gameplay"]
  node_mirror["Mirror World<br/>[MirrorWorld.java]"]
  node_collision["Collision Model<br/>[SkyCollision.java]"]
  node_dig["Dig World<br/>[SkyDig.java]"]
  node_combat["Combat Proxies<br/>[SkyCombat.java]"]
  node_network["Multiplayer Network<br/>[SkyNet.java]"]
end

subgraph group_shared_bridge["Shared Bridge"]
  node_protocol["Shared Protocol"]
  node_link["Shared Memory Link<br/>[SkyLink.java]"]
end

subgraph group_skyrim_plugin["Skyrim Plugin"]
  node_skyrim_game["Game Runtime<br/>[Game.cpp]"]
  node_skyrim_collision["Skyrim Collision<br/>[Collision.cpp]"]
  node_skyrim_dig["Skyrim Digging<br/>[Dig.h]"]
  node_skyrim_combat["Skyrim Combat<br/>[Combat.cpp]"]
  node_skyrim_render["Skyrim Rendering<br/>[WorldRender.cpp]"]
  node_launcher["Minecraft Launcher<br/>[Game.h]"]
end

node_player(("Minecraft Player"))
node_skyrim(("Skyrim World"))

node_player -->|"drives state"| node_client_sync
node_client_sync -->|"writes state"| node_link
node_link -->|"exchanges state"| node_skyrim_game
node_skyrim_game -->|"drives player"| node_skyrim
node_client_lifecycle -->|"coordinates"| node_client_sync
node_client_lifecycle -->|"initializes"| node_network
node_client_sync -->|"uses collision"| node_collision
node_client_sync -->|"routes input"| node_input
node_client_dig -->|"sends dig events"| node_network
node_client_dig -->|"invalidates regions"| node_world_export
node_world_export -->|"uses exporter"| node_avatar_export
node_world_export -->|"provides scene data"| node_skyrim_render
node_mirror -->|"opens world"| node_client_lifecycle
node_collision -->|"reads collision feed"| node_link
node_dig -->|"sends dug cells"| node_skyrim_dig
node_dig -->|"accounts for holes"| node_collision
node_combat -->|"reads actor state"| node_link
node_skyrim_combat -->|"applies combat"| node_skyrim_game
node_network -->|"relays combat events"| node_combat
node_protocol -->|"defines layout"| node_link
node_launcher -->|"starts Minecraft"| node_player
node_skyrim -->|"supplies terrain"| node_skyrim_collision
node_skyrim_collision -->|"exports geometry"| node_collision
node_skyrim -->|"accepts destruction"| node_skyrim_dig
node_skyrim_game -->|"hosts rendering"| node_skyrim_render
node_player -->|"joins shared world"| node_network

click node_client_lifecycle "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyCraftClient.java"
click node_client_sync "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyClient.java"
click node_input "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/InputBridge.java"
click node_client_dig "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyDigClient.java"
click node_world_export "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/render/WorldExporter.java"
click node_avatar_export "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/render/AvatarExporter.java"
click node_mirror "https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/MirrorWorld.java"
click node_collision "https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/world/SkyCollision.java"
click node_dig "https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/world/SkyDig.java"
click node_combat "https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/combat/SkyCombat.java"
click node_network "https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/net/SkyNet.java"
click node_protocol "https://github.com/chasmlol/skycraft/blob/main/protocol/skycraft_protocol.h"
click node_link "https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/link/SkyLink.java"
click node_skyrim_game "https://github.com/chasmlol/skycraft/blob/main/skse/src/Game.cpp"
click node_skyrim_collision "https://github.com/chasmlol/skycraft/blob/main/skse/src/Collision.cpp"
click node_skyrim_dig "https://github.com/chasmlol/skycraft/blob/main/skse/src/Dig.h"
click node_skyrim_combat "https://github.com/chasmlol/skycraft/blob/main/skse/src/Combat.cpp"
click node_skyrim_render "https://github.com/chasmlol/skycraft/blob/main/skse/src/WorldRender.cpp"
click node_launcher "https://github.com/chasmlol/skycraft/blob/main/skse/src/Game.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client_lifecycle,node_client_sync,node_input,node_client_dig,node_world_export,node_avatar_export toneBlue
class node_mirror,node_collision,node_dig,node_combat,node_network toneAmber
class node_protocol,node_link toneMint
class node_skyrim_game,node_skyrim_collision,node_skyrim_dig,node_skyrim_combat,node_skyrim_render,node_launcher toneRose
class node_player,node_skyrim toneIndigo
```

## Components

### Fabric Client

- [Client Lifecycle](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyCraftClient.java): `fabric/src/client/java/dev/skycraft/client/SkyCraftClient.java`
- [Player Sync](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyClient.java): `fabric/src/client/java/dev/skycraft/client/SkyClient.java`
- [Input Bridge](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/InputBridge.java): `fabric/src/client/java/dev/skycraft/client/InputBridge.java`
- [Dig Client](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/SkyDigClient.java): `fabric/src/client/java/dev/skycraft/client/SkyDigClient.java`
- [World Export](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/render/WorldExporter.java): `fabric/src/client/java/dev/skycraft/client/render/WorldExporter.java`
- [Avatar Export](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/render/AvatarExporter.java): `fabric/src/client/java/dev/skycraft/client/render/AvatarExporter.java`

### Minecraft Gameplay

- [Mirror World](https://github.com/chasmlol/skycraft/blob/main/fabric/src/client/java/dev/skycraft/client/MirrorWorld.java): `fabric/src/client/java/dev/skycraft/client/MirrorWorld.java`
- [Collision Model](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/world/SkyCollision.java): `fabric/src/main/java/dev/skycraft/world/SkyCollision.java`
- [Dig World](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/world/SkyDig.java): `fabric/src/main/java/dev/skycraft/world/SkyDig.java`
- [Combat Proxies](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/combat/SkyCombat.java): `fabric/src/main/java/dev/skycraft/combat/SkyCombat.java`
- [Multiplayer Network](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/net/SkyNet.java): `fabric/src/main/java/dev/skycraft/net/SkyNet.java`

### Shared Bridge

- [Shared Protocol](https://github.com/chasmlol/skycraft/blob/main/protocol/skycraft_protocol.h): `protocol/skycraft_protocol.h`
- [Shared Memory Link](https://github.com/chasmlol/skycraft/blob/main/fabric/src/main/java/dev/skycraft/link/SkyLink.java): `fabric/src/main/java/dev/skycraft/link/SkyLink.java`

### Skyrim Plugin

- [Game Runtime](https://github.com/chasmlol/skycraft/blob/main/skse/src/Game.cpp): `skse/src/Game.cpp`
- [Skyrim Collision](https://github.com/chasmlol/skycraft/blob/main/skse/src/Collision.cpp): `skse/src/Collision.cpp`
- [Skyrim Digging](https://github.com/chasmlol/skycraft/blob/main/skse/src/Dig.h): `skse/src/Dig.h`
- [Skyrim Combat](https://github.com/chasmlol/skycraft/blob/main/skse/src/Combat.cpp): `skse/src/Combat.cpp`
- [Skyrim Rendering](https://github.com/chasmlol/skycraft/blob/main/skse/src/WorldRender.cpp): `skse/src/WorldRender.cpp`
- [Minecraft Launcher](https://github.com/chasmlol/skycraft/blob/main/skse/src/Game.h): `skse/src/Game.h`

### Other components

- **Minecraft Player**
- **Skyrim World**

## Connections

- Minecraft Player → Player Sync: drives state
- Player Sync → Shared Memory Link: writes state (evidence: `fabric/src/client/java/dev/skycraft/client/SkyClient.java`)
- Shared Memory Link → Game Runtime: exchanges state
- Game Runtime → Skyrim World: drives player
- Client Lifecycle → Player Sync: coordinates (evidence: `fabric/src/client/java/dev/skycraft/client/SkyCraftClient.java`)
- Client Lifecycle → Multiplayer Network: initializes (evidence: `fabric/src/client/java/dev/skycraft/client/SkyCraftClient.java`)
- Player Sync → Collision Model: uses collision (evidence: `fabric/src/client/java/dev/skycraft/client/SkyClient.java`)
- Player Sync → Input Bridge: routes input (evidence: `fabric/src/client/java/dev/skycraft/client/SkyClient.java`)
- Dig Client → Multiplayer Network: sends dig events (evidence: `fabric/src/client/java/dev/skycraft/client/SkyDigClient.java`)
- Dig Client → World Export: invalidates regions (evidence: `fabric/src/client/java/dev/skycraft/client/SkyDigClient.java`)
- World Export → Avatar Export: uses exporter (evidence: `fabric/src/client/java/dev/skycraft/client/render/WorldExporter.java`)
- World Export → Skyrim Rendering: provides scene data
- Mirror World → Client Lifecycle: opens world (evidence: `fabric/src/client/java/dev/skycraft/client/SkyCraftClient.java`)
- Collision Model → Shared Memory Link: reads collision feed (evidence: `fabric/src/main/java/dev/skycraft/world/SkyCollision.java`)
- Dig World → Skyrim Digging: sends dug cells (evidence: `skse/src/Dig.h`)
- Dig World → Collision Model: accounts for holes (evidence: `fabric/src/main/java/dev/skycraft/world/SkyDig.java`)
- Combat Proxies → Shared Memory Link: reads actor state (evidence: `fabric/src/main/java/dev/skycraft/combat/SkyCombat.java`)
- Skyrim Combat → Game Runtime: applies combat (evidence: `skse/src/Combat.cpp`)
- Multiplayer Network → Combat Proxies: relays combat events (evidence: `fabric/src/main/java/dev/skycraft/net/SkyNet.java`)
- Shared Protocol → Shared Memory Link: defines layout
- Minecraft Launcher → Minecraft Player: starts Minecraft
- Skyrim World → Skyrim Collision: supplies terrain
- Skyrim Collision → Collision Model: exports geometry
- Skyrim World → Skyrim Digging: accepts destruction
- Game Runtime → Skyrim Rendering: hosts rendering
- Minecraft Player → Multiplayer Network: joins shared world
