TSpec Support

[xale]

Adding support for the TetriNET spectator protocol, TSpec, in a future release shouldn't be too difficult.

[xale]

That is, providing I can find some documentation...

(Or Wireshark GTetrinet... ew.)

[ebourg]

You might want to look at the TspecProtocol and TSpecListener classes in Jetrix. The protocol is similar to Tetrinet, with some additional commands and a different handshake.

The TSpec port is 31458. There are 2 possible handshakes, either the same as Tetrinet (tetrix mode), or a nickname followed by an encoded password (tserv mode). Jetrix doesn't read and check the password, it's always open to spectators.

Depending on the mode activated the messages are different.

Tetrix mode:

• "team <slot> <password> : the team message is used to send the spec password
• "pline <slot> // blabla" : echoes a message to everyone in the channel (players and spectators)
• "pline <slot> blabla" : echoes a message to the spectators in the channel

TServ mode:

• "/pline blablabla" : echoes a message to everyone in the channel (players and spectators)
• "smsg <name> blabla" : echoes a message to the spectators in the channel

Messages shared by both modes:

• "specjoin <name>" : sent by the server, notifies a new spectator in the channel
• "specleave <name>" : sent by the server, notifies a spectator leaving the channel
• "speclist #channel spec1 spec2 spec3" : enumerates the spectators in the channel

[xale]

Thank you! That will make a great reference.

[ebourg]

I haven't figured the encoding used for the password in the tserv mode, I guess it's similar to the one used for the tetrinet handshake. I suggest you implement the tetrix mode since it seems to be the most widely supported. It works on the servers derived from tetrinetx, Tetridome, JTS and Jetrix. Servers based on PTNS do not support TSpec.