How oreocupcakes/kotori-plugins works
This repository is a suite of RuneLite plugins for Old School RuneScape, plus shared Kotori utilities. A player encounters game-state-aware helpers through RuneLite: plugin event handlers interpret boss, activity, or player state, then show overlays/timers or assist with prayers and actions. Distinct branches cover boss encounters, combat/activity guidance, and player-effect tracking. The README only identifies the repository as ported OpenOSRS plugins; most subsystem links below are inferred from the file tree and remain unverified where source was not sampled.
Main entry points: CerberusHelperPlugin.java Cerberus helper · EffectTimersPlugin.java Effect timers · AlchemicalHelperPlugin.java Alchemical Hydra · GauntletHelperPlugin.java Gauntlet helper
Components 25
Boss encounters
- Cerberus helper
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/CerberusHelperPlugin.java - Cerberus phases
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/domain/Phase.java - Cerberus overlays
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/overlays/CurrentAttackOverlay.java - Alchemical Hydra
alchemicalhelper/src/main/java/com/theplug/kotori/alchemicalhelper/AlchemicalHelperPlugin.java - Vorkath guidance
vorkathoverlay/src/main/java/com/theplug/kotori/vorkathoverlay/VorkathPlugin.java - Zulrah guidance
zulrahoverlay/src/main/java/com/theplug/kotori/zulrahoverlay/ZulrahPlugin.java - Sire guidance
sirehelper/src/main/java/com/theplug/kotori/sirehelper/SireHelperPlugin.java - Nightmare guidance
nightmare/src/main/java/com/theplug/kotori/nightmare/NightmarePlugin.java - Nex guidance
nex/src/main/java/com/theplug/kotori/nex/NexPlugin.java - God Wars helper
gwdhelper/src/main/java/com/theplug/kotori/gwdhelper/GodWarsHelperPlugin.java
Activities and navigation
- Gauntlet helper
gauntlethelper/src/main/java/com/theplug/kotori/gauntlethelper/GauntletHelperPlugin.java - Resource tracking
gauntlethelper/src/main/java/com/theplug/kotori/gauntlethelper/module/maze/ResourceManager.java - Hallowed Sepulchre
hallowedhelper/src/main/java/com/theplug/kotori/hallowedhelper/HallowedHelperPlugin.java - Tarn's Lair
tarnslair/src/main/java/com/theplug/kotori/tarnslair/TarnsLairPlugin.java - Temple Trekking
templetrekking/src/main/java/com/theplug/kotori/templetrekking/TempleTrekkingPlugin.java
Combat guidance
- Fight Caves
fightcaves/src/main/java/com/theplug/kotori/fightcaves/FightCavePlugin.java - Inferno guidance
inferno/src/main/java/com/theplug/kotori/inferno/InfernoPlugin.java - Area warnings
aoewarnings/src/main/java/com/theplug/kotori/aoewarnings/AoeWarningPlugin.java
Effect tracking and utilities
- Effect timers
effecttimers/src/main/java/com/theplug/kotori/effecttimers/EffectTimersPlugin.java - Timer manager
effecttimers/src/main/java/com/theplug/kotori/effecttimers/TimerManager.java - Effect timer
effecttimers/src/main/java/com/theplug/kotori/effecttimers/Timer.java - Kotori utilities
kotoriutils/src/main/java/com/theplug/kotori/kotoriutils/KotoriUtils.java - Safe-tile search
kotoriutils/src/main/java/com/theplug/kotori/kotoriutils/methods/BreadthFirstSearch.java
Other components
- RuneLite player
- Game state
Connections 27
- RuneLite player → Game state: plays through
- Game state → Cerberus helper: emits events
- Cerberus helper → Cerberus phases: updates phases
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/CerberusHelperPlugin.java - Cerberus helper → Cerberus overlays: registers overlays
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/CerberusHelperPlugin.java - Cerberus helper → RuneLite player: assists prayers
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/CerberusHelperPlugin.java - Game state → Alchemical Hydra: emits events
- Alchemical Hydra → Safe-tile search: searches safe tiles
alchemicalhelper/src/main/java/com/theplug/kotori/alchemicalhelper/AlchemicalHelperPlugin.java - Game state → Vorkath guidance: emits events
- Game state → Zulrah guidance: emits events
- Game state → Sire guidance: emits events
- Game state → Nightmare guidance: emits events
- Game state → Nex guidance: emits events
- Game state → God Wars helper: emits events
- Game state → Gauntlet helper: emits events
- Gauntlet helper → Resource tracking: tracks resources
gauntlethelper/src/main/java/com/theplug/kotori/gauntlethelper/module/maze/ResourceManager.java - Game state → Hallowed Sepulchre: emits events
- Game state → Tarn's Lair: emits events
- Game state → Temple Trekking: emits events
- Game state → Fight Caves: emits events
- Game state → Inferno guidance: emits events
- Game state → Area warnings: emits events
- Game state → Effect timers: emits events
- Effect timers → Timer manager: adds timers
effecttimers/src/main/java/com/theplug/kotori/effecttimers/EffectTimersPlugin.java - Timer manager → Effect timer: stores timers
effecttimers/src/main/java/com/theplug/kotori/effecttimers/TimerManager.java - Effect timers → RuneLite player: shows timer overlay
- Cerberus helper → Kotori utilities: uses utilities
cerberushelper/src/main/java/com/theplug/kotori/cerberushelper/CerberusHelperPlugin.java - Effect timers → Kotori utilities: uses utilities
effecttimers/src/main/java/com/theplug/kotori/effecttimers/EffectTimersPlugin.java