Runelite-EssentialsPlus/CLAUDE.md

EssentialsPlus - Entwicklungsrichtlinien & Build-Workflow

⚠️ EXTREM WICHTIGER DEPLOYMENT- & RELEASE-WORKFLOW

Bei JEDEM Update / Build müssen immer folgende Schritte ausgeführt werden:

1. Lokales Bolt Launcher Deployment

• ./gradlew deploy baut die Fat-Jar (shadowJar) und installiert sie atomar nach: ~/.local/share/bolt-launcher/custom-runelite.jar
• Zusätzlich wird die Jar immer nach /home/hikyu/Downloads/RuneLite.jar kopiert.

2. Git Release Upload (Runelite-EssentialsPlus)

• Remote: ssh://git@git.gapspace.de:2222/Hikyu/Runelite-EssentialsPlus.git
• Lokaler Release-Ordner: /home/hikyu/Documents/projects/Runelite-EssentialsPlus
• Direkter Download-Link: https://gapspace.de/Hikyu/Runelite-EssentialsPlus/raw/branch/master/RuneLite.jar
• WICHTIGE REGELN:
  1. In diesem Repository darf NUR die einzelne Datei RuneLite.jar liegen (keine Ordner, keine Skripte, keine anderen Dateien).
  2. Es darf keine Versions-Historie auf dem Server akkumulieren: Alte Versionen werden bei jedem Update überschrieben.
  3. Der Befehl zum Aktualisieren des Release-Repos lautet:

     cp build/libs/bank-highlighter-1.0-SNAPSHOT-all.jar /home/hikyu/Documents/projects/Runelite-EssentialsPlus/RuneLite.jar
     cd /home/hikyu/Documents/projects/Runelite-EssentialsPlus
     git add RuneLite.jar
     git commit --amend -m "RuneLite EssentialsPlus (neuestes Update)" --date=now
     git push -f origin master
     

---

🛠️ Plugin-Module Übersicht

• Deterministischer Attack Timer (com.example.essentialsplus.helpers.combat.*):
  • 100% deterministische Berechnung von Waffengeschwindigkeit, Ranged Rapid-Modus (-1 Tick), Powered Staves (4 Ticks), Manual/Autocast Spells (5 Ticks, Harmonised 4 Ticks, Twinflame 6 Ticks) inkl. Casting-Sound-Erkennung.
  • Spezielle Boss-Mechaniken: Tormented Demons, Blood Moon Set, Red Keris, Scurrius, Amoxliatl, ToA Warden Skulls, Eye of Ayak, Doom of Mokhaiotl, Royal Titans, Maggot King, Yama Shadow Crash.
  • Essens-/Trankverzögerungen (Fast Foods 2 Ticks, Standard 3 Ticks, Vampyrium Tartare 4 Ticks).
  • Design und Einstellungen in AttackTimerOverlay.java und EssentialsPlusConfig.java bleiben optisch immer unverändert.
• Item Charges Helper (com.example.essentialsplus.helpers.ItemCharges*):
  • Lückenlose Ladungsanzeige & Persistenz für Barrows (Dharok etc. in %), Blowpipe (Darts & Scales getrennt/kombiniert), Coal Bag, Gem Bag, Herb Sack, Fish Barrel, Arclight/Emberlight, Ringe, Jewelry, Crystal Tools/Armor.
• Wealth & Currency Store: Vermögen, GE-Buy-Limits und Minigame-Währungen.
• Loot & Combat Tracker: Drop Tables, Sessions, DPS-Rechner.
• Bank Highlighter: Farbhervorhebung in Bank-Tabs.