# chemiofitor4096/protectionengineering architecture

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

- Interactive diagram: https://gitdiagram.com/chemiofitor4096/protectionengineering
- Repository: https://github.com/chemiofitor4096/protectionengineering

## Overview

Protection Engineering is a NeoForge Minecraft mod centered on engineer armor with installable, slot-specific attachments. Players equip armor, configure it at the workbench, then use passive protections and hotkey-triggered abilities in play; a Create-linked emitter automates equipping. The graph preserves the documented armor, attachment, combat, repair, HUD, and compatibility branches. Source excerpts show the mod bootstrap, attachment-host behavior, selected items, and registries; links for unsampled subsystems rely on README documentation or are omitted where wiring is not evidenced.

Main entry points: [`src/main/java/com/chemiofitor/protection_engineering/item/AttachmentHostArmorItem.java`](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/AttachmentHostArmorItem.java) (Engineer Armor), [`src/main/java/com/chemiofitor/protection_engineering/item/AttachmentItem.java`](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/AttachmentItem.java) (Attachment Catalog), [`src/main/java/com/chemiofitor/protection_engineering/block/ArmorEmitterBlock.java`](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/block/ArmorEmitterBlock.java) (Armor Emitter), [`src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java`](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java) (Content Registries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_armor["Armor and Attachments"]
  node_attachment_api["Attachment API<br/>[IAttachment.java]"]
  node_attachment_data["Installed Slot Data"]
  node_slot_types["Attachment Slots<br/>[SlotType.java]"]
  node_armor_items["Engineer Armor"]
  node_attachment_items["Attachment Catalog"]
end

subgraph group_gameplay["Gameplay Systems"]
  node_workbench["Modification Workbench<br/>[WorkbenchMenu.java]"]
  node_emitter["Armor Emitter"]
  node_abilities["Armor Abilities<br/>[JetpackItem.java]"]
  node_projectiles["Missile and Rocket Combat<br/>[MissileEntity.java]"]
  node_repair["Graded Repair<br/>[IGradedRepair.java]"]
end

subgraph group_interface["Client Experience"]
  node_hud["Status HUD"]
  node_client_rendering["Armor and Attachment Rendering<br/>[PEArmorLayer.java]"]
  node_client_controls["Hotkeys and Overlays<br/>[PEKeyBindings.java]"]
end

subgraph group_platform["Mod Foundation"]
  node_repair_materials["Repair Materials"]
  node_network["Ability Network Payloads"]
  node_events["Gameplay Events"]
  node_registry["Content Registries<br/>[PEItems.java]"]
  node_configuration["Server Configuration"]
  node_compatibility["Mod Compatibility<br/>[IronCompat.java]"]
end

node_player(("Player"))
node_create{{"Create Mod"}}

node_player -->|"installs or removes"| node_workbench
node_workbench -->|"modifies armor"| node_armor_items
node_armor_items -->|"stores attachments"| node_attachment_data
node_armor_items -->|"declares supported slots"| node_slot_types
node_attachment_items -->|"implements"| node_attachment_api
node_attachment_api -->|"declares compatible slots"| node_slot_types
node_player -->|"stands on"| node_emitter
node_emitter -->|"automates equipping"| node_armor_items
node_player -->|"activates abilities"| node_abilities
node_abilities -.->|"fires projectiles"| node_projectiles
node_player -->|"repairs equipment"| node_repair
node_repair -->|"checks repair strength"| node_repair_materials
node_repair_materials -->|"reads configured values"| node_configuration
node_player -->|"uses hotkeys"| node_client_controls
node_client_controls -.->|"sends ability actions"| node_network
node_player -->|"views status"| node_hud
node_armor_items -.->|"renders equipped armor"| node_client_rendering
node_registry -->|"registers armor items"| node_armor_items
node_registry -->|"registers attachments"| node_attachment_items
node_create -->|"provides arm interaction"| node_emitter
node_create -->|"integrates goggles"| node_attachment_items
node_events -.->|"registers optional integrations"| node_compatibility

click node_attachment_api "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/IAttachment.java"
click node_attachment_data "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/AttachmentsData.java"
click node_slot_types "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/SlotType.java"
click node_armor_items "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/AttachmentHostArmorItem.java"
click node_attachment_items "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/AttachmentItem.java"
click node_workbench "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/menu/WorkbenchMenu.java"
click node_emitter "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/block/ArmorEmitterBlock.java"
click node_abilities "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/JetpackItem.java"
click node_projectiles "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/entity/MissileEntity.java"
click node_repair "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/IGradedRepair.java"
click node_repair_materials "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/registry/PERepairMaterials.java"
click node_hud "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/client/PECooldownOverlay.java"
click node_client_rendering "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/client/layer/PEArmorLayer.java"
click node_client_controls "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/client/PEKeyBindings.java"
click node_network "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/network/ToggleAttachmentPayload.java"
click node_events "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/event/PENeoForgeEvents.java"
click node_registry "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java"
click node_configuration "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/config/PEServerConfig.java"
click node_compatibility "https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/compat/iron/IronCompat.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_attachment_api,node_attachment_data,node_slot_types,node_armor_items,node_attachment_items toneBlue
class node_workbench,node_emitter,node_abilities,node_projectiles,node_repair toneAmber
class node_hud,node_client_rendering,node_client_controls toneMint
class node_repair_materials,node_network,node_events,node_registry,node_configuration,node_compatibility toneRose
class node_player,node_create toneIndigo
```

## Components

### Armor and Attachments

- [Attachment API](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/IAttachment.java): `src/main/java/com/chemiofitor/protection_engineering/api/IAttachment.java`
- [Installed Slot Data](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/AttachmentsData.java): `src/main/java/com/chemiofitor/protection_engineering/api/AttachmentsData.java`
- [Attachment Slots](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/SlotType.java): `src/main/java/com/chemiofitor/protection_engineering/api/SlotType.java`
- [Engineer Armor](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/AttachmentHostArmorItem.java): `src/main/java/com/chemiofitor/protection_engineering/item/AttachmentHostArmorItem.java`
- [Attachment Catalog](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/AttachmentItem.java): `src/main/java/com/chemiofitor/protection_engineering/item/AttachmentItem.java`

### Gameplay Systems

- [Modification Workbench](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/menu/WorkbenchMenu.java): `src/main/java/com/chemiofitor/protection_engineering/menu/WorkbenchMenu.java`
- [Armor Emitter](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/block/ArmorEmitterBlock.java): `src/main/java/com/chemiofitor/protection_engineering/block/ArmorEmitterBlock.java`
- [Armor Abilities](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/item/JetpackItem.java): `src/main/java/com/chemiofitor/protection_engineering/item/JetpackItem.java`
- [Missile and Rocket Combat](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/entity/MissileEntity.java): `src/main/java/com/chemiofitor/protection_engineering/entity/MissileEntity.java`
- [Graded Repair](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/api/IGradedRepair.java): `src/main/java/com/chemiofitor/protection_engineering/api/IGradedRepair.java`

### Client Experience

- [Status HUD](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/client/PECooldownOverlay.java): `src/main/java/com/chemiofitor/protection_engineering/client/PECooldownOverlay.java`
- [Armor and Attachment Rendering](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/client/layer/PEArmorLayer.java): `src/main/java/com/chemiofitor/protection_engineering/client/layer/PEArmorLayer.java`
- [Hotkeys and Overlays](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/client/PEKeyBindings.java): `src/main/java/com/chemiofitor/protection_engineering/client/PEKeyBindings.java`

### Mod Foundation

- [Repair Materials](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/registry/PERepairMaterials.java): `src/main/java/com/chemiofitor/protection_engineering/registry/PERepairMaterials.java`
- [Ability Network Payloads](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/network/ToggleAttachmentPayload.java): `src/main/java/com/chemiofitor/protection_engineering/network/ToggleAttachmentPayload.java`
- [Gameplay Events](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/event/PENeoForgeEvents.java): `src/main/java/com/chemiofitor/protection_engineering/event/PENeoForgeEvents.java`
- [Content Registries](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java): `src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java`
- [Server Configuration](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/config/PEServerConfig.java): `src/main/java/com/chemiofitor/protection_engineering/config/PEServerConfig.java`
- [Mod Compatibility](https://github.com/chemiofitor4096/protectionengineering/blob/neoforge-1.21.1-dev/src/main/java/com/chemiofitor/protection_engineering/compat/iron/IronCompat.java): `src/main/java/com/chemiofitor/protection_engineering/compat/iron/IronCompat.java`

### Other components

- **Player**
- **Create Mod**

## Connections

- Player → Modification Workbench: installs or removes
- Modification Workbench → Engineer Armor: modifies armor
- Engineer Armor → Installed Slot Data: stores attachments (evidence: `src/main/java/com/chemiofitor/protection_engineering/item/AttachmentHostArmorItem.java`)
- Engineer Armor → Attachment Slots: declares supported slots (evidence: `src/main/java/com/chemiofitor/protection_engineering/item/EngineerChestplateItem.java`)
- Attachment Catalog → Attachment API: implements (evidence: `src/main/java/com/chemiofitor/protection_engineering/item/AttachmentItem.java`)
- Attachment API → Attachment Slots: declares compatible slots
- Player → Armor Emitter: stands on
- Armor Emitter → Engineer Armor: automates equipping
- Player → Armor Abilities: activates abilities
- Armor Abilities → Missile and Rocket Combat: fires projectiles
- Player → Graded Repair: repairs equipment
- Graded Repair → Repair Materials: checks repair strength (evidence: `src/main/java/com/chemiofitor/protection_engineering/api/IGradedRepair.java`)
- Repair Materials → Server Configuration: reads configured values (evidence: `src/main/java/com/chemiofitor/protection_engineering/registry/PERepairMaterials.java`)
- Player → Hotkeys and Overlays: uses hotkeys
- Hotkeys and Overlays → Ability Network Payloads: sends ability actions
- Player → Status HUD: views status
- Engineer Armor → Armor and Attachment Rendering: renders equipped armor
- Content Registries → Engineer Armor: registers armor items (evidence: `src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java`)
- Content Registries → Attachment Catalog: registers attachments (evidence: `src/main/java/com/chemiofitor/protection_engineering/registry/PEItems.java`)
- Create Mod → Armor Emitter: provides arm interaction
- Create Mod → Attachment Catalog: integrates goggles
- Gameplay Events → Mod Compatibility: registers optional integrations
