Wiki Ozvěny

Začínáme

1. Zaregistruj účet a potvrď e-mail.
2. Vytvoř lobby nebo vyber čekající veřejnou lobby.
3. Pošli spoluhráči kód a heslo.
4. Po připojení druhého hráče hra začne automaticky.

Účet, ověření e-mailu a heslo

Účet uchovává profil, statistiky, historii, mapy, hodnocení a fórum. Nový účet musí potvrdit odkaz doručený e-mailem. Odkaz platí 24 hodin; nový lze poslat z profilu.

Zapomenuté heslo

V přihlašovacím okně zvol „Zapomenuté heslo“. Odkaz pro změnu platí jednu hodinu a po použití odhlásí všechna starší zařízení. Systém nikdy e-mailem neposílá původní heslo.

Profilové údaje

Profil obsahuje bio, veřejný titul, viditelnost, profilový akcent, banner, barvu avataru, achievementy, počet her, výher, úspěšnost, celkový počet tahů a vytvořené mapy. Veřejná adresa profilu má tvar /u/jmeno.

Vytvoření a připojení do lobby

Heslo se do pozvánky nikdy nevkládá a musí se poslat zvlášť. Po výpadku zůstává místo hráče 90 sekund rezervované; návrat proběhne automaticky pomocí účtu a herního tokenu.

Průběh hry

Každý tah vybírají oba hráči současně směr nebo čekání. Tah se vyhodnotí až po obou volbách. Cílem je sesbírat v budoucnosti tři ozvěny a dojít do portálu před vyčerpáním limitu tahů.

• Skála je neprůchozí v obou epochách.
• Barevná bariéra se otevře jen aktivním spínačem stejné barvy.
• Minulost musí spínač držet po celý tah, ve kterém Budoucnost prochází.
• Stav se druhému hráči synchronizuje přibližně do 0,3 sekundy.

Asymetrické role

Každá role navíc obdrží soukromou nápovědu. Je na hráčích, kolik z ní druhému prozradí.

Skutečné důsledky v čase

Mlžná mapa

V mlžném režimu jsou viditelná pouze pole do vzdálenosti dvou kroků od postavy. Mlha nemění pravidla ani kolize, pouze dostupné informace. Volbu lze nastavit jen při vytváření lobby a po startu ji nelze změnit.

Rychlé signály

Kanál nabízí zprávy Počkej, Jdi, Pozor, Díky a tři barvy. Signály nestojí tah a druhému hráči se objeví téměř okamžitě. Proti spamu je mezi nimi krátká prodleva.

Editor a komunitní mapy

Editor nabízí skálu, gumu, undo/redo, drafty a přepínání náhledu Minulosti a Budoucnosti. Draft si můžeš uložit soukromě, později načíst a publikovat až po doladění. Tlačítko Otestovat provede stejnou serverovou kontrolu jako publikace:

• ověří dosažitelnost všech ozvěn, spínačů, zdrojů a portálu,
• odmítne skálu na herním objektu,
• odmítne příliš malou průchozí oblast,
• omezí mapu na 20 skal.

Ověřenou mapu lze hodnotit jednou až pěti hvězdami; hodnocení můžeš později změnit.

Sezóny, žebříčky, achievementy a denní výzva

Žebříček sleduje sezónní výhry, nejlepší počet tahů, celkovou úspěšnost a aktuální sérii výher. Denní výzva má pro všechny stejnou variantu mapy a limit 20 tahů; pořadí určuje nejlepší vítězný výsledek. Achievementy odemyká první dokončená hra, první výhra, výhra na hraně času, publikovaná mapa, přátelství a denní výzva.

Fórum, kategorie a moderace

Číst může každý, psát jen přihlášený a e-mailem ověřený účet. Témata mají kategorie Obecné, Strategie, Mapy, Chyby a Oznámení; administrátor je může připnout. Hra má také úvodní onboarding, zvukové efekty a uživatelská nastavení pro animace, kontrast a kompaktní UI. Nevhodné téma nebo odpověď lze nahlásit s důvodem. Moderátor může obsah skrýt, téma uzamknout, hlášení vyřešit nebo zablokovat účet.

Profily, přátelé, historie a oznámení

Historie ukazuje dokončené výpravy, roli, spoluhráče, výsledek a počet tahů. Veřejné profily ukazují statistiky, achievementy, mapy a poslední hry podle nastavené viditelnosti. Přátelé umožňují udržovat seznam spoluhráčů a později se k nim rychle vracet. Oznámení vznikne při připojení spoluhráče, dokončení hry, odchodu hráče, ověření účtu, odpovědi ve tvém tématu, žádosti o přátelství a odemčení achievementu.

PWA režim a hudba

Na HTTPS doméně lze Ozvěnu nainstalovat jako aplikaci. Statické rozhraní funguje z cache, ale multiplayer vždy vyžaduje internet a odpovědi API se nikdy neukládají. Ambientní hudba se generuje přímo v prohlížeči a zapíná ikonou noty.

Administrace

Panel je rozdělený do kategorií Přehled, Uživatelé, Komunita, Moderace, Mapy, Hry a Systém. Přehled navíc obsahuje admin cockpit se stavem databáze, mailu, aktivních her, hlášení a stagnujících her.

• Uživatelé: blokace, role, ruční ověření e-mailu, mazání účtů a ukončení relací.
• Komunita: achievementy, poslední oznámení a hromadné oznámení všem hráčům.
• Moderace: hlášení, skrývání, zamykání a mazání obsahu.
• Mapy a hry: publikace, smazání mapy, kontrola draftů a ukončení opuštěné hry.
• Systém: PHP, databáze, rozšíření, mail, konfigurace, údržba a spuštění nové sezóny.

UPDATE echo_users SET is_admin=1 WHERE username='TvojeJmeno';
php tests/smoke.php

Instalace na server

1. Vytvoř MySQL/MariaDB databázi a importuj install.sql.
2. V config.php nastav databázi, HTTPS base_url a platný mail_from.
3. Ověř, že hosting podporuje PHP 8.1+, PDO MySQL a funkci mail().
4. Nahraj všechny soubory a zapni HTTPS.
5. Stávající instalace aktualizuj migracemi v pořadí v2 až v9.

Apache používá dodaný .htaccess pro friendly URLs. Na Nginxu nastav try_files $uri $uri/ /index.php?$query_string;. Po nasazení spusť php tests/smoke.php a proveď tvrdé obnovení kvůli service workeru.

Řešení problémů