===============================================================================
  [ken's] CHAMELEON  -  Anleitung
===============================================================================

WAS IST DAS
-----------
[ken's] Chameleon ist ein Hide-and-Seek-Minigame fuer Minecraft (Fabric).

Verstecker bemalen ihren eigenen Skin Pixel fuer Pixel, nehmen eine von 18
Posen ein und rasten sich pixelgenau an Bloecke an, bis niemand mehr sieht,
dass da ein Spieler steht. Sie koennen pfeifen, Koeder-Klone aufstellen und
per Drohne durch die Map fliegen.

Sucher jagen sie mit einer Paintball-Gun. Wer getroffen wird, scheidet aus und
darf ab da zuschauen.

Nach der Runde macht jeder Verstecker ein Foto von seinem Versteck und alle
waehlen gemeinsam das beste.


HERKUNFT
--------
Die Mod ist von mir, Ken.

- Alle Assets (Modelle, Animationen, Texturen, GUI) sind zu 100 %
  von mir.
- Im Code steckt KI-Unterstuetzung.
- Das Konzept in Minecraft ist von mir.
- Die Spielidee stammt von Meccha Chameleon.


-------------------------------------------------------------------------------
1. VORAUSSETZUNGEN
-------------------------------------------------------------------------------

- Minecraft 26.2
- Fabric Loader 0.19.3 oder neuer
- Fabric API
- Java 25

WICHTIG: Die Mod muss auf dem SERVER und bei JEDEM Spieler installiert sein.
Das gesamte Aussehen (Modelle, Bemalung, Posen, Menues) wird im Client
gezeichnet - wer die Mod nicht hat, kann nicht mitspielen.


-------------------------------------------------------------------------------
2. SERVER EINRICHTEN
-------------------------------------------------------------------------------

DER EINFACHE WEG
Auf norisk.host einen Server mieten und beim Erstellen das Preset
"Meccha Chameleon" auswaehlen. Damit sind Version, Loader, Mod und eine
fertige Map schon eingerichtet - du kannst direkt bei Punkt 4 weitermachen.

Server mieten mit reflink (bei jedem kauf werde ich unterstützt - Werbung)
https://norisk.host/?ref=KEN

DER MANUELLE WEG
1. Fabric-Server fuer Minecraft 26.2 aufsetzen (Java 25).
2. Fabric API in den Ordner "mods" legen.
3. Die Chameleon-Jar in den Ordner "mods" legen.
4. Server starten.
5. Jeder Mitspieler installiert dieselbe Jar plus Fabric API in seinem
   Minecraft.

Alle Einstellungen der Mod landen in "chameleon_game.json" im Weltordner.
Sicherst du die Datei, sicherst du Maps, Lobbys und Punkte.


-------------------------------------------------------------------------------
3. ACHTUNG: NEUE SPIELER LANDEN IM TUTORIAL
-------------------------------------------------------------------------------

Wer den Server zum ERSTEN MAL betritt, kommt automatisch ins Tutorial. Das ist
so gewollt - dort lernt man Malen, Posen und Snapping in Ruhe.

Zwei Dinge musst du dazu wissen:

- Das Tutorial muss gebaut sein (siehe Punkt 7). Ist es das nicht, steht der
  Spieler im Nichts.
- RUECKTASTE GEDRUECKT HALTEN ueberspringt das Tutorial jederzeit und setzt
  den Spieler in die Lobby. Sag das deinen Gaesten, wenn du kein Tutorial
  gebaut hast.

Dieselbe Taste ist auch die Notfall-Rueckkehr, falls sich jemand irgendwo
festfaehrt.


-------------------------------------------------------------------------------
4. EINE MAP EINRICHTEN
-------------------------------------------------------------------------------

Alle Befehle brauchen Adminrechte (Permission-Level 2 / OP).
Alles passiert in EINER Welt - es werden keine extra Dimensionen gebraucht.

Schritt 1: Map anlegen
    /chameleon map create <name>
    Der Name ist der Schluessel, ohne Leerzeichen (z. B. "dorf").

Schritt 2: Startpunkt der Map setzen
    Stell dich dorthin, wo die Spieler zu Rundenbeginn stehen sollen.
    /chameleon map spawnpoint <name>
    Es gibt EINEN Punkt je Map; ein neuer ueberschreibt den alten.

Schritt 3: Lobby-Punkt setzen
    Stell dich dorthin, wo alle zwischen den Runden warten.
    /chameleon map lobby set
    Der Punkt gilt fuer den ganzen Server, nicht je Map.

Schritt 4 (optional, aber empfohlen): Feinschliff
    /chameleon map name <name> <Anzeigename>   Anzeigename mit Leerzeichen
    /chameleon map by <name> <Autor>           Map-Autor, erscheint im Menue
    /chameleon map timer <name> <ticks>        Standard-Tageszeit (wie /time set)
    /chameleon map screenshot <name>           Bild der Map fuers Menue

    Beim Screenshot stellst du dich so hin, wie die Map im Menue aussehen
    soll, und fuehrst den Befehl aus - das Bild wird von deinem Bildschirm
    aufgenommen.

Pruefen:
    /chameleon game status
    zeigt Phase, aktive Map, aktive Punkte-Lobby und alle bekannten Maps.

Weitere Map-Befehle:
    /chameleon map delete <name>
    /chameleon map reload


-------------------------------------------------------------------------------
5. EINE RUNDE STARTEN
-------------------------------------------------------------------------------

Als Admin druecke M (oder /chameleon game start). Es oeffnet sich das
Runden-Menue. Dort stellst du ein:

    - Map
    - Anzahl der Sucher
    - Verstecken-Zeit   (30 Sekunden bis 10 Minuten, Standard 2 Minuten)
    - Suchen-Zeit       (1 bis 30 Minuten, Standard 5 Minuten)
    - Automatisches Pfeifen (0 = aus, sonst alle X Sekunden pfeifen alle
      Verstecker von allein - gut gegen zu lange Runden)
    - Tageszeit und Wetter
    - Feste Rollen fuer einzelne Spieler

Dann "Runde starten".

Was danach passiert:

1. BEREIT     Alle bekommen einen Bereit-Bildschirm mit Map-Bild und
              Rollenwunsch (Egal / Verstecker / Sucher). Sind alle bereit,
              geht es los. Bestaetigt jemand nicht, bricht der Start ab.
2. VERSTECKEN Die Verstecker kommen auf die Map, die Sucher warten.
3. SUCHEN     Die Sucher werden freigelassen.
4. ENDE       Alle gefunden -> Sucher gewinnen (15 Sekunden Anzeige).
              Zeit abgelaufen -> Verstecker gewinnen, die Uebriggebliebenen
              leuchten 2:30 Minuten lang auf, damit man ihre Verstecke sieht.
5. WAHL       Alle Fotos werden gezeigt, jeder waehlt das beste Versteck
              (1 Minute). Danach 8 Sekunden Siegerbild.
6. Zurueck in die Lobby.

Rollen von Hand vergeben (jederzeit moeglich):
    /chameleon player add <spieler> verstecker|sucher|death|lobby|tutorial
    /chameleon player remove [spieler]      ohne Namen: du selbst
    Selektoren wie @a oder @s sind erlaubt.


-------------------------------------------------------------------------------
6. WAEHREND DER RUNDE
-------------------------------------------------------------------------------

Als Admin druecke M - jetzt erscheint das Runden-Menue:

    - PAUSE / WEITER          friert Timer, Bewegung und Malen ein
    - PHASE UEBERSPRINGEN     setzt die laufende Phase auf 5 Sekunden
    - PHASE VERLAENGERN       Schieber von 10 Sekunden bis 5 Minuten
    - RUNDE BEENDEN           bricht sofort ab
    - Spielerliste            Rolle einzelner Spieler im laufenden Spiel
                              wechseln

Ueberspringen und Verlaengern zeigen allen einen Hinweis an.

Wer geht und wiederkommt:
Ein Verstecker, der die Verbindung verliert, wird durch einen eingefrorenen
Klon ersetzt - gleiche Position, gleiche Pose, gleiche Bemalung. Er zaehlt
weiter als versteckt und kann abgeschossen werden. Kommt er zurueck, steht er
wieder genau dort und der Klon verschwindet. Bleibt er laenger als eine Minute
weg, faengt sein Klon an zu leuchten, damit die Runde nicht haengen bleibt.


-------------------------------------------------------------------------------
7. TUTORIAL BAUEN (optional)
-------------------------------------------------------------------------------

Das Tutorial ist ein Gang mit sechs Waenden. Hinter jeder Wand liegt ein
Bereich mit Aufgaben; ist ein Bereich geschafft, wird die naechste Wand gruen
und man kann hindurchgehen.

    /chameleon tutorial spawnpoint
        Startpunkt setzen (dort stehst du als normaler Spieler, die
        Verwandlung passiert an Wand 1).

    /chameleon tutorial setwall <1-6> <von> <bis>
        Eine Wand als Quader festlegen (zwei Ecken als Koordinaten).
        Wand 1 bis 5 fuehren in die fuenf Bereiche, Wand 6 ist der Ausgang.

    /chameleon tutorial verstecker <name>
        Fuer den letzten Bereich: Stell dich versteckt hin, in Pose und
        bemalt, und speichere dich als Vorbild. Das brauchst du fuenfmal mit
        fuenf verschiedenen Namen - diese fuenf Figuren muss der Spieler
        spaeter finden.

    /chameleon tutorial next
        Aufbauhilfe: oeffnet die naechste Wand, ohne die Aufgaben zu machen.

Die fuenf Bereiche: Bewegung, Verstecken, Malen, Extras, Suchen.


-------------------------------------------------------------------------------
8. PUNKTE UEBER MEHRERE RUNDEN
-------------------------------------------------------------------------------

Normalerweise faengt jede Runde bei null an ("Casual"). Fuer ein Turnier ueber
mehrere Runden gibt es Punkte-Lobbys:

    /chameleon lobby create <name>     neue Punkte-Lobby, wird sofort aktiv
    /chameleon lobby pause <name>      Punkte einfrieren
    /chameleon lobby resume <name>     weiterzaehlen
    /chameleon lobby end <name>        beenden
    /chameleon lobby casual            zurueck zu "jede Runde bei null"

Wie es Punkte gibt:

    Verstecker   2 Punkte je Sekunde Grundpunkte
                 dazu Naehe-Bonus: 25/Sekunde bei 1,5 Bloecken Abstand zum
                 naechsten Sucher, linear fallend bis 5/Sekunde bei 8 Bloecken
                 dazu 15/Sekunde, solange ein Sucher aus hoechstens 20
                 Bloecken in ihre Richtung schaut
    Sucher       100 bis 300 Punkte pro Fund, je frueher desto mehr
    Foto-Wahl    100 Punkte je erhaltener Stimme

Die Sucher sehen den Punktestand im Tab absichtlich 30 Sekunden verzoegert,
damit sie daran nicht ablesen koennen, wo jemand steckt.


-------------------------------------------------------------------------------
9. TASTEN FUER DIE SPIELER
-------------------------------------------------------------------------------

    E                 Verstecker-Menue (Malen und Werkzeuge)
    F halten          Posen-Rad
    C                 Snapping (pixelgenau an Bloecke anlegen)
    Q                 Klon setzen, SHIFT + Q loescht ihn
    P                 Pfeifen
    #                 Foto vom Versteck
    L                 Punkte-Board
    H                 Steuerungs-Hilfe ein- und ausblenden
    G                 in der Lobby zwischen Verstecker und Sucher testen
    M                 Menue (Admins: Runden-Menue, sonst Bereit-Bildschirm)
    RUECKTASTE halten Notfall-Rueckkehr zum Spawn / Tutorial ueberspringen
    Linksklick        als Sucher schiessen

Sneak liegt auf STRG, Sprinten auf SHIFT. Alle Debug-Tasten (F3 und die
F3-Kombinationen) sind absichtlich nicht belegt und lassen sich nicht belegen -
sonst koennte man sich Hitboxen anzeigen lassen und jedes Versteck sehen.


-------------------------------------------------------------------------------
10. ALLE BEFEHLE AUF EINEN BLICK
-------------------------------------------------------------------------------

    /chameleon game start
    /chameleon game stop
    /chameleon game status

    /chameleon map create <name>
    /chameleon map spawnpoint <name>
    /chameleon map name <name> <Anzeigename>
    /chameleon map by <name> <Autor>
    /chameleon map timer <name> <ticks>
    /chameleon map screenshot <name>
    /chameleon map delete <name>
    /chameleon map reload
    /chameleon map lobby set

    /chameleon tutorial spawnpoint
    /chameleon tutorial setwall <1-6> <von> <bis>
    /chameleon tutorial verstecker <name>
    /chameleon tutorial next

    /chameleon lobby create|pause|resume|end <name>
    /chameleon lobby casual

    /chameleon player add <spieler> verstecker|sucher|death|lobby|tutorial
    /chameleon player remove [spieler]


-------------------------------------------------------------------------------
11. WENN ETWAS NICHT GEHT
-------------------------------------------------------------------------------

Die Runde startet nicht
    Es fehlt eine Map mit Startpunkt oder der Lobby-Punkt. Pruefe mit
    /chameleon game status.

Der Server startet nicht
    Liegen zwei Chameleon-Jars im Ordner "mods"? Es darf nur eine sein.

Ein Spieler sieht keine Modelle, nur normale Skins
    Er hat die Mod nicht installiert.

Jemand haengt fest
    Ruecktaste gedrueckt halten. Notfalls
    /chameleon player remove <spieler>.

Neue Spieler landen immer im Tutorial
    So ist es gedacht. Ruecktaste gedrueckt halten ueberspringt es.


===============================================================================
  Mehr von mir:  https://www.youtube.com/@kenkanashiyt
===============================================================================