# megasush1/kangal-chunk-protector architecture

> Architecture diagram of the GitHub repository megasush1/kangal-chunk-protector, 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/megasush1/kangal-chunk-protector
- Repository: https://github.com/megasush1/kangal-chunk-protector

## Overview

This Fabric mod protects server chunks through owner-level commands and gameplay checks. Players add, remove, or list protected chunks; command and event handlers consult shared protection rules, while mixins guard block placement, bucket use, pistons, and explosions. Protection state is stored per dimension in Minecraft saved data. The sampled sources show these calls, but the README provides no additional product capabilities; the client entrypoint is empty. Bypass currently returns false. External game dispatch is shown by the event registrations and mixin injections.

Main entry points: [`src/main/java/kangal/chunk_protector/protection/ProtectedChunkManager.java`](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectedChunkManager.java) (Chunk manager), [`src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java`](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java) (Protection commands), [`src/main/java/kangal/chunk_protector/protection/ProtectionUtils.java`](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionUtils.java) (Protection rules), [`src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java`](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java) (Protection events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Mod entrypoints"]
  node_initializer["Mod initializer"]
  node_commands["Protection commands"]
end

subgraph group_rules["Protection rules"]
  node_utils["Protection rules"]
end

subgraph group_guards["Gameplay guards"]
  node_events["Protection events"]
  node_block["Block placement"]
  node_bucket["Bucket use"]
  node_piston["Piston movement<br/>[PistonMixin.java]"]
  node_explosion["Explosion filtering"]
end

subgraph group_state["Protection state"]
  node_manager["Chunk manager"]
  node_saveddata[("Saved protection data")]
end

node_players(("Server players"))
node_minecraft["Minecraft runtime"]

node_initializer -->|"registers"| node_events
node_initializer -->|"registers"| node_commands
node_players -->|"invoke"| node_commands
node_commands -->|"manage chunks"| node_manager
node_events -->|"check actions"| node_utils
node_block -->|"check placement"| node_utils
node_bucket -->|"check target"| node_manager
node_piston -->|"check chunks"| node_manager
node_explosion -->|"filter positions"| node_manager
node_utils -->|"check protection"| node_manager
node_manager -->|"read and write"| node_saveddata
node_minecraft -->|"dispatches events"| node_events
node_minecraft -->|"injects placement"| node_block
node_minecraft -->|"injects item use"| node_bucket
node_minecraft -->|"injects resolution"| node_piston
node_minecraft -->|"injects explosion"| node_explosion

click node_initializer "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/Kangal_chunk_protector.java"
click node_commands "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java"
click node_events "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java"
click node_utils "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionUtils.java"
click node_block "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/BlockItemMixin.java"
click node_bucket "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/ItemStackMixin.java"
click node_piston "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/PistonMixin.java"
click node_explosion "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/ExplosionMixin.java"
click node_manager "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectedChunkManager.java"
click node_saveddata "https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionSavedData.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_initializer,node_commands toneBlue
class node_utils toneAmber
class node_events,node_block,node_bucket,node_piston,node_explosion,node_players toneMint
class node_manager,node_saveddata toneRose
class node_minecraft toneIndigo
```

## Components

### Mod entrypoints

- [Mod initializer](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/Kangal_chunk_protector.java): `src/main/java/kangal/chunk_protector/Kangal_chunk_protector.java`
- [Protection commands](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java): `src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java`

### Protection rules

- [Protection rules](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionUtils.java): `src/main/java/kangal/chunk_protector/protection/ProtectionUtils.java`

### Gameplay guards

- [Protection events](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java): `src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java`
- [Block placement](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/BlockItemMixin.java): `src/main/java/kangal/chunk_protector/mixin/BlockItemMixin.java`
- [Bucket use](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/ItemStackMixin.java): `src/main/java/kangal/chunk_protector/mixin/ItemStackMixin.java`
- [Piston movement](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/PistonMixin.java): `src/main/java/kangal/chunk_protector/mixin/PistonMixin.java`
- [Explosion filtering](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/mixin/ExplosionMixin.java): `src/main/java/kangal/chunk_protector/mixin/ExplosionMixin.java`

### Protection state

- [Chunk manager](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectedChunkManager.java): `src/main/java/kangal/chunk_protector/protection/ProtectedChunkManager.java`
- [Saved protection data](https://github.com/megasush1/kangal-chunk-protector/blob/main/src/main/java/kangal/chunk_protector/protection/ProtectionSavedData.java): `src/main/java/kangal/chunk_protector/protection/ProtectionSavedData.java`

### Other components

- **Server players**
- **Minecraft runtime**

## Connections

- Mod initializer → Protection events: registers (evidence: `src/main/java/kangal/chunk_protector/Kangal_chunk_protector.java`)
- Mod initializer → Protection commands: registers (evidence: `src/main/java/kangal/chunk_protector/Kangal_chunk_protector.java`)
- Server players → Protection commands: invoke (evidence: `src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java`)
- Protection commands → Chunk manager: manage chunks (evidence: `src/main/java/kangal/chunk_protector/protection/ProtectionCommands.java`)
- Protection events → Protection rules: check actions (evidence: `src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java`)
- Block placement → Protection rules: check placement (evidence: `src/main/java/kangal/chunk_protector/mixin/BlockItemMixin.java`)
- Bucket use → Chunk manager: check target (evidence: `src/main/java/kangal/chunk_protector/mixin/ItemStackMixin.java`)
- Piston movement → Chunk manager: check chunks (evidence: `src/main/java/kangal/chunk_protector/mixin/PistonMixin.java`)
- Explosion filtering → Chunk manager: filter positions (evidence: `src/main/java/kangal/chunk_protector/mixin/ExplosionMixin.java`)
- Protection rules → Chunk manager: check protection (evidence: `src/main/java/kangal/chunk_protector/protection/ProtectionUtils.java`)
- Chunk manager → Saved protection data: read and write (evidence: `src/main/java/kangal/chunk_protector/protection/ProtectedChunkManager.java`)
- Minecraft runtime → Protection events: dispatches events (evidence: `src/main/java/kangal/chunk_protector/protection/ProtectionEvents.java`)
- Minecraft runtime → Block placement: injects placement (evidence: `src/main/java/kangal/chunk_protector/mixin/BlockItemMixin.java`)
- Minecraft runtime → Bucket use: injects item use (evidence: `src/main/java/kangal/chunk_protector/mixin/ItemStackMixin.java`)
- Minecraft runtime → Piston movement: injects resolution (evidence: `src/main/java/kangal/chunk_protector/mixin/PistonMixin.java`)
- Minecraft runtime → Explosion filtering: injects explosion (evidence: `src/main/java/kangal/chunk_protector/mixin/ExplosionMixin.java`)
