Kanály chatu · Keystone · Dokumentace

Keystone umí rozdělit chat do kanálů libovolného druhu — jeden na jazyk, týmový kanál, obchod, lokální kanál slyšet jen poblíž. Každý hráč píše do jednoho kanálu a poslouchá sadu kanálů. Řádka dojde jen hráčům, kteří její kanál poslouchají a mají právo ho číst. Funguje s čistým klientem: rozhoduje, komu řádka přijde, není to okno.

Výchozí vypnuto (chat.channels.enabled = false): nic z toho neběží a chat je takový jako vždy. Novinka 0.2.1.

Nastavení

V panelu obrazovka Chat channels (pod Community) ukazuje seznam jako tabulku s hotovými řádky (English & Czech, Staff, Local, Trade) a náhledem řádky v každém kanálu. Totéž je jedno nastavení v keystone.toml, chat.channels.list, kanál na řádek:

Kód

en: name=English; tag=&8[&9EN&8]; language=en; discord=main
cs: name=Čeština; tag=&8[&cCZ&8]; language=cs; discord=123456789012345678
staff: name=Staff; tag=&8[&4Staff&8]; read=keystone.chat.staff; prefix=#
local: name=Local; tag=&8[&aL&8]; radius=100; prefix=!

Klíč	Co dělá
`name`	Co vidí hráči (bez barev).
`tag`	Před každou řádkou v kanálu, s barvami.
`read`	Právo kanál slyšet. Prázdné: všichni.
`write`	Právo do něj psát. Prázdné: stejné jako `read`.
`language`	Dvě písmena. Hráči, kterým Keystone mluví tímto jazykem, sem píšou automaticky.
`radius`	Bloky ve stejné dimenzi. 0: celý server.
`prefix`	Znaky, které pošlou jednu řádku sem: `!ahoj` jde do kanálu s prefixem `!`.
`discord`	Id Discord kanálu, nebo `main` pro `chat-channel` modulu Discord. Bez něj kanál hru neopustí.
`listen`	`yes`/`no`: slyšet, dokud ho hráč neztlumí (pro kanály bez jazyka).

Pak chat.channels.enabled = true. Další nastavení: chat.channels.default (kam hráč píše, když jeho jazyk nemá kanál), chat.channels.mode-default (all nebo own — co z jazykových kanálů hráč slyší, než odpoví), chat.channels.ask-on-join (otázka níže). Seznam, který nejde přečíst, se při uložení odmítne i s důvodem.

Pro hráče

Kód

/channel            # kanály, které smíš číst, co posloucháš, tlačítka pro přepnutí
/channel <id>       # odteď píšeš sem   (funguje i /ch)
/channel mute <id>  # přestat poslouchat
/channel listen <id>
/channel mode own|all

Jazyky. Hned po výběru jazyka při prvním připojení (viz jazyk hráče) se zobrazí druhá řádka Chat: jen čeština / všechny jazyky. Jen poslouchá jen kanál svého jazyka, všechny všechny jazykové kanály. /channel mode se zeptá znovu. Texty jsou jazykové klíče (keystone.chat.*), takže je pokryje překlad serveru.

Discord

Každý kanál může mít vlastní Discord kanál. Řádka jde jen do Discord kanálu svého kanálu; zpráva z něj přijde jen do toho kanálu, jen hráčům, kteří ho smějí číst, s tagem kanálu na začátku. Kanál bez discord hru nikdy neopustí — týmový kanál zůstane soukromý, pokud ho schválně nepropojíš se soukromým Discord kanálem. S vypnutými kanály funguje most jako dřív, s jedním chat-channel.

Co zůstává, jak bylo

Oznámení, řádky o příchodu a odchodu, varování před restartem, /say, /me, týmové zprávy a /msg dojdou všem jako dřív. Odmítnutá řádka (např. nepřihlášený účet) se odmítne dřív, než se volí kanál. Antispam hry dál počítá každou řádku a log konzole dostane každou řádku i s tagem.

Jak se řádka píše

Se zapnutými kanály Keystone píše každou řádku chatu formátem z obrazovky Chat (chat.format.*) jako zprávu serveru — stejně jako chat.format.enabled — i tam, kde chat formátuje jiný mód, protože řádka musí dojít jen do svého kanálu. Formát může tag umístit přes {channel} a jméno přes {channel-name}; když to neudělá, tag jde na začátek. Co hráč napíše, se nikdy nečte jako barva ani jako jméno ve složených závorkách.

Soukromí na jednom místě

Nikdo neslyší kanál bez práva read — ani přes /channel listen, ani prefixem, ani z Discordu, ani ve vanishi. Operátor slyší všechny kanály, protože operátor má všechna práva.
Když se háček chatu na dané verzi hry nepřipojí, každá řádka se odmítne se zprávou, místo aby šla všem.
Ručně upravený seznam, který nejde přečíst, ponechá poslední funkční a log řekne proč.