Márkák

Ez a lap arról szól, hogyan adsz a játékodnak saját arculatot és saját címet: mit állítasz be a márkán, milyen DNS-bejegyzést kér tőled a rendszer, hogyan ellenőrzi a domaint, és hogy ebből végül mit lát a játékos.

A márka a vezérlőpult negyedik szekciója (Márkák). Nem kell hozzá se szervezet, se tesztelői csoport, és a játék kiadásához sem kell — akkor jön képbe, amikor egy játékot saját néven, saját domainen akarsz kiadni.

Mit fog össze egy márka

Kettőt:

Arculatot: egy fő színt (és a belőle generált palettát), egy betűtípust és egy logó-URL-t.
Domaineket, amiket te birtokolsz. Egy márkához több domain tartozhat, és minden domain külön mondja meg, mire használjuk:

Felhasználás	Mit kapsz	Melyik cím
Játék oldal	egyetlen kiválasztott játék nyilvános bemutató oldala	`www.<a domained>`
Alkalmazások	a controller és a kijelző a te domainedről kiszolgálva	`play.<a domained>` és `view.<a domained>`

A kettő független: egy domainen bekapcsolhatod mindkettőt, de bármelyiket önmagában is. Legalább az egyik kell.

⚠ A márka nem tartozik a játékhoz, a domain igen. Magát a játékot sehol nem rendeled márkához — a kapcsolatot az teremti meg, hogy egy domainnél kiválasztod, melyik játékot mutassa. Ennek következménye van a márkás appokra, lásd A márkás alkalmazások.

Márka létrehozása

A vezérlőpult Márkák szekciójának + jele nyitja az Új márka lapot. Két mező van rajta, mindkettő kötelező:

Mező	Amit tudni kell róla
Név	Ez lesz a márka neve mindenütt: a vezérlőpult kártyáján, a bal sávban, és ez kerül a márkás appok telepített nevébe is. Később szerkeszthető.
Slug	A névből magától képződik (kisbetű, szám, kötőjel), és amint hozzányúlsz, megáll az automatikus kitöltés.

⚠ A slugot semmi nem használja, és később nem is szerkeszthető. A mező kötelező, és a mellette lévő magyarázat URL-eket ígér, de cím nem lesz belőle sehol. Fogadd el a felkínált értéket, és ne töltsd rá az időt.

A lap alján Mégsem és Create Brand. Sikeres létrehozás után azonnal a márka lapján találod magad, és a márka a bal sávban is kiválasztott entitássá válik.

Az új márka alapból a GreenCloth zöldjét kapja (#14522f), logó és betűtípus nélkül.

A márka lapja

A lap egyetlen szakaszból áll (BRAND DETAILS):

Felül a paletta csíkja: tíz mező, alattuk a fokozat számai (50 … 900). Egy mező fölé húzva a mutatót a fokozat és a hex kód buborékban látszik.
Alatta sorokban a Fő szín (színnégyzet + hex kód), a Logó URL (bélyegkép) és a Betűtípus. Az üresen hagyottak nem jelennek meg.

A lap fejlécében Edit és Delete.

⚠ A domainek nem ezen a lapon vannak, hanem a bal sávban. A márka kiválasztása után a bal sávban egy DOMAINS szakasz nyílik: benne a domainek listája (az ellenőrzöttek mellett pipa), a lista alatt pedig az Add Domain sor. A márka lapja magától egyetlen domaint sem sorol fel.

⚠ A Delete a márkát és az összes domainjét törli, egy lépésben. A megerősítő ezt ki is mondja („This will permanently delete the brand, all domains, and brand settings. This cannot be undone.”). A regisztrátornál felvett DNS-bejegyzéseidhez nem nyúl — azok megmaradnak, csak nem vezetnek többé sehova.

Szerkesztés

Az Edit a felső behúzódó sávba nyit űrlapot (Edit Brand), négy mezővel: Név, Logó URL, Fő szín, Betűtípus. Mentés a Mentés gombbal, elvetés a Cancel-lel.

Ennyi az egész arculat. Leírás, weboldal, saját paletta-fokozat: ilyen mező nincs, se itt, se máshol.

Fő szín és a paletta

Egyetlen színt adsz meg, és abból tíz árnyalat készül — pontosan az 50, 100, 200, 300, 400, 500, 600, 700, 800, 900 fokozatok:

Az 500-as fokozat maga a megadott szín, változtatás nélkül.
Az 50–400 világosodó sor: a színezet marad, a világosság rögzített (95%, 90%, 80%, 70%, 60%), a telítettség pedig fokozatosan csökken, hogy a világos árnyalatok ne rikítsanak.
A 600–900 sötétedő sor: a színezet és a telítettség marad, a világosság szorzódik (0,7 · 0,55 · 0,4 · 0,3).

Egyetlen fokozatot sem lehet külön felülírni. Nincs paletta-szerkesztő, nincs kézi hex fokozatonként: amid van, az az egy fő szín. Ha egy adott árnyalat nem tetszik, a fő színt kell arrébb vinni.

A szerkesztő két mezőt ad ugyanarra az értékre: egy színválasztó négyzetet és egy szöveges mezőt. A szöveges mezőbe kizárólag hatjegyű hex kód való, # jellel, hét karakter (#14522F) — a mező ennél többet nem is enged beírni.

⚠ Hiányos hex kódtól a paletta elromlik. Ha a mezőben félbehagyott érték marad (#14), a generálás nem áll meg és nem is szól: érvénytelen árnyalatokat számol, a paletta-csík üresen vagy össze-vissza jelenik meg. Ha a csík furcsa, először a hex kódot nézd meg, hogy teljes-e.

Betűtípus

A Betűtípus szabad szöveges mező, mellette legördülő javaslatokkal: Poppins, Inter, Roboto, Nunito, Lato, Oswald, Raleway, Montserrat. A javaslatokhoz nem vagy kötve — bármilyen Google Fonts betűcsalád nevét beírhatod, a rendszer a beírt névvel tölti be, 400/500/600/700 vastagságokkal.

⚠ Elgépelt névre nem kapsz hibát. Ha a név nem létezik a Google Fontsnál, egyszerűen nem töltődik be semmi, és marad az alapértelmezett betűtípus. A Builder ugyanezt a nevet ellenőrzés nélkül elmenti, tehát a hibát csak a márkás oldalon fogod látni.

Hol érvényesül: a márkás játékoldalon az egész oldal ezzel a betűtípussal szedődik. A márkás appokban a betűtípus betöltődik, de semmi nem használja — ott nem lesz látható változás.

Logó

A Logó URL egy kész kép teljes címe. Feltöltés itt nincs: a Builder fájlkezelője játék-szintű, a márkához nem tartozik fájltár, tehát a képet valahol másutt kell elhelyezned, és a hivatkozását beírnod.

Hol jelenik meg:

A márka lapján és a szerkesztő űrlapon kis bélyegképként — ez az egyetlen visszajelzés arról, hogy a cím jó-e. Ha a kép nem tölthető be, a bélyegkép egyszerűen eltűnik, hibaüzenet nincs.
A márkás appok telepített ikonjaként: play. és view. domainen a rendszer ebből a képből állítja elő a PWA telepítési ikonját.

⚠ A márkás játékoldal fejlécében nem ez a logó jelenik meg, hanem a játék saját logója. A márka logója és a játék logója két különböző dolog.

Domain hozzáadása

A bal sáv Add Domain sora nyitja a Domain hozzáadás űrlapot a felső behúzódó sávban.

Domain név — a domain önmagában, www. és https:// nélkül: myjatekom.hu. Érvénytelen alakra a mező pirosra vált: „Add meg érvényes domain nevet (pl. myjatekom.hu)”.
Felhasználás — legalább egy jelölőnégyzet kell, különben „Legalább egy felhasználást engedélyezz.”:
- Játék oldal (alapból bekapcsolva) — „A domain a játékod nyitóoldalára mutat”. Alatta legördülő a játékaidból; kötelező választani, különben „Válassz játékot a game routing-hoz.”
- Alkalmazások — „A játékhoz tartozó controller és display appok”.
Domain hozzáadás. Sikeres felvétel után azonnal a domain saját lapjára kerülsz, és a domain megjelenik a bal sáv listájában.

A domain ekkor Függőben állapotú: a rendszer generált hozzá egy ellenőrző tokent, és megmutatja a beállítandó DNS-bejegyzéseket.

A kért DNS-bejegyzések

Amíg a domain nincs ellenőrizve, a lapon ott áll a DNS beállítás szükséges szakasz: „Add hozzá az alábbi DNS rekordokat a regisztrátornál, majd kattints az Ellenőrzésre.” Ezt kéri:

#	Típus	Név	Érték	TTL	Mikor kell
1	TXT	`_greencloth-verify`	`"gc-verify=…"` (domainenként külön token)	600	mindig
2	CNAME	`www`	`custom.greencloth.games`	600	ha a Játék oldal be van kapcsolva
3	CNAME	`play` és `view`	`apps.greencloth.games`	600	ha az Alkalmazások be van kapcsolva

Minden érték mellett másoló ikon van. A rövid név alatt ott áll a teljes név is („ha az egész nevet kéri:”, például _greencloth-verify.myjatekom.hu) — a regisztrátorok fele az egyiket, másik fele a másikat várja.

⚠ A csupasz domainre (myjatekom.hu, www. nélkül) nincs bejegyzés a listában. A felület csak annyit mond: „Opcionálisan irányítsd át a root domaint www-re — ez a regisztrátor vagy hosting beállításaitól függ.” Ha a csupasz domain mégis eljut hozzánk, átirányítjuk a www. változatra — de hogy egyáltalán eljusson, azt neked kell megoldanod a regisztrátornál (ALIAS/ANAME rekord vagy domain-továbbítás). A www. cím önmagában is teljes értékű, a lista is arra épül.

⚠ Ellenőrzés után a szakasz eltűnik. Az ellenőrzött domain lapján a DNS-bejegyzésekből semmi nem látszik többé — a token sem —, tehát utólag a felületről nem tudod visszanézni, mit vittél fel. Ha kell, mentsd el máshova még az ellenőrzés előtt.

Ellenőrzés

A DNS-szakasz alján az Ellenőrzés gomb. Megnyomva Ellenőrzés… lesz belőle, és a szerver valódi DNS-lekérdezést csinál: kiolvassa a _greencloth-verify.<domain> TXT rekordot, és összeveti a domainhez tartozó tokennel.

Sikerül → „Domain ellenőrizve!”, majd a lap egy másodperc múlva magától újratölti magát. Az Állapot sor Ellenőrzött-re vált, a domain mellé pipa kerül a bal sávban, és a DNS-szakasz eltűnik.
Nem sikerül → a gomb pirosra vált, felirata Ellenőrzés sikertelen. ⚠ Indoklás nincs: a felület egyetlen szóval sem mondja meg, hogy a rekord hiányzik, más az értéke, vagy még nem terjedt el. Újra megnyomva újra próbálkozik. A lap alján ott az egyetlen fogódzó: „A DNS módosítások akár 24 óráig is terjedhetnek el.”

⚠ Az ellenőrzés semmit nem kapcsol be. Se a márkás játékoldal, se a márkás appok kiszolgálása nem nézi, hogy a domain ellenőrzött-e: amint a CNAME a helyére mutat, a cím működik. A TXT rekord gyakorlatilag állapotjelzőt állít, nem kaput nyit. Tehát ha a site már él, de a domain Függőben maradt, attól még minden működik — és fordítva: az Ellenőrzött állapot önmagában még nem jelenti, hogy a CNAME-ek is a helyükön vannak. Azt a Routing állapot mondja meg.

Routing állapot

A ROUTING ÁLLAPOT szakasz akkor jelenik meg, ha a domainen legalább egy felhasználás be van kapcsolva, és a lap megnyitásakor élőben lekérdezi, hogy a CNAME-ek a helyükön vannak-e:

Sor	Mikor látszik	Mit ellenőriz
`www.<domain>`	Játék oldal bekapcsolva	a `www` CNAME a `custom.greencloth.games` értékre mutat-e
`play.<domain>`	Alkalmazások bekapcsolva	a `play` CNAME az `apps.greencloth.games` értékre mutat-e
`view.<domain>`	Alkalmazások bekapcsolva	a `view` CNAME az `apps.greencloth.games` értékre mutat-e

Soronként Csatlakoztatva (zöld pipa) vagy Nincs csatlakoztatva (piros kereszt). A cím maga hivatkozás, új lapon nyílik — ez a leggyorsabb próba.

⚠ Szigorú CNAME-vizsgálat. A lekérdezés kifejezetten CNAME rekordot keres, és pontos egyezést vár. Ha a szolgáltatód „lapítja” a CNAME-et (ALIAS, ANAME, CNAME-flattening — sok helyen ez az alapértelmezés a www-re is), a sor Nincs csatlakoztatva marad akkor is, ha az oldal tökéletesen működik. Ilyenkor a hivatkozásra kattintva dől el, mi az igazság.

⚠ Magától nem frissül. Az állapotot a lap megnyitásakor kérdezi le egyszer. DNS-módosítás után töltsd újra a lapot.

A domain módosítása és eltávolítása

A domain lapjának fejlécében Beállítások szerkesztése és Eltávolítás.

A Beállítások szerkesztése ugyanazt a két jelölőnégyzetet és játékválasztót adja, mint a hozzáadáskor, alul Mentés gombbal. Szerkesztés közben a RÉSZLETEK és a ROUTING ÁLLAPOT szakasz helyét átveszi az űrlap; a fejléc Eltávolítás gombja mellé Mégsem kerül.

Ez az egyetlen hely, ahol átállíthatod, melyik játékot mutassa a domain — egy legördülő, mentés, kész. A DNS-hez nem kell hozzányúlni, az új játék azonnal él a címen.

Az Eltávolítás az alsó behúzódó sávba nyit megerősítőt, Delete domain "…"? fejléccel és a figyelmeztetéssel: „Ez eltávolítja a domaint a márkádból. A DNS rekordok változatlanok maradnak.” A Confirm Delete után a domain eltűnik a márkából, és a márka lapján kötsz ki. A regisztrátornál lévő bejegyzések takarítása a te dolgod.

Mit lát a játékos

A márkás játékoldal

A www.<domain> címen egy külön, szerver oldalon összeállított oldal fogadja a látogatót — nem a Builder, nem a controller. Ami rajta van:

Fejléc a játék címével és a játék saját logójával.
Leírás és adatok a játék adatlapjáról: Tervező, Játékosok, Játékidő, Korhatár, és a kategóriák.
Játssz most! gomb.
Szabályok hivatkozás, ha a játéknak van szabálya — a /rules aloldalra visz, ahol a szabályok formázva, szabályonként egy szakaszban olvashatók.
Galéria, ha a játéknak vannak generált kép-lapjai.
Lábléc: GreenCloth Games platformon, a greencloth.games oldalra mutatva. Ez a márkás domaineken mindig ott van, nem kapcsolható ki.

Nyelv: az oldal a ?lang=hu / ?lang=en paraméterből, e nélkül a böngésző nyelvéből dönt, és van rajta nyelvváltó. A kétnyelvű mezőidnek itt lesz haszna: a látogató a saját nyelvén kapja a címet, a leírást és a szabályokat. Lásd Miért két nyelv.

⚠ A Játssz most! gomb a GreenCloth címére visz, play.greencloth.games-re, a játékot előre kiválasztva — akkor is, ha a domainen be van kapcsolva az Alkalmazások felhasználás. A saját play.<domain> címedre az oldal sehol nem hivatkozik; azt külön kell a játékosok elé tenni.

⚠ A tartalom a vázlatból jön, nem a kiadott verzióból. Az oldal a játék aktuális vázlatának adatlapját és szabályait mutatja. Amit a Builderben átírsz, az az automentés után percen belül kint van a nyilvános oldalon, kiadás nélkül is. Ugyanezért igaz az is, hogy az oldal nem függ a nyilvánossá tételtől: azt a játékot mutatja, amelyikhez a domain tartozik, és nem nézi, van-e nyilvános verziója.

⚠ Ha a domainen a Játék oldal nincs bekapcsolva, a látogatót a greencloth.games oldalra irányítjuk át; ha be van kapcsolva, de a hozzárendelt játék nem található, „Game not found” hibát kap.

⚠ A fejléc logója rendszerint üres marad. A Builderben nincs hely, ahol a játékhoz logót lehetne rendelni, lásd A játék adatlapja.

A márkás alkalmazások

A play.<domain> a controllert, a view.<domain> a kijelzőt szolgálja ki. Ugyanaz a két alkalmazás, csak a te címedről. Amit a márka ténylegesen megváltoztat rajtuk:

A telepített alkalmazás neve és ikonja. A PWA telepítési leírója domainenként készül: a neve a márka neve, a témaszíne a fő színed, a háttere a paletta 900-as fokozata, az ikonja a logó-URL — ha megadtad, egyébként a GreenCloth ikonja marad.
A kijelző háttere a paletta 800-as fokozatát veszi fel.
A kijelző alján megjelenik a Powered by GreenCloth Games felirat.
A controller játékválasztója leszűkül a márkához rendelt játékokra.

⚠ A színek és a betűtípus ezen túl nem látszanak. Mindkét app megkapja a teljes palettát és a betűtípust, de ma alig látszik belőlük valami: egyedül a kijelző háttere veszi fel a márka színét. A controller kinézete változatlan marad, a betűtípus pedig sehol nem érvényesül. Ne ígérj a játékosnak márkázott felületet — a márkázás ma a címre, a névre, az ikonra és a kijelző hátterére korlátozódik.

⚠ A játéklista szűrése ma üres listát ad. A szűrés a márkához rendelt játékok listájával dolgozik, ilyen listát viszont a Builderben sehol nem lehet feltölteni: se a márka lapján, se a domainnél, se a játék adatlapján nincs erre felület. A lista ezért üres marad, a szűrő pedig üresre szűr — a márkás play. címen a játékos egyetlen játékot sem talál, amiből partit indíthatna. Amíg ez így van, éles használatra ne kapcsold be egy domainen az Alkalmazások felhasználást.

Amit a felület nem mond ki

Egy helyen a lap figyelmeztetései:

A domainek listája csak a bal sávban van, a márka lapján nincs.
A Slug kötelező, de semmit nem csinál, és később nem szerkeszthető.
A paletta tíz fokozata egyetlen színből készül, fokozatonként nem írható felül.
Az ellenőrzés semmit nem kapcsol be — a cím a CNAME-től működik, nem a TXT rekordtól.
Az ellenőrzés sikertelenségének indoka sehol nem látszik.
A Routing állapot szigorú CNAME-egyezést vár, és lapított rekordnál akkor is „Nincs csatlakoztatva”-t ír, ha az oldal működik.
Az ellenőrzés után a DNS-bejegyzések eltűnnek a felületről.
A márkás játékoldal a vázlatból dolgozik, és nem függ a nyilvánossá tételtől.
A Játssz most! gomb a greencloth.games controllerére visz, nem a saját play. címedre.
A márkás appokon a szín és a betűtípus alig látszik, a játéklista szűrése pedig ma üres listát ad.
A márka törlése az összes domaint is viszi, visszavonhatatlanul.