Podłączanie klienta

Ta sekcja jest dla osób, które piszą własnego klienta albo konfigurują istniejący. Do samego grania nie jest potrzebna — wystarczy przeglądarka.

Dwa wejścia

Transport	Port	Dla kogo
telnet	9600	Mudlet, TinTin++, MUSHclient, telnet, własne klienty
WebSocket	9601, ścieżka /ws	przeglądarka i wszystko, co mówi po WebSockecie

Oba prowadzą do tego samego świata i tej samej postaci. Różnią się tylko sposobem pakowania danych.

Telnet

Serwer sam zaczyna negocjację i proponuje:

Opcja	Numer	Po co
GMCP	201	strukturalne dane obok tekstu
MCCP2	86	kompresja strumienia
SGA	3	tryb bez „go-ahead”, potrzebny do sensownej pracy
NAWS	31	serwer pyta o rozmiar twojego okna
TTYPE	24	serwer pyta o typ terminala

Serwer oferuje GMCP, MCCP2 i SGA (WILL), a prosi o NAWS i TTYPE (DO). Klient odpowiada DO/DONT i WILL/WONT jak w zwykłym telnecie.

Bez zgody na GMCP nie dostaniesz żadnych danych

Jeżeli twój klient nie odpowie DO na propozycję opcji 201, serwer nie wyśle ani jednego pakietu GMCP. Cała referencja GMCP będzie wtedy dla ciebie martwa — dostaniesz sam tekst.

Sterowanie echem (przy wpisywaniu hasła) idzie zwykłym IAC WILL/WONT ECHO.

WebSocket

Tu nie ma negocjacji — GMCP działa od razu. Ramki to JSON o jednym kształcie:

{ "type": "input", "text": "spójrz" }

Pole type decyduje o reszcie:

type	Kierunek	Pozostałe pola
input	klient → serwer	text — komenda gracza
text	serwer → klient	text — zwykły tekst gry
gmcp	oba	package i data
echo	serwer → klient	enabled — czy pokazywać wpisywane znaki

Pakiet GMCP wygląda więc tak:

{ "type": "gmcp", "package": "Char.State", "data": { "hp": 5 } }

Co warto obsłużyć

Kolejność mniej więcej według opłacalności:

1. Room.Info i Room.Players — mapa i lista obecnych bez parsowania opisów.
2. Char.State — pasek życia. Pamiętaj, że przychodzi częściowo: scalaj, nie podmieniaj.
3. Objects.Data — klikalne cele. Tu jest pułapka z uid, przez którą przeszedł też nasz własny klient webowy.
4. Char.Items.List — ekwipunek na żywo.
5. Comm.Channel.Text — osobne okno na rozmowy.

Polskie znaki

Wszystko leci w UTF-8, łącznie z komendami. Klient, który tnie do ASCII, będzie działał — gra przyjmuje spojrz tak samo jak spójrz — ale opisy świata zrobią się nieczytelne.

Dalej

• GMCP — pełna referencja
• Jak zacząć grać — dla grających, nie piszących klienta