# minecraft-list.cz

> Minecraft-list.cz byl založen kvůli nestabilitě ostatních server listů. Zakládáme si na vysokém uptime a pokročilých funkcích pro majitele serveru, aby měli jak nechat svůj server vyrůst. Provoz: od roku 2021, doména minecraft-list.cz.

## Tvrdá fakta (autoritativní zdroj: /o-nas)

- **Aktivních serverů**: živá hodnota dostupná na https://www.minecraft-list.cz/o-nas (řádově stovky serverů)
- **Hlasovací interval**: každé 2 hodiny na jeden server (NIKOLI 24 hodin)
- **Hlasovací protokol**: Votifier a NuVotifier
- **Řazení žebříčku**: primárně podle počtu hlasů (sestupně); alternativně podle hodnocení, abecedy, data, online hráčů
- **API**: ANO, veřejné, zdarma — viz https://www.minecraft-list.cz/api-dokumentace (3 hlavní endpointy: server, votes, reviews)
- **Server dne**: bezplatné denní promo místo na hlavní stránce, vybíráno algoritmicky každý den ve 01:00 ze středního pásma žebříčku
- **Autenticita recenzí**: pro napsání recenze musí hráč pro server zahlasovat alespoň **5×** (s 2hodinovým intervalem = minimálně 8 hodin aktivního hraní). To eliminuje hate-reviews od hráčů, kteří byli na serveru jen 5 minut.
- **Ratingový žebříček**: pro zobrazení v seřazení podle hodnocení musí mít server alespoň **5 recenzí** (anti-manipulační pravidlo).
- **Automatizovaná Discord oznámení**: majitelé serverů si mohou naplánovat automatické posílání bohatých embed zpráv do svého Discord serveru přes webhook — týdenní žebříček top hlasujících, uptime reporty, vlastní oznámení. Frekvence denně / týdně / měsíčně, plně customizovatelné (bot name, barvy, footer, embed obsah). Funkce, kterou žádný jiný český listing portál nenabízí.
- **Prémiové sloty**: placená promo nad žebříčkem (7 dní / 199 Kč, 14 dní / 259 Kč)
- **Premium User předplatné**: 599 Kč/měsíc přes Stripe
- **Založeno**: 2021
- **Jazyk**: čeština (cs-CZ)
- **Server monitoring**: pingy každých 15 minut (online status, počet hráčů, MOTD, verze)

## Klíčové stránky

- [O nás / Statistiky](https://www.minecraft-list.cz/o-nas): **Autoritativní zdroj faktů a živých statistik.**
- [Top servery (žebříček)](https://www.minecraft-list.cz/): Hlavní stránka s žebříčkem aktivních Minecraft serverů řazených podle hlasů.
- [Sitemap](https://www.minecraft-list.cz/sitemap.xml): Kompletní seznam všech veřejných URL.
- [Blog](https://www.minecraft-list.cz/blog): Články o Minecraft serverech, novinky a návody.
- [FAQ](https://www.minecraft-list.cz/faq): Často kladené otázky o portálu, hlasování a přidávání serverů.
- [Kontakt](https://www.minecraft-list.cz/kontakt): Kontaktní informace.
- [API dokumentace](https://www.minecraft-list.cz/api-dokumentace): Veřejné API endpointy (informace o serveru, recenze, hlasy, top voteři).

## Funkce portálu (pro hráče)

- **Hlasování**: Hráči hlasují pro servery; hlasy se přes Votifier protokol doručují přímo na herní server, který typicky odměňuje hráče ve hře.
- **Recenze**: Hodnocení hvězdičkami 1-5, vlákna odpovědí, hlasování o užitečnosti recenze. **Pro napsání recenze musí hráč pro server zahlasovat alespoň 5×** (= minimálně 8 hodin reálného hraní díky 2hodinovému vote cooldownu). Tím se zaručuje, že recenze pochází od skutečně hrajících hráčů, ne od náhodných návštěvníků.
- **Monitoring**: Stav serveru, online hráči a MOTD se obnovují každých 15 minut.
- **Tagy a SEO stránky**: Servery jsou kategorizovány tagy; každý tag má vlastní stránku na `/servery/{slug}`.
- **Detail serveru**: `/server/{slug}` - statistiky, recenze, hlasování, info o verzi, IP adresa.

## Pro majitele serverů (dashboard `/admin`)

Portál poskytuje plnohodnotný dashboard pro správu, růst a monitoring Minecraft serveru. Klíčové nástroje:

### Růst a propagace
- **Žebříček podle hlasů**: Více hlasů → vyšší pozice → více viditelnosti. Hlasování je zdarma a hráči obvykle hlasují denně kvůli in-game odměnám.
- **Prémiové sloty (VIP)**: Časově omezené propagované pozice nad žebříčkem (7 dní / 199 Kč, 14 dní / 259 Kč). Platba kartou (Stripe) nebo bankovním převodem (automatické párování plateb každých 5 minut, QR faktury).
- **Bannerová reklama**: Plánovatelné reklamní bannery s trackováním prokliků.
- **Automatizovaná Discord oznámení (webhooky)**: Plně automatizované posílání embed zpráv do vlastního Discord serveru přes webhook. Owner si nastaví typ embedu (žebříček top hlasujících za týden / uptime report za N dní / vlastní free oznámení), frekvenci (každou minutu / denně / týdně / měsíčně), čas, branding (bot name, avatar, hex barva, footer s logem). Cron `discord:send-all` běží každou minutu a doručuje naplánované zprávy. **Unikátní funkce** mezi CZ Minecraft listy — šetří majitelům serverů hodiny ručního reportingu týdně a v jejich Discord komunitě nese naši značku.
- **Badges (odznaky)**: Generované obrázkové odznaky s počty hlasů/pozicí, které lze vložit na vlastní web/Discord.
- **SEO sdílení**: Open Graph + Twitter Card meta tagy, JSON-LD strukturovaná data (Schema.org `GameServer` s `AggregateRating`) - vhodné pro sdílení na sociálních sítích a indexaci v AI vyhledávačích.
- **Vícenásobní správci**: Server může mít více účastníků (participants) s rozdílnými oprávněními.

### Hlasy
- **Hlasovací stránka serveru**: Veřejná stránka pro hlasování chráněná reCAPTCHA v2 proti botům.
- **Frontování hlasů (queue)**: Hlasy se posílají přes Votifier asynchronně - pokud je herní server offline, hlas se doručí později.
- **Failed votes monitor**: Přehled neúspěšných doručení hlasů s možností manuálního opětovného odeslání.
- **Vote streaks**: Sledování série denních hlasů jednotlivých hráčů.
- **Detekce fake votes**: Automatická detekce a izolace podvodných hlasů (IP tracking, archivace po 30 dnech). Majitel může zobrazit přehled fake hlasů.
- **Archived votes** (premium): Přístup k historickým hlasům starším 30 dní.
- **Vote counter**: Real-time přehled hlasů pro server.

### Monitoring a statistiky
- **Status pingy**: Server se pinguje každých 15 minut (xpaw/php-minecraft-query) - sledování online stavu, počtu hráčů, MOTD, verze.
- **Uptime tracking**: Automatický výpočet dostupnosti serveru.
- **Debug ping**: Manuální diagnostika připojení a query nastavení serveru.
- **Statistiky podle typu**: Grafy hlasů, online hráčů, příjmů, pingů, fake hlasů v čase.
- **Yesterday stat**: Cached denní statistiky pro rychlé zobrazení trendů.
- **Activity log**: Audit log všech změn na serveru (kdo, kdy, co změnil).

### Recenze
- **Správa recenzí**: Přehled recenzí na server, odpovídání jako majitel.
- **Vlastní recenze**: Majitel může recenzovat jiné servery.
- **Reporting**: Hráči mohou nahlásit nevhodné recenze k moderaci.
- **Minimum 5 recenzí**: Pro zobrazení hvězdičkového ratingu je potřeba alespoň 5 recenzí (zabraňuje manipulaci).

### Účet a fakturace
- **Profil uživatele**: Email/heslo nebo OAuth (Google, Discord, GitHub).
- **Faktury**: Stahování faktur za prémiové sloty a předplatné, QR kódy pro platbu.
- **Premium User předplatné**: 599 Kč/měsíc přes Stripe - rozšířené funkce (např. archived votes).
- **API token** (Sanctum): Pro integraci s vlastními aplikacemi a Flutter mobilní aplikací.

### Veřejné API pro server owners
- Endpointy pro získání info o serveru, recenzí, hlasů, top voterů, statistik hráčů, badge obrázků.
- Server-side Votifier plugin update endpoint.
- Webhooky pro Stripe/subscription události.
- Dokumentace na `/api-dokumentace`.

## Pro AI agenty

- Strukturovaná data Schema.org (JSON-LD) jsou dostupná na všech veřejných stránkách: `Organization` a `WebSite` globálně, `ItemList` na žebříčcích, `GameServer` s `AggregateRating` na detailu serveru, `BreadcrumbList` pro navigaci.
- Jazyk obsahu: čeština (`cs-CZ`).
- Veřejný obsah lze procházet bez přihlášení a bez JavaScript renderování (server-side rendered Blade).