# snailperson/create-oxidised architecture

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

- Interactive diagram: https://gitdiagram.com/snailperson/create-oxidised
- Repository: https://github.com/snailperson/create-oxidised

## Overview

Create: Oxidized adds vanilla-like oxidation, waxing, scraping, and lightning cleaning to Create copper machinery. The main flow is world-driven oxidation or player treatment, through shared stage rules, into block state; placed items retain and restore those states. Loader modules adapt the shared code to Forge and NeoForge, while client model handling renders the stages. Several subsystem links are documented by the README or SOURCE INDEX; unsampled wiring is omitted or marked unverified.

Main entry points: [`forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`](https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java) (Forge entrypoint), [`neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`](https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java) (NeoForge entrypoint), [`common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java`](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java) (Stage operations), [`common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java`](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java) (Item state data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rules["Shared oxidation rules"]
  node_stage["Oxidation stages"]
  node_properties["Block properties"]
  node_manager["Stage operations"]
  node_common["Common config"]
  node_itemdata["Item state data"]
  node_mixins["Block behavior hooks"]
end

subgraph group_platforms["Loader integrations"]
  node_forge["Forge entrypoint"]
  node_forgeconfig["Forge settings<br/>[ForgeConfig.java]"]
  node_forgeadapter["Forge item adapter"]
  node_forgecreative["Forge creative tab"]
  node_neoforge["NeoForge entrypoint"]
  node_neoconfig["NeoForge settings"]
  node_neoadapter["NeoForge item adapter"]
  node_neocreative["NeoForge creative tab"]
end

subgraph group_render["Client rendering"]
  node_partialmodels["Stage partial models"]
  node_quad["Texture remapping<br/>[QuadRemapper.java]"]
  node_forgeclient["Forge client events"]
  node_neoclient["NeoForge client events"]
  node_clientmixins["Create renderer hooks"]
end

subgraph group_compat["Compatibility and content"]
  node_waxcompat["Waxed Up compatibility<br/>[WaxedUpCompat.java]"]
  node_creative["Shared tab content"]
end

node_player(("Player"))
node_world(("Minecraft world"))
node_create(("Create mod"))
node_waxedup(("Waxed Up items"))

node_player -->|"interacts"| node_forge
node_player -->|"interacts"| node_neoforge
node_forge -->|"calls treatment"| node_manager
node_neoforge -->|"calls treatment"| node_manager
node_forge -->|"checks sprays"| node_waxcompat
node_neoforge -->|"checks sprays"| node_waxcompat
node_waxedup -.->|"optional treatment"| node_forge
node_waxedup -.->|"optional treatment"| node_neoforge
node_manager -->|"checks state"| node_properties
node_manager -->|"advances stage"| node_stage
node_manager -->|"reads settings"| node_common
node_properties -->|"uses values"| node_stage
node_properties -->|"uses mod id"| node_common
node_mixins -->|"adds state"| node_properties
node_mixins -->|"queries oxidation"| node_manager
node_mixins -->|"stores block state"| node_itemdata
node_itemdata -->|"reads block values"| node_properties
node_itemdata -->|"stores stage"| node_stage
node_forge -->|"installs adapter"| node_forgeadapter
node_neoforge -->|"installs adapter"| node_neoadapter
node_forgeadapter -->|"implements storage"| node_itemdata
node_neoadapter -->|"implements storage"| node_itemdata
node_forge -->|"registers settings"| node_forgeconfig
node_forge -->|"installs config"| node_common
node_neoforge -->|"registers settings"| node_neoconfig
node_neoforge -->|"installs config"| node_common
node_forge -->|"registers tab"| node_forgecreative
node_neoforge -->|"registers tab"| node_neocreative
node_forgecreative -->|"uses content"| node_creative
node_neocreative -->|"uses content"| node_creative
node_waxcompat -->|"applies treatment"| node_manager
node_forgeclient -->|"initializes models"| node_partialmodels
node_neoclient -->|"initializes models"| node_partialmodels
node_forgeclient -->|"remaps quads"| node_quad
node_neoclient -->|"remaps quads"| node_quad
node_forgeclient -->|"reads item stage"| node_itemdata
node_neoclient -->|"reads item stage"| node_itemdata
node_clientmixins -->|"selects partials"| node_partialmodels
node_forge -.->|"extends machinery"| node_create
node_world -.->|"periodic aging"| node_manager

click node_stage "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationStage.java"
click node_properties "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationProperties.java"
click node_manager "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java"
click node_common "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/CreateOxidizedCommon.java"
click node_itemdata "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java"
click node_mixins "https://github.com/snailperson/create-oxidised/tree/main/common/src/main/java/dev/mrmulle/createoxidized/mixin"
click node_forge "https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java"
click node_forgeconfig "https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeConfig.java"
click node_forgeadapter "https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeItemDataAdapter.java"
click node_forgecreative "https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeCreativeTab.java"
click node_neoforge "https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java"
click node_neoconfig "https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeConfig.java"
click node_neoadapter "https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeItemDataAdapter.java"
click node_neocreative "https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeCreativeTab.java"
click node_waxcompat "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/WaxedUpCompat.java"
click node_creative "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/CreativeTabContent.java"
click node_partialmodels "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/client/OxidizedPartialModels.java"
click node_quad "https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/client/QuadRemapper.java"
click node_forgeclient "https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/client/ForgeClientEvents.java"
click node_neoclient "https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/client/NeoForgeClientEvents.java"
click node_clientmixins "https://github.com/snailperson/create-oxidised/tree/main/common/src/main/java/dev/mrmulle/createoxidized/mixin/client"

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_stage,node_properties,node_manager,node_common,node_itemdata,node_mixins toneBlue
class node_forge,node_forgeconfig,node_forgeadapter,node_forgecreative,node_neoforge,node_neoconfig,node_neoadapter,node_neocreative toneAmber
class node_partialmodels,node_quad,node_forgeclient,node_neoclient,node_clientmixins toneMint
class node_waxcompat,node_creative toneRose
class node_player,node_world,node_create,node_waxedup toneIndigo
```

## Components

### Shared oxidation rules

- [Oxidation stages](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationStage.java): `common/src/main/java/dev/mrmulle/createoxidized/OxidationStage.java`
- [Block properties](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationProperties.java): `common/src/main/java/dev/mrmulle/createoxidized/OxidationProperties.java`
- [Stage operations](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java): `common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java`
- [Common config](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/CreateOxidizedCommon.java): `common/src/main/java/dev/mrmulle/createoxidized/CreateOxidizedCommon.java`
- [Item state data](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java): `common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java`
- [Block behavior hooks](https://github.com/snailperson/create-oxidised/tree/main/common/src/main/java/dev/mrmulle/createoxidized/mixin): `common/src/main/java/dev/mrmulle/createoxidized/mixin`

### Loader integrations

- [Forge entrypoint](https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java): `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`
- [Forge settings](https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeConfig.java): `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeConfig.java`
- [Forge item adapter](https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeItemDataAdapter.java): `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeItemDataAdapter.java`
- [Forge creative tab](https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeCreativeTab.java): `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeCreativeTab.java`
- [NeoForge entrypoint](https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java): `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`
- [NeoForge settings](https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeConfig.java): `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeConfig.java`
- [NeoForge item adapter](https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeItemDataAdapter.java): `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeItemDataAdapter.java`
- [NeoForge creative tab](https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeCreativeTab.java): `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeCreativeTab.java`

### Client rendering

- [Stage partial models](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/client/OxidizedPartialModels.java): `common/src/main/java/dev/mrmulle/createoxidized/client/OxidizedPartialModels.java`
- [Texture remapping](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/client/QuadRemapper.java): `common/src/main/java/dev/mrmulle/createoxidized/client/QuadRemapper.java`
- [Forge client events](https://github.com/snailperson/create-oxidised/blob/main/forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/client/ForgeClientEvents.java): `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/client/ForgeClientEvents.java`
- [NeoForge client events](https://github.com/snailperson/create-oxidised/blob/main/neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/client/NeoForgeClientEvents.java): `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/client/NeoForgeClientEvents.java`
- [Create renderer hooks](https://github.com/snailperson/create-oxidised/tree/main/common/src/main/java/dev/mrmulle/createoxidized/mixin/client): `common/src/main/java/dev/mrmulle/createoxidized/mixin/client`

### Compatibility and content

- [Waxed Up compatibility](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/WaxedUpCompat.java): `common/src/main/java/dev/mrmulle/createoxidized/WaxedUpCompat.java`
- [Shared tab content](https://github.com/snailperson/create-oxidised/blob/main/common/src/main/java/dev/mrmulle/createoxidized/CreativeTabContent.java): `common/src/main/java/dev/mrmulle/createoxidized/CreativeTabContent.java`

### Other components

- **Player**
- **Minecraft world**
- **Create mod**
- **Waxed Up items**

## Connections

- Player → Forge entrypoint: interacts (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- Player → NeoForge entrypoint: interacts (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- Forge entrypoint → Stage operations: calls treatment (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- NeoForge entrypoint → Stage operations: calls treatment (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- Forge entrypoint → Waxed Up compatibility: checks sprays (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- NeoForge entrypoint → Waxed Up compatibility: checks sprays (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- Waxed Up items → Forge entrypoint: optional treatment
- Waxed Up items → NeoForge entrypoint: optional treatment
- Stage operations → Block properties: checks state (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java`)
- Stage operations → Oxidation stages: advances stage (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java`)
- Stage operations → Common config: reads settings (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationManager.java`)
- Block properties → Oxidation stages: uses values (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationProperties.java`)
- Block properties → Common config: uses mod id (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationProperties.java`)
- Block behavior hooks → Block properties: adds state (evidence: `common/src/main/java/dev/mrmulle/createoxidized/mixin/StateDefinitionBuilderMixin.java`)
- Block behavior hooks → Stage operations: queries oxidation (evidence: `common/src/main/java/dev/mrmulle/createoxidized/mixin/BlockStateBaseMixin.java`)
- Block behavior hooks → Item state data: stores block state (evidence: `common/src/main/java/dev/mrmulle/createoxidized/mixin/BlockItemMixin.java`)
- Item state data → Block properties: reads block values (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java`)
- Item state data → Oxidation stages: stores stage (evidence: `common/src/main/java/dev/mrmulle/createoxidized/OxidationItemData.java`)
- Forge entrypoint → Forge item adapter: installs adapter (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- NeoForge entrypoint → NeoForge item adapter: installs adapter (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- Forge item adapter → Item state data: implements storage (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeItemDataAdapter.java`)
- NeoForge item adapter → Item state data: implements storage (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeItemDataAdapter.java`)
- Forge entrypoint → Forge settings: registers settings (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- Forge entrypoint → Common config: installs config (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- NeoForge entrypoint → NeoForge settings: registers settings (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- NeoForge entrypoint → Common config: installs config (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- Forge entrypoint → Forge creative tab: registers tab (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/CreateOxidizedForge.java`)
- NeoForge entrypoint → NeoForge creative tab: registers tab (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/CreateOxidizedNeoForge.java`)
- Forge creative tab → Shared tab content: uses content (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/ForgeCreativeTab.java`)
- NeoForge creative tab → Shared tab content: uses content (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/NeoForgeCreativeTab.java`)
- Waxed Up compatibility → Stage operations: applies treatment (evidence: `common/src/main/java/dev/mrmulle/createoxidized/WaxedUpCompat.java`)
- Forge client events → Stage partial models: initializes models (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/client/ForgeClientEvents.java`)
- NeoForge client events → Stage partial models: initializes models (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/client/NeoForgeClientEvents.java`)
- Forge client events → Texture remapping: remaps quads (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/client/ForgeClientEvents.java`)
- NeoForge client events → Texture remapping: remaps quads (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/client/NeoForgeClientEvents.java`)
- Forge client events → Item state data: reads item stage (evidence: `forge-1.20.1/src/main/java/dev/mrmulle/createoxidized/forge/client/ForgeClientEvents.java`)
- NeoForge client events → Item state data: reads item stage (evidence: `neoforge-1.21.1/src/main/java/dev/mrmulle/createoxidized/neoforge/client/NeoForgeClientEvents.java`)
- Create renderer hooks → Stage partial models: selects partials (evidence: `common/src/main/java/dev/mrmulle/createoxidized/mixin/client/FluidTankRendererMixin.java`)
- Forge entrypoint → Create mod: extends machinery
- Minecraft world → Stage operations: periodic aging
