ecdbd2ee0d
- Treffer-Toleranz: Ziel wird geometrisch + bevorzugt getroffen, auch wenn verdeckt - Zwei Ranglisten: Hall of Fame (Allzeit-Top-5) + Heute (Top-10) - Anti-Cheat: server-autoritative Sessions (start/hit), Score = Server-Zahl, Mindestabstand gegen Auto-Klicker, Deckelung nach Spielzeit; Score ohne Session -> 400 - CLI (server/admin.js): list / delete <name> / clear-today / clear-all - Zwei Betriebsmodi per CLI (live, ohne Neustart): public (/ = Spiel) und private (/ gesperrt, Spiel unter geheimem /pfad) + "not allowed to play"-Seite - Board-Icons von Emojis auf echte SVG-Icons, Board heisst "Hall of Fame" Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
101 lines
4.1 KiB
Markdown
101 lines
4.1 KiB
Markdown
# fuesse.sexy — „Wanted!" 🦶
|
||
|
||
Ein kleines Arcade-Spiel nach dem Vorbild des **„Wanted!"-Minispiels aus New Super Mario
|
||
Bros.**: Oben ein Fahndungsplakat mit *einem* gesuchten Fuß, unten wuseln viele Füße (in
|
||
verschiedenen Farben) + etwas Deko herum. **Schnapp dir den gesuchten Fuß, bevor die Zeit
|
||
abläuft** — dann kommt sofort ein neues Plakat mit einer anderen Farbe.
|
||
|
||
- **Zeitdruck:** Countdown; jeder Treffer gibt Zeit dazu, Fehlklick zieht Zeit ab. Bei 0 → Game-Over.
|
||
- **Wird schwerer:** erst ordentliches **Raster**, dann **wild verteilt**, dann **Bewegung**
|
||
(erst in 2–3 Gruppen, später einzeln) — und je weiter, desto **schneller** und **mehr** Füße.
|
||
- **Gesucht ist immer ein Fuß, aber die Farbe wechselt jede Runde** — nicht auf Autopilot klicken!
|
||
- **Rangliste:** die Top 10 auf der Startseite, serverseitig gespeichert. Nach dem Spiel
|
||
wird **einmal** nach dem Namen gefragt (danach gecacht).
|
||
|
||
## Installation
|
||
|
||
```sh
|
||
./install.sh
|
||
```
|
||
|
||
Das Skript installiert alles Nötige, startet den Server **im Hintergrund** und zeigt die
|
||
URL. Dann im Browser öffnen: **http://<server-ip>:3000** (lokal: http://localhost:3000).
|
||
|
||
Manuell: `npm install && npm start`.
|
||
|
||
## Die Füße & Deko erweitern
|
||
|
||
Alle Bildchen liegen in `library/`:
|
||
|
||
```
|
||
library/
|
||
feet/ ← die Füße (= die gesuchten Figuren). Farbe = Dateiname.
|
||
props/ ← Deko ("andere Bildchen") als Zusatz-Ablenker.
|
||
```
|
||
|
||
Neue Bildchen einfach in den passenden Ordner legen und **Server neu starten** — fertig.
|
||
Formate: `.svg`, `.png`, `.webp`, `.jpg`. Für Füße gilt: **mind. 2** in `library/feet/`
|
||
(mehr = mehr Farb-Vielfalt). Am besten freigestellt (transparenter Hintergrund), grob
|
||
quadratisch.
|
||
|
||
### Woher Bildchen nehmen?
|
||
openclipart.org (CC0), svgrepo.com (CC0-Filter), kenney.nl (CC0), pixabay.com. Bei
|
||
Flaticon/Freepik Namensnennung beachten.
|
||
|
||
## Feintuning
|
||
|
||
In `public/js/app.js` oben:
|
||
- `START_TIME`, `MAX_TIME`, `BONUS`, `PENALTY` — Timer/Balance.
|
||
- `difficulty(score)` — Anzahl, Bewegungs-Stufen (`grid`/`scatter`/`groups`/`individual`)
|
||
und Tempo je Score.
|
||
|
||
## Rangliste
|
||
|
||
- Zwei Boards: **Hall of Fame** (Allzeit-Top-5) + **Heute** (Top-10). Gespeichert in
|
||
`data/leaderboard.json` (wird automatisch angelegt, überlebt Neustarts).
|
||
- **Anti-Cheat:** Der Score ist server-autoritär — der Server vergibt zu Spielbeginn eine
|
||
Session (`/api/game/start`), zählt jeden gemeldeten Treffer (`/api/game/hit`) mit
|
||
Mindestabstand (gegen Auto-Klicker) und deckelt nach echter Spielzeit. Beim Eintragen
|
||
(`/api/score`) zählt **nur** diese Server-Zahl; ein Score ohne gültige Session wird
|
||
abgelehnt. Namen werden beim Anzeigen escaped (kein XSS).
|
||
|
||
## Verwaltung per CLI
|
||
|
||
Auf dem Server (im Projektordner):
|
||
|
||
```sh
|
||
# Rangliste
|
||
node server/admin.js list # beide Boards anzeigen
|
||
node server/admin.js delete "Name" # einen bestimmten Spieler löschen
|
||
node server/admin.js clear-today # nur die heutige Rangliste leeren
|
||
node server/admin.js clear-all # komplette Rangliste leeren
|
||
|
||
# Betriebsmodus (wirkt SOFORT, ohne Neustart)
|
||
node server/admin.js mode # aktuellen Modus anzeigen
|
||
node server/admin.js mode public # Spiel öffentlich unter "/"
|
||
node server/admin.js mode private geheim # "/" gesperrt, Spiel nur unter "/geheim"
|
||
```
|
||
|
||
(Kurzform via npm: `npm run lb -- <befehl>`.)
|
||
|
||
- **public** (Default): `/` ist das Spiel.
|
||
- **private**: `/` zeigt „You are not allowed to play", das Spiel läuft nur unter dem
|
||
gewählten Pfad (`/<pfad>`) — praktisch zum Testen im Live-Betrieb.
|
||
|
||
## Deployment (Ausblick)
|
||
|
||
Normaler Node-Server. Auf einen Node-Host bringen (VPS/LXC/Railway/Render), `./install.sh`,
|
||
Domain **fuesse.sexy** per Reverse-Proxy (z.B. Nginx Proxy Manager) darauf zeigen. Für
|
||
HTTPS hinter Cloudflare: DNS-Challenge (Cloudflare-Token) im Proxy nutzen.
|
||
|
||
## Projektstruktur
|
||
|
||
```
|
||
server/index.js schlanker Express-Server (Bildchen-Liste + Rangliste)
|
||
public/ Frontend (Startseite, Spiel, Game-Over) — Vanilla JS
|
||
library/feet/ die Füße (gesuchte Figuren)
|
||
library/props/ Deko-Ablenker
|
||
data/ Rangliste (leaderboard.json, zur Laufzeit)
|
||
install.sh Ein-Befehl-Setup + detached Start
|
||
```
|