dasaod/sf-guildscanner repository overview

⁠⚔️ SF Gilden-Scanner

Findet angreifbare Gilden in Shakes & Fidget – basierend auf Mitgliederanzahl und den einzelnen Leveln der Mitglieder.

⁠Funktionsweise

⁠Scan-Ablauf (vollautomatisch)

1. Login per SSO → Charakter auswählen → Gildendaten laden
2. Phase 1 – HoF-Scan: Scannt die komplette Gilden-Ehrenhalle und ermittelt alle Gilden mit Rang, Ehre, Mitgliederzahl
3. Automatische Filterung: Markiert alle angreifbaren Gilden nach der Spielregel:
   • Alle Gilden unter euch (höherer Rang) → angreifbar
   • Gilden über euch → angreifbar wenn max. 20 Ränge ODER max. 3000 Ehre darüber
4. Phase 2 – Detail-Scan: Für jede angreifbare Gilde wird ViewGuild aufgerufen → alle Mitglieder mit ihren individuellen Leveln
5. Speicherung: Ergebnisse werden als JSON-Datei persistiert (beim nächsten Start wieder verfügbar)

⁠Filter-Möglichkeiten

• Max Mitglieder: Nur Gilden mit höchstens X Mitgliedern anzeigen
• Max höchstes Level: Nur Gilden, deren stärkster Charakter höchstens Level X hat
• Angegriffene ausblenden: Gilden die gerade angegriffen werden verstecken

⁠Vergleich

Für jede Gilde siehst du:

• Mitgliederanzahl vs. deine Gilde
• Max/Min Level und Gesamt-Level-Summe
• Im Detail-View: Alle Mitglieder mit Level + direkter Vergleich

⁠Export

Der komplette Scan lässt sich als JSON exportieren (Button "📥 Export"), inklusive aller Mitglieder-Level.

⁠Deployment

⁠Docker Hub (empfohlen – kein Bauen nötig)

mkdir -p /mnt/user/appdata/sfguild-scanner
cd /mnt/user/appdata/sfguild-scanner

# docker-compose.yml herunterladen
curl -O https://raw.githubusercontent.com/DasAoD/sf-guildscanner/main/docker-compose.yml

# Starten (Image wird automatisch von Docker Hub geladen)
docker compose up -d

# Öffnen: http://<HOST-IP>:8085

Die Scan-Daten werden persistent im ./data/ Ordner gespeichert.

⁠Aus dem Quellcode bauen

git clone https://github.com/DasAoD/sf-guildscanner.git
cd sf-guildscanner
docker compose -f docker-compose.build.yml up -d --build

⁠Manuell ohne docker-compose

docker run -d \n  --name sfguild-scanner \n  -p 8085:8080 \n  -v ./data:/app/data \n  -e RUST_LOG=info \n  --restart unless-stopped \n  dasaod/sf-guildscanner:latest

⁠Scan-Dauer

• Phase 1 (HoF): ~10-40 Sekunden (abhängig von der Servergröße)
• Phase 2 (Details): ~0,5 Sek. pro Gilde → bei 100 angreifbaren Gilden ca. 1 Minute

Der Fortschritt wird live im Browser angezeigt.

⁠Projektstruktur

sfguild-scanner/
├── Cargo.toml
├── Dockerfile              # Multi-Stage Build
├── docker-compose.yml
├── .dockerignore
├── src/
│   └── main.rs             # Rust Backend (Axum + sf-api)
├── static/
│   └── index.html          # Web-Frontend
└── data/                   # Persistente Scan-Daten (Volume)
    └── scan_*.json

⁠Hinweise

• Login-Daten werden nur im RAM gehalten, nie gespeichert
• Der Container braucht Zugang zu sfgame.net und sso.playa-games.com
• Erster Build dauert 3-5 Min. (Rust kompiliert alle Dependencies)
• Zwischen API-Requests wird 400-500ms Pause gehalten (Rate-Limiting)

⁠Credits

• sf-api⁠ by the-marenga⁠ — Rust library for the Shakes & Fidget API

⁠Mitwirkende

Dieses Projekt wurde in Zusammenarbeit mit Claude⁠ (Sonnet 4.6) von Anthropic⁠ entwickelt und iterativ ausgebaut.
Der øberwiegende Teil des Codes, der Architektur und der Dokumentation wurde durch KI generiert und gemeinsam verfeinert.

⁠License

MIT⁠