# mikikox1/mielons-the-sift-neoforge-port architecture

> Architecture diagram of the GitHub repository mikikox1/mielons-the-sift-neoforge-port, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mikikox1/mielons-the-sift-neoforge-port
- Repository: https://github.com/mikikox1/mielons-the-sift-neoforge-port

## Overview

The Sift is a NeoForge Minecraft content mod centered on exploring its custom dimension, entering it through an Ancient City melody portal, and encountering its creatures, resources, and structures. The map also preserves major documented gameplay branches: rift travel, Monarch progression, Ichor effects, and client-side atmosphere and rendering. Source excerpts directly show registration, teleport handling, persisted travel data, and client transition behavior; other feature links are documented in the README, so unsampled implementation details are not inferred.

Main entry points: [`src/main/java/mielon/thesift/worldgen`](https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/worldgen) (Sift dimension), [`src/main/java/mielon/thesift/TheSiftMod.java`](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/TheSiftMod.java) (Mod initialization), [`src/main/java/mielon/thesift/world/RiftManager.java`](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/RiftManager.java) (Rift manager), [`src/main/java/mielon/thesift/portal`](https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/portal) (Sonorous portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Portal entry"]
  node_singer["Singer<br/>[SingerEntity.java]"]
  node_sonorous["Sonorous portal"]
end

subgraph group_world["Sift world"]
  node_dimension["Sift dimension"]
  node_blocks["Blocks and flora<br/>[ModBlocks.java]"]
  node_ichor["Ichor system"]
  node_biomes["Biomes and generation"]
end

subgraph group_gameplay["Creatures and progression"]
  node_items["Items and equipment<br/>[ModItems.java]"]
  node_entities["Entity registry<br/>[ModEntities.java]"]
  node_wildlife["Sifters and wildlife<br/>[BlubEntity.java]"]
  node_monarch["Monarch progression<br/>[MonarchRitual.java]"]
  node_advancements["Advancements"]
  node_registration["Content registration"]
  node_mod["Mod initialization<br/>[TheSiftMod.java]"]
end

subgraph group_travel["Portal travel"]
  node_rift["Rift manager<br/>[RiftManager.java]"]
  node_teleport["Teleport manager"]
  node_storage[("World travel storage")]
end

subgraph group_client["Client presentation"]
  node_loading["Transition screen"]
  node_client["Client render setup<br/>[TheSiftClient.java]"]
  node_shader["Shader compatibility"]
end

node_player(("Player"))

node_player -->|"awakens"| node_singer
node_singer -->|"awakens blocks"| node_sonorous
node_player -->|"plays melody"| node_sonorous
node_sonorous -->|"opens entry"| node_dimension
node_dimension -->|"contains"| node_biomes
node_dimension -->|"features"| node_blocks
node_dimension -->|"contains"| node_ichor
node_dimension -->|"inhabited by"| node_wildlife
node_player -->|"exposed to"| node_ichor
node_player -->|"summons"| node_monarch
node_monarch -->|"rewards"| node_items
node_items -.->|"supports progression"| node_advancements
node_player -->|"travels through"| node_rift
node_rift -->|"queues travel"| node_teleport
node_teleport -->|"saves return points"| node_storage
node_rift -->|"reads routes"| node_storage
node_rift -->|"sends transition payload"| node_loading
node_loading -->|"checks portal contact"| node_teleport
node_client -->|"initializes"| node_shader
node_mod -->|"registers content"| node_registration
node_mod -->|"bootstraps"| node_blocks
node_mod -->|"initializes"| node_entities
node_mod -->|"bootstraps"| node_items

click node_singer "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/SingerEntity.java"
click node_sonorous "https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/portal"
click node_dimension "https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/worldgen"
click node_blocks "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/block/ModBlocks.java"
click node_ichor "https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/fluid"
click node_biomes "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/worldgen/SiftSurfaceBiomeManager.java"
click node_items "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/item/ModItems.java"
click node_entities "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/ModEntities.java"
click node_wildlife "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/BlubEntity.java"
click node_monarch "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/MonarchRitual.java"
click node_advancements "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/advancement/ModAdvancements.java"
click node_rift "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/RiftManager.java"
click node_teleport "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/SiftTeleportManager.java"
click node_storage "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/SiftWorldStorage.java"
click node_loading "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/client/java/mielon/thesift/client/loading/SiftClientPortalTransition.java"
click node_client "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/client/java/mielon/thesift/client/TheSiftClient.java"
click node_shader "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/client/java/mielon/thesift/client/compat/SiftShaderCompat.java"
click node_registration "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/platform/ModRegistration.java"
click node_mod "https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/TheSiftMod.java"

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_singer,node_sonorous toneBlue
class node_dimension,node_blocks,node_ichor,node_biomes toneAmber
class node_items,node_entities,node_wildlife,node_monarch,node_advancements,node_registration,node_mod toneMint
class node_rift,node_teleport,node_storage toneRose
class node_loading,node_client,node_shader,node_player toneIndigo
```

## Components

### Portal entry

- [Singer](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/SingerEntity.java): `src/main/java/mielon/thesift/entity/SingerEntity.java`
- [Sonorous portal](https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/portal): `src/main/java/mielon/thesift/portal`

### Sift world

- [Sift dimension](https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/worldgen): `src/main/java/mielon/thesift/worldgen`
- [Blocks and flora](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/block/ModBlocks.java): `src/main/java/mielon/thesift/block/ModBlocks.java`
- [Ichor system](https://github.com/mikikox1/mielons-the-sift-neoforge-port/tree/main/src/main/java/mielon/thesift/fluid): `src/main/java/mielon/thesift/fluid`
- [Biomes and generation](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/worldgen/SiftSurfaceBiomeManager.java): `src/main/java/mielon/thesift/worldgen/SiftSurfaceBiomeManager.java`

### Creatures and progression

- [Items and equipment](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/item/ModItems.java): `src/main/java/mielon/thesift/item/ModItems.java`
- [Entity registry](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/ModEntities.java): `src/main/java/mielon/thesift/entity/ModEntities.java`
- [Sifters and wildlife](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/BlubEntity.java): `src/main/java/mielon/thesift/entity/BlubEntity.java`
- [Monarch progression](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/entity/MonarchRitual.java): `src/main/java/mielon/thesift/entity/MonarchRitual.java`
- [Advancements](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/advancement/ModAdvancements.java): `src/main/java/mielon/thesift/advancement/ModAdvancements.java`
- [Content registration](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/platform/ModRegistration.java): `src/main/java/mielon/thesift/platform/ModRegistration.java`
- [Mod initialization](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/TheSiftMod.java): `src/main/java/mielon/thesift/TheSiftMod.java`

### Portal travel

- [Rift manager](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/RiftManager.java): `src/main/java/mielon/thesift/world/RiftManager.java`
- [Teleport manager](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/SiftTeleportManager.java): `src/main/java/mielon/thesift/world/SiftTeleportManager.java`
- [World travel storage](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/main/java/mielon/thesift/world/SiftWorldStorage.java): `src/main/java/mielon/thesift/world/SiftWorldStorage.java`

### Client presentation

- [Transition screen](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/client/java/mielon/thesift/client/loading/SiftClientPortalTransition.java): `src/client/java/mielon/thesift/client/loading/SiftClientPortalTransition.java`
- [Client render setup](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/client/java/mielon/thesift/client/TheSiftClient.java): `src/client/java/mielon/thesift/client/TheSiftClient.java`
- [Shader compatibility](https://github.com/mikikox1/mielons-the-sift-neoforge-port/blob/main/src/client/java/mielon/thesift/client/compat/SiftShaderCompat.java): `src/client/java/mielon/thesift/client/compat/SiftShaderCompat.java`

### Other components

- **Player**

## Connections

- Player → Singer: awakens
- Singer → Sonorous portal: awakens blocks
- Player → Sonorous portal: plays melody
- Sonorous portal → Sift dimension: opens entry
- Sift dimension → Biomes and generation: contains (evidence: `src/main/java/mielon/thesift/worldgen/SiftSurfaceBiomeManager.java`)
- Sift dimension → Blocks and flora: features
- Sift dimension → Ichor system: contains
- Sift dimension → Sifters and wildlife: inhabited by
- Player → Ichor system: exposed to
- Player → Monarch progression: summons
- Monarch progression → Items and equipment: rewards
- Items and equipment → Advancements: supports progression (evidence: `src/main/java/mielon/thesift/advancement/ModAdvancements.java`)
- Player → Rift manager: travels through
- Rift manager → Teleport manager: queues travel (evidence: `src/main/java/mielon/thesift/world/RiftManager.java`)
- Teleport manager → World travel storage: saves return points (evidence: `src/main/java/mielon/thesift/world/SiftTeleportManager.java`)
- Rift manager → World travel storage: reads routes (evidence: `src/main/java/mielon/thesift/world/RiftManager.java`)
- Rift manager → Transition screen: sends transition payload (evidence: `src/main/java/mielon/thesift/world/RiftManager.java`)
- Transition screen → Teleport manager: checks portal contact (evidence: `src/client/java/mielon/thesift/client/loading/SiftClientPortalTransition.java`)
- Client render setup → Shader compatibility: initializes (evidence: `src/client/java/mielon/thesift/client/TheSiftClient.java`)
- Mod initialization → Content registration: registers content (evidence: `src/main/java/mielon/thesift/TheSiftMod.java`)
- Mod initialization → Blocks and flora: bootstraps (evidence: `src/main/java/mielon/thesift/TheSiftMod.java`)
- Mod initialization → Entity registry: initializes (evidence: `src/main/java/mielon/thesift/TheSiftMod.java`)
- Mod initialization → Items and equipment: bootstraps (evidence: `src/main/java/mielon/thesift/TheSiftMod.java`)