commit 071a663005f85912481321bbe7d789e7a65ce2e6 Author: Daniel Schlapa Date: Sat May 30 19:01:13 2026 +0200 Readme.md hinzugefügt diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000..2ba6f8a --- /dev/null +++ b/Readme.md @@ -0,0 +1,49 @@ +# Jasbee Gebäude-Prozentanzeige + +Ein praktisches Tampermonkey-Userscript für das Browsergame [Jasbee](https://www.jasbee.de), das eine permanente Übersicht über den Zustand aller deiner Gebäude direkt im Spiel einblendet. Das Popup lässt sich frei verschieben und dient gleichzeitig als interaktive Steuerungszentrale. + +## Features + +* **Zustands-Tabelle:** Zeigt alle erfassten Gebäude sortiert nach dem kritischsten Zustand an (schlechtester Zustand oben). +* **Hintergrund-Scanner:** Mit nur einem Klick auf `city.php` werden alle verlinkten Gebäude im Hintergrund über ein unsichtbares Iframe gescannt – kein manuelles Durchklicken mehr nötig! +* **Interaktive Verlinkung:** Alle Gebäudenamen in der Liste sind direkt mit der jeweiligen Spielseite verlinkt. Ein Klick bringt dich sofort zum Gebäude, um es z. B. zu reparieren. +* **Live-Highlighting:** Das Gebäude, auf dem du dich aktuell befindest, wird in der Liste dezent hervorgehoben und kursiv dargestellt. +* **Farbcodierung:** Schnelle visuelle Erfassung des Zustands durch Ampelfarben: + * 🔴 **< 50%:** Kritisch (Rot) + * 🟡 **50% - 89%:** Warnung (Gelb) + * 🟢 **>= 90%:** Gut (Grün) +* **Persistent & Flexibel:** Das Popup merkt sich seine letzte Drag-and-Drop-Position auf dem Bildschirm sowie die gescannten Daten im `localStorage`. + +--- + +## Installation + +1. Installiere ein Userscript-Addon für deinen Browser (z. B. **Tampermonkey** oder **Violentmonkey**). +2. Erstelle ein neues Script im Dashboard deines Addons. +3. Kopiere den Code der `jasbee-gebaeude-prozentanzeige.js` hinein und speichere ihn ab. +4. Rufe Jasbee auf – das Popup erscheint automatisch auf allen unterstützten Unterseiten. + +--- + +## Unterstützte Seiten + +Das Script ist so konfiguriert, dass es auf den wichtigsten Wirtschafts- und Freizeitgebäuden aktiv wird: +* `city.php` (Hauptknotenpunkt für den globalen Scan) +* Lager, Baumarkt, Sportsbar, Aliengebäude, Sauna +* Wohnhaus, Fußballstadion, Schwimmhalle, Fabrik, Fitnessstudio, Bazar + +--- + +## Bedienung + +1. **Erster Scan:** Klicke auf der Hauptübersicht (`city.php`) im Popup auf **"Alle scannen"**. Das Script liest nun nacheinander alle Gebäude im Hintergrund aus. +2. **Navigation:** Klicke auf einen Gebäudenamen in der Liste, um direkt dorthin zu springen. +3. **Zurücksetzen:** Über den **"Reset"**-Button kannst du alle zwischengespeicherten Daten löschen, um beispielsweise eine saubere Neuauflage der Liste zu erzwingen. + +--- + +## Technische Details + +* **Lizenz:** MIT +* **Entwickler:** Daniel + Gemini +* **Zielelemente im DOM:** Nutzt die spielinternen Klassen `.pie-number`, `.breadcrumb li` und `.card`, um Daten manipulationsfrei und sicher auszulesen. \ No newline at end of file