How chrisherkins/archipelago_terraria_client works
This repository pairs a Terraria tModLoader client with an Archipelago Terraria world implementation. Players configure and connect the mod to a multiworld session; Terraria boss/event progress becomes location checks, while received items and flags alter the world and unlock progression. The separate APWorld defines checks, options, regions, rules, and rewards. Edges are limited to explicit README statements and sampled/indexed references; some runtime dispatch details are not visible in the excerpts.
Main entry points: ArchipelagoSystem.cs Session Runtime · SeldomArchipelago.cs Mod Entry · __init__.py World Definition · CollectionButton.cs Collection UI
Components 22
Terraria Client
- Connection Config
Config/Config.cs - Mod Entry
SeldomArchipelago.cs - Session Runtime
Systems/ArchipelagoSystem.cs - AP Commands
Command - Player State
Players/ArchipelagoPlayer.cs - Flag Starters
FlagItem/FlagStarter.cs
Archipelago World
- World Definition
TerrariaAPWorld/__init__.py - Check Catalog
TerrariaAPWorld/Checks.py - World Options
TerrariaAPWorld/Options.py - Entity Data
TerrariaAPWorld/Entities.py - Data Loader
TerrariaAPWorld/DataLoader.py - Item Definitions
TerrariaAPWorld/Items.py - World Resources
TerrariaAPWorld/Resources.py - Progression Rules
TerrariaAPWorld/__init__.py
Player Interface
- Collection UI
UI/CollectionButton.cs - Collection NPC
NPCs/CollectionNPC.cs
Game Integration
- Ghost NPCs
NPCs/GhostNPC.cs - NPC Checks
NPCs/ArchipelagoGlobalNPC.cs - Calamity Hooks
Systems/CalamitySystem.cs - Tile Hooks
Tile/ArchipelagoGlobalTile.cs
Other components
- Terraria Player
- Archipelago Server
Connections 25
- Terraria Player → Connection Config: configures
README.md - Terraria Player → AP Commands: uses
README.md - Mod Entry → Session Runtime: uses
SeldomArchipelago.cs - Connection Config → Session Runtime: configures
Config/Config.cs - AP Commands → Session Runtime: invokes
Command/ApCommand.cs - Session Runtime → Archipelago Server: connects
README.md - Session Runtime → Player State: updates
Systems/ArchipelagoSystem.cs - Flag Starters → Session Runtime: checks flags
FlagItem/FlagStarter.cs - Collection UI → Collection NPC: spawns
UI/CollectionButton.cs - Collection UI → Session Runtime: reads rewards
UI/CollectionButton.cs - Mod Entry → Collection UI: uses
SeldomArchipelago.cs - Mod Entry → Ghost NPCs: uses
SeldomArchipelago.cs - Mod Entry → Calamity Hooks: uses
SeldomArchipelago.cs - Mod Entry → NPC Checks: registers
NPCs/ArchipelagoGlobalNPC.cs - Mod Entry → Tile Hooks: registers
Tile/ArchipelagoGlobalTile.cs - Calamity Hooks → Session Runtime: reports progress
Systems/CalamitySystem.cs - World Definition → Check Catalog: loads
TerrariaAPWorld/__init__.py - World Definition → World Options: uses
TerrariaAPWorld/__init__.py - World Definition → World Resources: uses
TerrariaAPWorld/__init__.py - Check Catalog → Item Definitions: referenced by
TerrariaAPWorld/Items.py - Data Loader → Entity Data: loads
TerrariaAPWorld/DataLoader.py - World Definition → Progression Rules: defines rules
TerrariaAPWorld/__init__.py - World Definition → Archipelago Server: runs within
README.md - Player State → Session Runtime: sends deathlink
Players/ArchipelagoPlayer.cs - Session Runtime → Flag Starters: grants flags
Systems/ArchipelagoSystem.cs