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.
• Blast Furnace Helper (com.example.essentialsplus.helpers.BlastFurnace*):
  • Markiert strikt sequenziell immer nur genau ein Ziel ("niemals mehrere Dinge gleichzeitig"):
    • Bei geöffneter Bank: Barren einlagern -> leere Vials einlagern -> bei <= 30 Energie Stamina Potion trinken (Priorität: 1-Dose Extended > 1-Dose Normal > 2-4 Dose Extended > 2-4 Dose Normal; angebrochene Tränke werden vor dem Erz-Abheben zurück in die Bank gelegt) -> Coal-Bag füllen im Inventar & Ziel-Erz/Kohle in der Bank abheben werden gleichzeitig markiert (sodass man Coal Bag füllen und direkt das Erz/Kohle anklicken kann; Mindestbestand im Ofen mit +1 Puffer, z. B. 4x Erz-Slots = 108 Kohle bei Runite mit Coal Bag; Priorität: Runite > Adamantite > Mithril > Gold > Iron/Steel > Silver > Bronze nach Smithing-Level & Bank-Bestand; Erze mit < 27 Stück in der Bank werden ignoriert, um halbe Touren zu verhindern; wenn alle Erze < 27 sind, ist der Helper fertig und markiert nichts mehr).
    • Sobald das Inventar voll ist, wird das Förderband ("Put ore on belt" / "Put coal on belt") sofort in der 3D-Welt markiert – auch bei noch geöffneter Bank, sodass man mit 1 Klick direkt vom Bankfenster zum Band laufen kann.
    • Intelligentes Warten am Bar Dispenser: Nach dem Auflegen von Erzen auf das Band wird der Bar Dispenser ("Wait for bars" / "Collect bars") markiert, bis die Barren geschmolzen und abgeholt sind, anstatt voreilig zur Bank-Chest zu leiten. Erst mit Barren im Inventar geht es zur Bank-Chest ("Bank bars").
  • Rand-Markierung ("Border-only"): Items in Bank & Inventar werden mit einem klaren Rahmen ohne deckenden Fill umrandet, sodass jedes Icon deutlich erkennbar bleibt.
  • Einstellungen und Beschriftungen vollständig auf Englisch (Menüs im Helpers-Card per Rechtsklick, Panel-Zeilen, Tooltips).
  • Info-Panel: Coal in furnace, Bars in furnace, Coffer + Restzeit und berechnete Barren aus Bank-Ores.
• Chat Helper (com.example.essentialsplus.helpers.ChatHelper*):
  • Automatisches Aufräumen (Auto-Clear) alter Chat-Nachrichten nach konfigurierbarer Dauer (Standard 60s / 1 Min., 30s, 2m, 5m). Selektiver Schutz für private Nachrichten & Clan-/Friends-Chats.
  • Duplikat-Kompaktierung: Aufeinanderfolgende gleiche Meldungen werden zu (x2, x3...) komprimiert.
  • Spam- & Noise-Filter: Unterdrückt überflüssigen Systemlärm ("Nothing interesting happens", etc.) und Werbebots.
  • Namen-Highlighting: Eigener Spielername wird in öffentlichen/Clan-Chats hervorgehoben (Farbe & Fettdruck).
  • Rechtsklick-Aktionen: "Copy message" (kopiert bereinigten Text) & "Clear chat" auf Tabs / Kontextmenü.