Když něco nehraje

Každá z těchhle věcí se doopravdy stala, a je napsaná tak, jak ji uvidíš, ne jako kategorie.

Soubor je pro jiný loader nebo jinou verzi Minecraftu. Ta čtyři jména se liší přesně těmi dvěma slovy a je snadné vzít ze seznamu špatné. Loader to obvykle o pár řádek dřív říká sám, svými slovy.

Na Fabricu k tomu chybívá Fabric API — bez něj se mod nenačte a Fabric to napíše.

Keystone má vlastní oprávnění a schválně nečte operátorskou úroveň Minecraftu — aby „smí restartovat server" a „smí létat" byly dvě různé otázky. Z konzole, která smí vždycky:

keystone permission group admin add <tvoje jméno>

Na 0.1.0 tu skupinu musíš nejdřív vyrobit — jediná, která na čerstvém serveru existuje, je default a jsou v ní všichni:

keystone permission group admin create 100
keystone permission group admin allow keystone.*
keystone permission group admin add <tvoje jméno>

Od 0.1.1 už admin existuje s keystone.* a je prázdná, takže stačí ta jedna řádka.

Pozor na to slovo uprostřed: je to permission group, ne group.

/keystone panel staví odkaz z adresy, na které lokální API poslouchá — a ta je ve výchozím stavu 127.0.0.1, tedy stroj, kde běží server. U hostovaného serveru máš dvě cesty:

Tunel — nic nevystavuješ a je to ta bezpečnější:

ssh -L 25586:127.0.0.1:25586 ty@tvuj-server

Nebo (od 0.1.1) řekni modu, kudy se k němu chodí. Když API posadíš na 0.0.0.0, aby na něj šlo dosáhnout odjinud, samotný odkaz by vyšel jako http://0.0.0.0:25586/…, což se neotevře nikde. Od toho je api.reachable-at:

/keystone set keystone.api.reachable-at 192.168.1.100

Prázdné a poslouchající na skutečné adrese → použije ji. Prázdné a poslouchající na 0.0.0.0 → zeptá se stroje na jeho vlastní adresu. Vyplněné vyhrává, což je to, co potřebuješ za routerem, v tunelu nebo pod jménem, které jsi tomu stroji dal. Nový odkaz se skládá až ve chvíli, kdy si o něj řekneš, takže změna platí hned.

Než API pustíš mimo loopback, přečti si Lokální API. Umí všechno, co umí mod.

Pak klikni na odkaz znovu — na nový, protože platí pět minut a funguje jednou. Když port není 25586, změnil jsi ho, a konzole při startu říká, na kterém poslouchá.

Tři věci, v pořadí, ve kterém se kazí:

1. Token bota je prázdný. Je to tajemství, takže editor ukáže, jestli je vyplněný, a nikdy čím.
2. Bot nemá Message Content nebo Server Members. Obojí jsou přepínače na aplikaci, kde jsi bota vyrobil, a bez nich se bot připojí a neslyší nic — což vypadá úplně stejně jako být offline.
3. ID kanálů patří serveru, na kterém bot není.

Konzole při startu modulu řekne, která z těch tří to je.

Nikdy se nic neaplikuje napůl: hodnota, která neodpovídá tomu, co ta věc je, se odmítne dřív, než se zapíše, i s důvodem a polem. Podívej se do konzole na to odmítnutí — třeba že every 6h je rozvrh a samotné 6h není.

Jméno nastavení je celá cesta — bench.share-live, ne share-live. Když se spleteš, konzole vypíše, co existuje nejblíž.

A když se to aplikovalo a chceš to zpátky:

keystone set history
keystone set undo <číslo>

Každá změna je tam i s tím, kdo ji udělal, odkud a jaká byla hodnota předtím.

/keystone test 20

Změří server prázdný, pak postaví hráče po skupinách a skončí větou, která pojmenuje, co povolilo — procesor, paměť, garbage collector, nebo načítání chunků. To jsou čtyři různé problémy se čtyřmi různými odpověďmi a vědět který je většina té práce. Report k tomu řekne, do kterého modu ten čas šel, do kterého světa, a co na serveru stojí.

Když napíše, že mašina byla přes hratelné už bez lidí, je špatně něco, co hráči nezpůsobili, a hledá se to v konzoli kolem začátku toho běhu.

Je vypnutý, dokud nevyplníš assistant.address, assistant.key a assistant.model. Žádný náš klíč neexistuje a nic neteče přes STYGION — namíříš si ho, kam chceš, klidně na model běžící na téže mašině, a pak není co vyplňovat ani jako klíč.

Odpověď bývá v té řádce v konzoli, a Keystone má všechny svoje uvozené [Keystone] a částí, která je napsala, takže poznáš, který přepínač to vypíná. Když chceš pohled té mašiny, obrazovka Console v editoru jsou tytéž řádky i s chatem vedle, a /keystone assistant incident ten úsek přečte a řekne, co vypadá špatně.

Vlastní chyby Keystone se dají posílat do nástroje na chyby, který si provozuješ (GlitchTip nebo Sentry), a nemusíš pak hlídat log. Je to vypnuté: jar žádnou adresu nenese a nic neposílá, dokud nenastavíš errors.dsn v keystone.toml (/keystone set errors.dsn <adresa>; prázdné to zase vypne, bez restartu). Posílají se jen chyby, které mají ve stopě kód Keystone: výjimka, její stopa, verze Keystone, loader a verze Minecraftu. Zpráva se předtím vyčistí (cesty, adresy, e-maily, tokeny, cokoliv v uvozovkách a každé jméno hráče, které server zná, se odstraní). Žádné řádky logu, chat, jméno serveru ani hráč; stejná chyba odejde nejvýš jednou za deset minut. errors.environment říká, pod čím se hlášení založí.