# Kitzretter

**Original von Kitzrettung Rheinhessen e.V.** – https://www.kitzrettungrheinhessen.de

Kitzretter ist ein 3D-Spiel für Tablet, Handy und PC. Mit der Wärmebilddrohne findest du Rehkitze im hohen
Gras und lotst das Bergeteam per Funk hin, bevor die Wiese gemäht wird. Vereine können das Spiel mit eigenem
Namen, Logo, Farben und „Mitmachen“-Link auf ihrer Website zeigen.

Das Spiel ist kostenlos und wird so bereitgestellt, wie es ist, **ohne Support**. Wer es betreibt, ist selbst
verantwortlich für Hosting, Impressum, Datenschutzerklärung und Updates.

Die jeweils aktuelle Fassung liegt unter https://www.kitzrettungrheinhessen.de/kitzretter/kitzretter-paket.zip

## Inhalt

| Datei / Ordner | Zweck |
|---|---|
| `index.html` | das Spiel |
| `game.config.json` | eure Angaben: Vereinsname, Logo, Farben, „Mitmachen“-Link |
| `logo.png` | Platzhalter-Logo, durch euer Logo ersetzen |
| `three.min.js`, `fonts/`, `textur/`, `funk/` | 3D-Bibliothek, Schriften, Fototexturen, Funksprüche |
| `manifest.webmanifest` | damit das Spiel als App auf den Home-Bildschirm kann |
| `LICENSE.txt`, `LICENSES/`, `THIRD_PARTY_NOTICES.md` | Lizenzen und Quellen |

## Anpassen: `game.config.json`

```json
{
  "vereinsname": "Kitzrettung Musterdorf e.V.",
  "logo": "logo.png",
  "primaerfarbe": "#0e1a12",
  "akzentfarbe": "#e89a3c",
  "pilotWerdenUrl": "https://www.example.org/mitmachen"
}
```

| Feld | Bedeutung |
|---|---|
| `vereinsname` | Name eures Vereins, höchstens 80 Zeichen. Er erscheint auf dem Start- und Infobildschirm und im Mitmach-Kasten am Ende. |
| `logo` | Bilddatei im Spielordner: PNG, JPG, WebP, GIF oder SVG. Ohne `http://`, ohne `/` am Anfang, ohne Umlaute im Dateinamen. Unterordner sind erlaubt, z. B. `bilder/logo.svg`. |
| `primaerfarbe` | dunkle Grundfarbe für Hintergründe und Flächen, im Format `#rrggbb` |
| `akzentfarbe` | Farbe für Knöpfe, Markierungen und Hervorhebungen, im Format `#rrggbb`. Hellere Töne und die Schriftfarbe auf Knöpfen berechnet das Spiel selbst. |
| `pilotWerdenUrl` | Ziel des Knopfs „Mitmachen“. Muss mit `https://` oder `http://` beginnen. |

- Fehlt ein Wert oder ist er ungültig, läuft das Spiel trotzdem. Das jeweilige Element bleibt dann weg (z. B. der
  Mitmachen-Knopf), bei Farben gilt die Grundfarbe. Hinweise dazu stehen in der Konsole des Browsers.
- Am einfachsten ersetzt ihr `logo.png` durch euer Logo, quadratisch und mindestens 512 × 512 Pixel. Dann stimmen
  auch das Browser-Symbol und das App-Icon. Das Logo wird als Kreis auf Weiß gezeigt.
- Die Primärfarbe sollte dunkel sein, die Akzentfarbe kräftig und hell genug, um auf ihr gut lesbar zu sein.
- Alle Texte werden als reiner Text ausgegeben. HTML in der Config wird nicht ausgeführt.
- Nicht in der Config steht der Hinweis „Original von Kitzrettung Rheinhessen e.V.“. Er ist fest eingebaut und
  muss nach der Lizenz erhalten bleiben (siehe `LICENSE.txt`).

## Hosting

1. Den Ordner `kitzretter/` auf euren Webspace kopieren, z. B. nach `https://www.example.org/kitzretter/`.
   Es sind nur statische Dateien, ihr braucht kein PHP und keine Datenbank. HTTPS wird empfohlen.
2. Fertig. Das Spiel lädt nichts von fremden Servern: Schriften, three.js, Texturen und Funksprüche liegen im Ordner.

Ein Doppelklick auf `index.html` reicht nicht, weil der Browser dann Config und Texturen blockiert. Zum Testen auf
dem eigenen Rechner im Ordner einen kleinen Webserver starten und `http://localhost:8000` öffnen:

```bash
python3 -m http.server 8000
```

## Einbinden per iFrame

```html
<iframe src="https://www.example.org/kitzretter/"
        title="Kitzretter – das Kitzrettungs-Spiel"
        width="100%" height="680" style="border:0; max-width:100%;"
        allow="fullscreen; autoplay" allowfullscreen loading="lazy"></iframe>
```

- `allow="fullscreen"` sorgt dafür, dass der Vollbild-Knopf erscheint. Der Ton startet beim ersten Antippen.
- Links aus dem Spiel öffnen sich in einem neuen Tab.
- Auf dem iPhone gibt es im iFrame kein Vollbild. Für Handys ist ein direkter Link auf das Spiel oft besser.

## Datenschutz

- Keine Cookies, kein Tracking, keine Anmeldung und keine Abrufe von fremden Servern.
- Freigeschaltete Level, Sterne und die Toneinstellung speichert das Spiel im Browser (`localStorage`, Schlüssel
  `kitzretter`). Diese Daten verlassen das Gerät nicht. Erwähnt das in eurer Datenschutzerklärung.
- Wie bei jeder Website protokolliert euer Webserver die Aufrufe. Das regelt ihr mit eurem Hoster.
- Links zu kitzrettungrheinhessen.de, kitzcontrol.de und eurer Mitmach-Seite werden erst beim Antippen geöffnet.

## Lizenzen

- Code: GNU GPL Version 3 mit einer Zusatzbedingung nach § 7 b: Der Hinweis „Original von Kitzrettung
  Rheinhessen e.V.“ mit Link muss im Spiel sichtbar bleiben.
- Eigene Mediendateien (Funksprüche, Platzhalter-Logo): CC BY-SA 4.0.
- Fremde Bestandteile: three.js (MIT), Schriften Fraunces und Inter Tight (SIL OFL 1.1), Fototexturen (CC0).
- Ausgenommen sind Vereinslogos und alle Namen und Marken.

Einzelheiten stehen in `LICENSE.txt` und `THIRD_PARTY_NOTICES.md`.

## Hinweis zur Entstehung und Nutzung

Dieses Spiel wurde von Kitzrettung Rheinhessen e.V. ehrenamtlich und mit Unterstützung
von KI-Werkzeugen entwickelt. Es wird kostenlos und ohne Support, Wartung oder
Update-Zusage bereitgestellt.

Wir haben das Spiel nach bestem Wissen erstellt, können aber nicht garantieren, dass es
fehlerfrei, sicher oder für einen bestimmten Zweck geeignet ist. Prüfe es vor dem
Einsatz selbst. Betrieb und Anpassung erfolgen in eigener Verantwortung.

Es gelten die Bedingungen der beiliegenden Lizenzen. Die gesetzliche Haftung für Vorsatz
und grobe Fahrlässigkeit bleibt unberührt.