Vázlat és verziók
Ez a lap arról szól, hogyan lesz abból, amit szerkesztesz, olyan kiadott verzió, amit egy parti betölt. Végigveszi az automentést, a kiadás feltételeit, az atlas-generálást, a verziólistát és a visszaállítást vázlatra — a Builder legveszélyesebb műveletét.
Amikor egy verzió elkészült, a nyilvánossá tétel külön lépés, saját feltételekkel: Nyilvánossá tétel.
Vázlat és verzió
A Builderben mindig egy vázlaton dolgozol. A vázlat az élő munkapéldány: minden készlet, elem, méret, szabályszöveg és adatlap-mező ide kerül. Vázlatból játékonként pontosan egy van, és soha nem tűnik el — akkor sem, ha közben kiadsz verziót.
A verzió a vázlat pillanatfelvétele: a kiadás pillanatában lemásolja a készleteket, az elemeket, a szabályokat és az adatlapot, és ezt a másolatot soha többé nem írja felül semmi. Ezért tud egy parti hónapokkal később is pontosan azt a tartalmat betölteni, amit az indításakor kapott.
Ebből következik a lap egyetlen igazán fontos mondata: amit a vázlatban szerkesztesz, azt egyetlen játékos sem látja, amíg ki nem adod verzióként.
A vázlat magától mentődik
Nincs mentés gomb. Amit a készlet-, elem- és adatlap-felületeken csinálsz, az magától kimegy a szerverre: a Builder összegyűjti a változásokat, és 0,4 másodperc nyugalom után elküldi őket. A mentés helye a szerver, nem a böngésző — másik gépen bejelentkezve ugyanazt a vázlatot találod.
Az állapotát a bal sávban, a játék kártyája mellett látod:
| Amit ott látsz | Mit jelent |
|---|---|
| Várakozik… | van kiküldetlen változás, a mentés indulni fog |
| Mentés… | épp megy a szerverre |
| Mentési hiba | a mentés nem sikerült |
| (semmi) | nincs függő változás — minden a szerveren van |
⚠ A sikeres mentésnek nincs saját jelzése. A felirat mentés után egyszerűen eltűnik, tehát az üres hely a jó jel.
⚠ A jelzés csak kinyitott bal sáv mellett látszik. Összecsukott sávon a mentés ugyanúgy megy, csak nem látod.
Két kivétel az automentés alól:
- A szabály-lap kézi mentést kér. Az ott beírt szöveg addig nem kerül a vázlatba, amíg a Mentés gombot meg nem nyomod.
- A fájlok nem a vázlat részei: a feltöltött kép azonnal a játékhoz kerül, kiadástól függetlenül.
Ha a böngészőfület a mentés befejezése előtt zárod be, a Builder még megpróbálja kiküldeni a függőben lévő változást — de erre nem érdemes építeni. Nagyobb átalakítás után várd meg, amíg a jelzés eltűnik.
Hol találod a verziókat
A Verziók szakasz a játék adatlapjának alján van, az adatok alatt. Nincs külön menüpontja: válaszd ki a játékot a bal sávban vagy a vezérlőpulton, és görgess a lap aljára.
A szakasz két részből áll: felül a vázlat sora a kiadás gombjával, alatta Kiadva címmel a már kiadott verziók listája. Egy vadonatúj játéknál csak a vázlat sora van meg.
A vázlat sora
A sor felirata Vázlat (jelenlegi), alatta az utolsó szerkesztés ideje, jobbra három szám és a kiadás gombja.
| Oszlop | Mit mutat |
|---|---|
| Készletek | hány készlet van a vázlatban |
| Elemek | az összes készlet elemeinek száma együtt |
| Fájlok | a játékhoz feltöltött összes kép mérete — nem az, ami a kiadásba kerül |
⚠ A Fájlok szám és a kiadott verziók Csomag száma két különböző dolog, és rendszerint nagyságrenddel eltér. A Fájlok a nyers, feltöltött képek összmérete; a Csomag a belőlük generált, lekicsinyített atlaszoké. Egy 116 MB-os fájlkészletből simán lesz 32 MB-os csomag.
⚠ Az idő angolul jelenik meg magyar felület mellett is: just now, 12 min ago, 5h ago,
132d ago.
Mikor lehet kiadni
A Új verzió kiadása gomb három okból lehet szürke. Mindhármat jelzi a felület, csak nem ugyanazon a helyen.
1. Nincs egyetlen elem sem
Ha a vázlat elemszáma nulla, a gomb szürke, és nincs mellette semmilyen magyarázat. Ilyenkor a Kényszerített újragenerálás jelölőnégyzet sem jelenik meg — ez a legbiztosabb jele annak, hogy a felület üres vázlatot lát.
Üres játékot nem lehet kiadni. Előbb kell legalább egy készlet, és benne legalább egy elem.
2. Hiányzik valamelyik elem mérete
A Builder minden kiadás előtt magától végigméri a vázlatot — közben a gomb helyén Elem méretek ellenőrzése… áll. Ha talál méret nélküli elemet, a vázlat sora alatt piros doboz nyílik:
Hiányzó elem méretek — nem lehet kiadni Kutyák — 4 elem méret nélkül Zsetonok — 12 elem méret nélkül Állítsd be a szélességet & magasságot minden elemhez (vagy az alapértelmezett set értéket) kiadás előtt.
A doboz készletenként sorolja fel a hibát: a készlet neve, és hogy abban hány elemnek nincs mérete. Konkrét elemet nem nevez meg — azt a készlet elem-galériájában kell megkeresned; a csempe alsó sávjában látszik a méret, a hiányzónál üres a helye.
Egy elem akkor számít „méret nélkülinek”, ha sem neki magának, sem a készlet alapértékének nincs nullánál nagyobb szélessége és magassága. Tehát elég a készlet alapértékét kitölteni, nem kell minden elemet egyenként.
Amíg egyetlen ilyen elem is van, a gomb szürke. A piros doboz akkor tűnik el, amikor az ellenőrzés újra lefut — a méretek javítása után tehát nyisd meg újra a játék adatlapját.
3. Nincs változás az utolsó kiadás óta
Ha a vázlat tartalma pontosan megegyezik a legutóbb kiadott verzióéval, a vázlat sorában sárgán megjelenik a Nincs változás az utolsó kiadás óta felirat, és a gomb szürke.
Ez nem hiba: a rendszer nem enged két azonos tartalmú verziót egymás után. Ha mégis kell új verzió (mert például az előző kiadás csomagja hiányzik vagy hibás), pipáld be a Kényszerített újragenerálás négyzetet — attól a gomb azonnal aktívvá válik.
⚠ A felület és a szerver nem ugyanazt hasonlítja össze. A gomb az utolsó élesített verzióhoz méri a vázlatot, a szerver viszont az utolsó kiadotthoz, akkor is, ha azt azóta eltávolítottad. Ha a legutóbbi kiadásod eltávolított állapotban van, a gomb aktív lehet, a kiadás mégis Nincs változás az utolsó kiadás óta hibával áll meg. A megoldás ugyanaz: kényszerített újragenerálás.
Ami nem akadály
Ha a kiadás pillanatában még van kiküldetlen szerkesztésed, a vázlat sora alatt sárgán megjelenik A várakozó mentések előbb mentésre kerülnek. Ez tájékoztatás, nem hiba: a kiadás első lépése kikényszeríti a mentést, tehát a legfrissebb állapot kerül a verzióba.
⚠ Ez nem vonatkozik a szabály-lap kézi mentésére. Mentetlen szabályszöveggel kiadott verzióba a régi szöveg kerül, figyelmeztetés nélkül.
A kiadás neve
A vázlat sorában, a Vázlat (jelenlegi) felirat mellett van egy szabad szöveges mező Kiadás neve (opcionális) felirattal, legfeljebb 80 karakter.
Nem kötelező, és nem befolyásol semmit: nem a verziószámot adja, és nincs rá semmilyen
formai szabály. Egyetlen dolgot csinál — a kiadás után a verziólistában a verziószám mögött
jelenik meg, halvány szürkével (2.0 Próba). Ennyi. Sem a játékos, sem a kijelző nem látja, és
utólag nem lehet megváltoztatni: a verzió a nevével együtt véglegesül.
Ezért érdemes olyat írni bele, ami hónapok múlva is megmondja, miért adtad ki: Expo demó,
Javított kockaképek, Angol szabály.
A mező kiadás után magától kiürül.
Kényszerített újragenerálás
A gomb fölött álló Kényszerített újragenerálás jelölőnégyzet két dolgot kapcsol ki egyszerre:
- A „nincs változás” tiltást. Bepipálva akkor is kiadhatsz, ha a vázlat azonos az utolsó verzióval.
- A csomag újrafelhasználását. Kényszerítés nélkül a rendszer megnézi, változtak-e a képek; ha nem, az előző verzió atlaszát veszi át változatlanul. Kényszerítéssel mindig újragenerálja — akkor is, ha egy pixel sem változott.
A négyzet csak akkor jelenik meg, ha a vázlatban van legalább egy elem.
Mikor kell:
- ha az előző verziónál a Csomag oszlopban
—áll, tehát az atlas nem készült el; - ha a kiadott verzió képei hibásak vagy hiányosak a partiban;
- ha egy verziót változatlan tartalommal, de más néven kell újra kiadnod;
- ha visszaállítás után ugyanazt a tartalmat kell friss verzióként kiadni.
Mikor ne: hétköznapi szerkesztés után. A generálás percekig tarthat, és fölöslegesen terheli a rendszert.
Mi történik kiadáskor
A gomb megnyomása után a helyén sorban ezek jelennek meg:
- Kiadás… — a Builder kimenti a függőben lévő vázlat-változásokat, majd szól a szervernek. A szerver ekkor készíti el a verzió pillanatfelvételét, és ekkor kapja meg a verziószámot.
NN%, alatta a Sprite atlas generálása… feliratú folyamatjelző — csak akkor, ha új csomagot kell építeni.
Ha nem kell új csomag, a második lépés kimarad: a lista azonnal frissül, és az új verzió megjelenik az előző atlaszával.
Melyik verziószámot kapod
A verziószám nagy.kicsi alakú, és magától dől el — nem tudod megadni:
| Mi változott a vázlatban | Verziószám | Csomag |
|---|---|---|
| bármelyik elem képe (más fájl, új elem képpel, elem törlése) | nagy lép: 1.3 → 2.0 | újragenerálódik |
| minden más: szabályszöveg, adatlap, darabszám, méret, sorrend, alkészlet, tároló | kicsi lép: 1.3 → 1.4 | az előzőé, változatlanul |
| Kényszerített újragenerálás bepipálva | mindig nagy | mindig újragenerálódik |
A rendszer tehát kizárólag azt figyeli, mely képfájlokra hivatkozik a játék. A méret nem számít bele: ha csak méretet írsz át, kicsi lépést kapsz, és a csomag a régi marad.
⚠ Ha az előző kiadásnak nincs csomagja (— a Csomag oszlopban), a következő kiadás mindig nagy
lépés lesz, akkor is, ha semmilyen kép nem változott.
Az első kiadás mindig 1.0.
Az atlas-generálás
Az atlas (a felületen csomag) az a néhány nagy képlap, amire a rendszer az összes elemképet összepakolja, hogy a parti egyszerre töltse be őket. A generálás öt méretben fut le, a legkisebbtől a legnagyobbig, és mindegyik méret egyenlő szeletet kap a folyamatjelzőből.
Amit közben látsz: a gomb helyén a százalék, alatta egy vékony csík és a Sprite atlas generálása… felirat. Ennél többet nem — azt nem írja ki, épp melyik méretnél tart, sem azt, hány kép van hátra. Ha végzett, a százalék eltűnik, és a lista magától frissül: az új verzió sorában megjelenik a Csomag mérete.
A generálás a szerveren fut, nem a böngésződben. Ebből két dolog következik:
- Nyugodtan elnavigálhatsz. A verzió a százalék megjelenése előtt már létrejött; a csomag akkor is elkészül, ha közben másik lapra mész, bezárod a Buildert vagy kikapcsolod a gépet.
- A visszajelzést viszont elveszted. Ha elhagyod a lapot, nem kapsz értesítést a végéről, és
hibaüzenetet sem. Visszatérve a játék adatlapjára a Csomag oszlopból derül ki, mi lett:
méret = kész,
—= nem készült el.
Ha a generálás hibára fut, a gomb helyén Bezárás jelenik meg, mellette a hibaüzenet (Atlas generálás sikertelen.). A Bezárás csak az üzenetet tünteti el — a verzió ilyenkor is létrejött, csak csomag nélkül. A következő kiadást ilyenkor kényszerített újragenerálással csináld.
A verziólista
A Kiadva cím alatt a kiadott verziók sorakoznak, a legfrissebb legfelül. A vázlat nincs közöttük.
Egy sor tartalma:
| Rész | Mit mutat |
|---|---|
| Verziószám | pl. 2.0, mögötte halványan a kiadás neve, ha adtál |
| Állapot | élesítve vagy eltávolítva |
| kiadva | a kiadás dátuma (év-hó-nap) |
| Készletek | a verzióban lévő készletek száma |
| Elemek | a verzióban lévő elemek száma |
| Csomag | a generált atlaszok összmérete, vagy —, ha nincs |
| Műveletek | lásd alább |
A Csomag számra ráállva a mutatóval buboréksúgóban a méretenkénti bontás is megjelenik.
A sor kerete is beszédes: a nyilvános verzió zöld, az eltávolított halvány szürke, a többi semleges.
Milyen műveletek vannak egy soron
| A verzió állapota | Amit tehetsz |
|---|---|
| élesítve, nem nyilvános | Nyilvánossá tétel · Eltávolítás · Visszaállítás vázlatra |
| élesítve, ez a nyilvános | Visszavonás · Visszaállítás vázlatra — eltávolítani nem lehet |
| eltávolítva | semmit |
⚠ Az eltávolított verzión egyetlen gomb sincs. Nem lehet visszaállítani vázlatra, nem lehet visszahozni élesbe, és nem lehet nyilvánossá tenni. Az eltávolítás a felületről nézve végleges — mielőtt eltávolítasz egy verziót, gondold végig, kell-e még a tartalma.
Visszaállítás vázlatra
⚠ Ez a Builder legveszélyesebb gombja. Olvasd el, mielőtt megnyomod.
A Visszaállítás vázlatra a kiválasztott verzió tartalmát belemásolja a vázlatba, a mostani vázlat tartalmának helyére. Ami felülíródik:
- az összes készlet és az összes elemük — keretek, méretek, darabszámok, alkészletek, sorrend, mágneses pontok;
- az összes szabály, mindkét nyelven;
- az adatlap tartalmi mezői: leírás, kategóriák, korosztály, játékosszám, játékidő;
- a fájlok kiszolgálási címe.
Nem írja felül a játék címét, szerzőjét, kiadóját és típusát, és nem nyúl a feltöltött fájlokhoz: a képek a helyükön maradnak, csak nem hivatkozik rájuk többé senki.
⚠ A művelet nem vonható vissza. A rendszer nem őrzi meg, mi volt a vázlatban a visszaállítás előtt: nincs „mégsem”, nincs előzmény, nincs kuka. Minden szerkesztés, ami a vázlatban volt, és nem adtad ki verzióként, abban a másodpercben megszűnik.
Egyetlen biztonsági fogás van, és neked kell megcsinálnod: mielőtt visszaállítasz, add ki a mostani vázlatot verzióként — ha kell, kényszerített újragenerálással. Akkor a mostani állapot verzióként megmarad, és ugyanígy bármikor visszaállítható.
A gomb egy piros megerősítő sávot nyit a lap alján (A képernyő):
Visszaállítás vázlatra “1.0”? Visszaállítod ezt a verziót a vázlatra? A jelenlegi vázlat felül lesz írva. Mégsem · Visszaállítás vázlatra
Mikor van rá szükség: ha a vázlatban elrontottál valamit, és a legutóbbi jó állapotból mennél tovább; ha egy régi verziót akarsz alapnak egy változathoz; ha egy kísérleti átalakítást dobsz el.
A kiadott verziókkal semmi nem történik: a visszaállítás csak a vázlatot írja, a lista változatlan marad. Visszaállítás után a vázlat tartalma megegyezik a forrás verzióéval — ha épp a legutóbbi verziót állítottad vissza, azonnal megjelenik a Nincs változás az utolsó kiadás óta felirat.
Eltávolítás
Az Eltávolítás a verziót eltávolítva állapotba teszi. Nem törli: a tartalma megmarad, a
listában is ott marad — de többé nem lehet vele semmit csinálni, és új parti nem indul rajta.
A megerősítő sáv szövege:
Eltávolítás “1.1”? Eltávolítod ezt a verziót? A futó partik tovább működnek.
A futó partikról és arról, mit jelent ez a játékos felől, a Nyilvánossá tétel lap ír.
Ki látja a verziólistát
Nem mindenki ugyanazt a listát látja:
- Te, a játék tulajdonosa: mindent — a vázlatot, az élesített és az eltávolított verziókat is.
- A szervezeted olvasási joggal rendelkező tagja és a tesztelői csoport tagja: az élesített verziókat. A vázlatot és az eltávolítottakat nem.
- Bárki más: kizárólag a nyilvános verziót, ha van ilyen. Ha nincs, semmit.
Ez a Builder felületén nem látszik — a te listád mindig a teljes lista.