+/melee-stream
git clone https://git.julia.blue/+/melee-stream
2f3b2ca
main
files
| README.md | 3.0 KiB |
| slippi.lua | 33.4 KiB |
[!CAUTION] This entire wireshark dissector was LLM generated
Slippi mirroring dissector (slippi.lua)
A Wireshark/tshark Lua dissector for Slippi console mirroring traffic — the TCP stream a Slippi Nintendont console (Wii) sends to a desktop client (Slippi Launcher / Dolphin / slippi-js / libmelee).
Install
Drop slippi.lua into your Wireshark Personal Lua Plugins folder
(Help → About Wireshark → Folders), then Analyze → Reload Lua Plugins.
Or point tshark at it directly:
tshark -X lua_script:slippi.lua-i eth0-f 'tcp port 51441'
On this box the console is 10.11.12.158 and the client talks to it from
10.11.12.1:*, so a live view is:
tshark -X lua_script:slippi.lua-i eth0-f 'host 10.11.12.158 and tcp port 51441'
What it decodes
- Framing —
u32be length+ UBJSON, with TCP reassembly for messages that span segments and multiple messages per segment. - UBJSON — generic tree (
slippi.ubjson.*) plus typed fields for the known keys. - Message types —
HANDSHAKE(1),REPLAY(2),KEEPALIVE(3),MENU(4); seeslippi.type. Handshake fields:slippi.nick,slippi.nintendont_version,slippi.client_token,slippi.pos,slippi.cursor,slippi.is_realtime. Replay fields:slippi.pos,slippi.next_pos,slippi.force_pos,slippi.data_len. - Embedded .slp event stream inside
REPLAY/MENUpayloads — split into events using the per-game Event Payloads (0x35) table when it is seen on the stream, otherwise a built-in default table (verified byte-for-byte against a live 3.17.0.0 console). Decoded per event:0x35Event Payloads – full command/size table0x36Game Start –slippi.slp.replay_version,slippi.slp.stage, per-player external character + player type, display names / connect codes0x37Pre-Frame /0x38Post-Frame – frame, player index, action state, position, facing, percent, shield, stocks, internal character0x39Game End – method, LRAS initiator, placements0x3AFrame Start – frame, RNG seed, scene frame counter0x3BItem Update – frame, item type, spawn id0x3CFrame Bookend – frame, latest finalized frame0x10Message Splitter – wrapped command, chunk size, last-chunk flag
- Legacy / relay streams (no length prefix — old Nintendont or a Slippi
relay forwarding the raw
.slpbyte stream) are detected heuristically and dissected as a bare event stream.
The Info column summarises each packet, e.g.
REPLAY frame 2001 [FS PRE PRE POST POST BE] or REPLAY [PAYLOADS START].
Ports
Registered on TCP 51441 (Wii direct), 666 (legacy Nintendont) and
53741–53744 (relay instances). A heuristic also catches the protocol on any
other TCP port.
Protocol references
- https://github.com/project-slippi/slippi-wiki —
SPEC.md,SPECTATOR_PROTOCOL.md - https://github.com/project-slippi/slippi-js —
src/node/console/* - https://github.com/altf4/libmelee —
melee/slippstream.py