Readme.md hinzugefügt

2026-05-30 19:01:13 +02:00
commit 071a663005
1 changed files with 49 additions and 0 deletions
@@ -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.