# stevekung/fishofthieves architecture

> Architecture diagram of the GitHub repository stevekung/fishofthieves, 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/stevekung/fishofthieves
- Repository: https://github.com/stevekung/fishofthieves

## Overview

Fish of Thieves is a Minecraft mod adding Sea of Thieves fish, fruit trees, and tropical plant life. A player encounters modded fish and vegetation in the world; fish also support shoals, bait-related fishing, and client rendering, while fruit-tree blocks and world-generation features supply the plant content. The common module holds gameplay and registrations, with Fabric and Forge adapters providing loader-specific integration. The README confirms the product capabilities, but many implementation files were not sampled, so links for those subsystems are documented or left unverified rather than inferred from naming.

Main entry points: [`common/src/main/java/com/stevekung/fishofthieves/entity/animal`](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/animal) (Thieves Fish), [`common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java`](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java) (Client Initialization), [`common/src/main/java/com/stevekung/fishofthieves/registry/FOTBlocks.java`](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/registry/FOTBlocks.java) (Blocks And Items), [`common/src/main/java/com/stevekung/fishofthieves/block`](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/block) (Fruit Plant Blocks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Mod Core"]
  node_bootstrap["Mod Initialization<br/>[FishOfThieves.java]"]
  node_platform_api["Platform API<br/>[FOTPlatform.java]"]
  node_plaque["Fish Plaques"]
  node_config["Mod Configuration"]
end

subgraph group_aquatic["Fish Gameplay"]
  node_fish["Thieves Fish"]
  node_shoals["Fish Shoals<br/>[Shoal.java]"]
  node_variants["Fish Variants"]
  node_fishing["Bait Fishing"]
  node_loot["Fishing And World Loot"]
end

subgraph group_plants["Plants And World"]
  node_blocks["Blocks And Items<br/>[FOTBlocks.java]"]
  node_fruit_plants["Fruit Plant Blocks"]
  node_worldgen["Tree And Island Generation"]
end

subgraph group_client["Client Experience"]
  node_client_init["Client Initialization"]
  node_fish_models["Fish Models"]
  node_client_packets["Client Packet Handling"]
end

subgraph group_platform["Loader Integration"]
  node_fabric["Fabric Adapter"]
  node_forge["Forge Adapter"]
  node_biolith["Biolith Compatibility"]
end

node_player(("Minecraft Player"))

node_player -.->|"encounters"| node_fish
node_player -.->|"encounters"| node_fruit_plants
node_bootstrap -.->|"checks platform"| node_platform_api
node_bootstrap -.->|"registers content"| node_blocks
node_blocks -->|"instantiates blocks"| node_fruit_plants
node_fish -.->|"uses variants"| node_variants
node_fish -.->|"forms shoals"| node_shoals
node_player -.->|"fishes with bait"| node_fishing
node_loot -->|"adds fish bone loot"| node_blocks
node_fruit_plants -.->|"grown by features"| node_worldgen
node_player -.->|"displays fish"| node_plaque
node_client_init -->|"reads configuration"| node_config
node_client_init -->|"registers models"| node_fish_models
node_fish_models -->|"models Battlegill"| node_fish
node_client_packets -->|"syncs shoal data"| node_shoals
node_fabric -->|"initializes client"| node_client_init
node_fabric -->|"routes packets"| node_client_packets
node_forge -.->|"syncs shoals"| node_client_packets
node_biolith -.->|"integrates generation"| node_worldgen

click node_bootstrap "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FishOfThieves.java"
click node_platform_api "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FOTPlatform.java"
click node_fish "https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/animal"
click node_shoals "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/shoal/Shoal.java"
click node_variants "https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/variant"
click node_fishing "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/FishingHookBait.java"
click node_loot "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/loot/FOTLootManager.java"
click node_blocks "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/registry/FOTBlocks.java"
click node_fruit_plants "https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/block"
click node_worldgen "https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/feature"
click node_plaque "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/api/block/FishPlaqueRegistry.java"
click node_config "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/config/FishOfThievesConfig.java"
click node_client_init "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java"
click node_fish_models "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/client/model/BattlegillModel.java"
click node_client_packets "https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/network/FOTClientPackets.java"
click node_fabric "https://github.com/stevekung/fishofthieves/blob/1.20.1/fabric/src/main/java/com/stevekung/fishofthieves/fabric/FishOfThievesFabric.java"
click node_forge "https://github.com/stevekung/fishofthieves/blob/1.20.1/forge/src/main/java/com/stevekung/fishofthieves/forge/FishOfThievesForge.java"
click node_biolith "https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/compatibility/biolith"

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_bootstrap,node_platform_api,node_plaque,node_config toneBlue
class node_fish,node_shoals,node_variants,node_fishing,node_loot toneAmber
class node_blocks,node_fruit_plants,node_worldgen toneMint
class node_client_init,node_fish_models,node_client_packets toneRose
class node_fabric,node_forge,node_biolith,node_player toneIndigo
```

## Components

### Mod Core

- [Mod Initialization](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FishOfThieves.java): `common/src/main/java/com/stevekung/fishofthieves/FishOfThieves.java`
- [Platform API](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FOTPlatform.java): `common/src/main/java/com/stevekung/fishofthieves/FOTPlatform.java`
- [Fish Plaques](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/api/block/FishPlaqueRegistry.java): `common/src/main/java/com/stevekung/fishofthieves/api/block/FishPlaqueRegistry.java`
- [Mod Configuration](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/config/FishOfThievesConfig.java): `common/src/main/java/com/stevekung/fishofthieves/config/FishOfThievesConfig.java`

### Fish Gameplay

- [Thieves Fish](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/animal): `common/src/main/java/com/stevekung/fishofthieves/entity/animal`
- [Fish Shoals](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/shoal/Shoal.java): `common/src/main/java/com/stevekung/fishofthieves/entity/shoal/Shoal.java`
- [Fish Variants](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/variant): `common/src/main/java/com/stevekung/fishofthieves/entity/variant`
- [Bait Fishing](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/entity/FishingHookBait.java): `common/src/main/java/com/stevekung/fishofthieves/entity/FishingHookBait.java`
- [Fishing And World Loot](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/loot/FOTLootManager.java): `common/src/main/java/com/stevekung/fishofthieves/loot/FOTLootManager.java`

### Plants And World

- [Blocks And Items](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/registry/FOTBlocks.java): `common/src/main/java/com/stevekung/fishofthieves/registry/FOTBlocks.java`
- [Fruit Plant Blocks](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/block): `common/src/main/java/com/stevekung/fishofthieves/block`
- [Tree And Island Generation](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/feature): `common/src/main/java/com/stevekung/fishofthieves/feature`

### Client Experience

- [Client Initialization](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java): `common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java`
- [Fish Models](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/client/model/BattlegillModel.java): `common/src/main/java/com/stevekung/fishofthieves/client/model/BattlegillModel.java`
- [Client Packet Handling](https://github.com/stevekung/fishofthieves/blob/1.20.1/common/src/main/java/com/stevekung/fishofthieves/network/FOTClientPackets.java): `common/src/main/java/com/stevekung/fishofthieves/network/FOTClientPackets.java`

### Loader Integration

- [Fabric Adapter](https://github.com/stevekung/fishofthieves/blob/1.20.1/fabric/src/main/java/com/stevekung/fishofthieves/fabric/FishOfThievesFabric.java): `fabric/src/main/java/com/stevekung/fishofthieves/fabric/FishOfThievesFabric.java`
- [Forge Adapter](https://github.com/stevekung/fishofthieves/blob/1.20.1/forge/src/main/java/com/stevekung/fishofthieves/forge/FishOfThievesForge.java): `forge/src/main/java/com/stevekung/fishofthieves/forge/FishOfThievesForge.java`
- [Biolith Compatibility](https://github.com/stevekung/fishofthieves/tree/1.20.1/common/src/main/java/com/stevekung/fishofthieves/compatibility/biolith): `common/src/main/java/com/stevekung/fishofthieves/compatibility/biolith`

### Other components

- **Minecraft Player**

## Connections

- Minecraft Player → Thieves Fish: encounters
- Minecraft Player → Fruit Plant Blocks: encounters
- Mod Initialization → Platform API: checks platform (evidence: `common/src/main/java/com/stevekung/fishofthieves/FishOfThieves.java`)
- Mod Initialization → Blocks And Items: registers content (evidence: `common/src/main/java/com/stevekung/fishofthieves/FishOfThieves.java`)
- Blocks And Items → Fruit Plant Blocks: instantiates blocks (evidence: `common/src/main/java/com/stevekung/fishofthieves/registry/FOTBlocks.java`)
- Thieves Fish → Fish Variants: uses variants
- Thieves Fish → Fish Shoals: forms shoals
- Minecraft Player → Bait Fishing: fishes with bait
- Fishing And World Loot → Blocks And Items: adds fish bone loot (evidence: `common/src/main/java/com/stevekung/fishofthieves/loot/FOTLootManager.java`)
- Fruit Plant Blocks → Tree And Island Generation: grown by features
- Minecraft Player → Fish Plaques: displays fish
- Client Initialization → Mod Configuration: reads configuration (evidence: `common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java`)
- Client Initialization → Fish Models: registers models (evidence: `common/src/main/java/com/stevekung/fishofthieves/FishOfThievesClient.java`)
- Fish Models → Thieves Fish: models Battlegill (evidence: `common/src/main/java/com/stevekung/fishofthieves/client/model/BattlegillModel.java`)
- Client Packet Handling → Fish Shoals: syncs shoal data (evidence: `common/src/main/java/com/stevekung/fishofthieves/network/FOTClientPackets.java`)
- Fabric Adapter → Client Initialization: initializes client
- Fabric Adapter → Client Packet Handling: routes packets
- Forge Adapter → Client Packet Handling: syncs shoals
- Biolith Compatibility → Tree And Island Generation: integrates generation
