<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>wireshark/README.md - +/melee-stream @ main</title>
<meta name="description" content="wireshark/README.md in +/melee-stream at main.">
<meta property="og:title" content="wireshark/README.md - +/melee-stream @ main">
<meta property="og:description" content="wireshark/README.md in +/melee-stream at main.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="main" data-tip="2f3b2cac78343c5a59ec17a0e345d2a9d2541c95">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>+/melee-stream</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/+/melee-stream</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Julia Ryan</span><span class="commit-message" data-commit="2f3b2cac78343c5a59ec17a0e345d2a9d2541c95">wireshark slippi dissector</span><span class="snapshot-sha sha" data-commit="2f3b2cac78343c5a59ec17a0e345d2a9d2541c95">2f3b2ca</span><time datetime="2026-08-27T15:27:24-07:00" title="2026-08-27 15:27:24 -0700">2026-08-27</time></p>
<header class="topbar"><details class="switcher"><summary>main</summary><div class="menu"><strong>branches</strong><a class="current" href="/%2B/melee-stream/ref/main/">main</a><a class="all" href="/%2B/melee-stream/refs">all refs →</a></div></details><nav class="crumbs"><a href="/%2B/melee-stream/">melee-stream</a> / <a href="/%2B/melee-stream/ref/main/tree/wireshark/">wireshark</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>3.0 KiB</span><span>70 lines</span></span><span class="actions"><a class="raw" href="/%2B/melee-stream/raw/7ebf320b86b85e786759185f744c040a26245ce8/wireshark/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><blockquote>
<p>[!CAUTION]
This entire wireshark dissector was LLM generated</p>
</blockquote>
<h1>Slippi mirroring dissector (<code>slippi.lua</code>)</h1>
<p>A Wireshark/tshark Lua dissector for <strong>Slippi console mirroring</strong> traffic — the
TCP stream a Slippi Nintendont console (Wii) sends to a desktop client
(Slippi Launcher / Dolphin / slippi-js / libmelee).</p>
<h2>Install</h2>
<p>Drop <code>slippi.lua</code> into your Wireshark <em>Personal Lua Plugins</em> folder
(<em>Help → About Wireshark → Folders</em>), then <em>Analyze → Reload Lua Plugins</em>.</p>
<p>Or point tshark at it directly:</p>
<pre class="language-bash"><a-f>tshark</a-f> <a-co>-X</a-co> lua_script:slippi.lua <a-co>-i</a-co> eth0 <a-co>-f</a-co> <a-s>&#39;tcp port 51441&#39;</a-s></pre>
<p>On this box the console is <code>10.11.12.158</code> and the client talks to it from
<code>10.11.12.1:*</code>, so a live view is:</p>
<pre class="language-bash"><a-f>tshark</a-f> <a-co>-X</a-co> lua_script:slippi.lua <a-co>-i</a-co> eth0 <a-co>-f</a-co> <a-s>&#39;host 10.11.12.158 and tcp port 51441&#39;</a-s></pre>
<h2>What it decodes</h2>
<ul>
<li><strong>Framing</strong> — <code>u32be length</code> + UBJSON, with TCP reassembly for messages that
span segments and multiple messages per segment.</li>
<li><strong>UBJSON</strong> — generic tree (<code>slippi.ubjson.*</code>) plus typed fields for the known
keys.</li>
<li><strong>Message types</strong> — <code>HANDSHAKE</code> (1), <code>REPLAY</code> (2), <code>KEEPALIVE</code> (3), <code>MENU</code> (4);
see <code>slippi.type</code>. Handshake fields: <code>slippi.nick</code>,
<code>slippi.nintendont_version</code>, <code>slippi.client_token</code>, <code>slippi.pos</code>,
<code>slippi.cursor</code>, <code>slippi.is_realtime</code>. Replay fields: <code>slippi.pos</code>,
<code>slippi.next_pos</code>, <code>slippi.force_pos</code>, <code>slippi.data_len</code>.</li>
<li><strong>Embedded .slp event stream</strong> inside <code>REPLAY</code>/<code>MENU</code> payloads — split into
events using the per-game <strong>Event Payloads (0x35)</strong> 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:
<ul>
<li><code>0x35</code> Event Payloads – full command/size table</li>
<li><code>0x36</code> Game Start – <code>slippi.slp.replay_version</code>, <code>slippi.slp.stage</code>,
per-player external character + player type, display names / connect codes</li>
<li><code>0x37</code> Pre-Frame / <code>0x38</code> Post-Frame – frame, player index, action state,
position, facing, percent, shield, stocks, internal character</li>
<li><code>0x39</code> Game End – method, LRAS initiator, placements</li>
<li><code>0x3A</code> Frame Start – frame, RNG seed, scene frame counter</li>
<li><code>0x3B</code> Item Update – frame, item type, spawn id</li>
<li><code>0x3C</code> Frame Bookend – frame, latest finalized frame</li>
<li><code>0x10</code> Message Splitter – wrapped command, chunk size, last-chunk flag</li>
</ul>
</li>
<li><strong>Legacy / relay streams</strong> (no length prefix — old Nintendont or a Slippi
relay forwarding the raw <code>.slp</code> byte stream) are detected heuristically and
dissected as a bare event stream.</li>
</ul>
<p>The Info column summarises each packet, e.g.
<code>REPLAY  frame 2001 [FS PRE PRE POST POST BE]</code> or <code>REPLAY [PAYLOADS START]</code>.</p>
<h2>Ports</h2>
<p>Registered on TCP <code>51441</code> (Wii direct), <code>666</code> (legacy Nintendont) and
<code>53741–53744</code> (relay instances). A heuristic also catches the protocol on any
other TCP port.</p>
<h2>Protocol references</h2>
<ul>
<li><a href="https://github.com/project-slippi/slippi-wiki">https://github.com/project-slippi/slippi-wiki</a> — <code>SPEC.md</code>, <code>SPECTATOR_PROTOCOL.md</code></li>
<li><a href="https://github.com/project-slippi/slippi-js">https://github.com/project-slippi/slippi-js</a> — <code>src/node/console/*</code></li>
<li><a href="https://github.com/altf4/libmelee">https://github.com/altf4/libmelee</a> — <code>melee/slippstream.py</code></li>
</ul>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>&gt; </a-p>[!CAUTION]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"><a-p>&gt; </a-p>This entire wireshark dissector was LLM generated</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"><a-p>#</a-p> <a-tt>Slippi mirroring dissector (`slippi.lua`)</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">A Wireshark/tshark Lua dissector for **Slippi console mirroring** traffic — the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">TCP stream a Slippi Nintendont console (Wii) sends to a desktop client</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">(Slippi Launcher / Dolphin / slippi-js / libmelee).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>##</a-p> <a-tt>Install</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text">Drop `slippi.lua` into your Wireshark *Personal Lua Plugins* folder</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text">(*Help → About Wireshark → Folders*), then *Analyze → Reload Lua Plugins*.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text">Or point tshark at it directly:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>```</a-p><a-tl>bash</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>tshark </a-p><a-co>-X</a-co><a-p> lua_script:slippi.lua </a-p><a-co>-i</a-co><a-p> eth0 </a-p><a-co>-f</a-co><a-p> </a-p><a-s>&#39;tcp port 51441&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>On this box the console is `10.11.12.158` and the client talks to it from</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>`10.11.12.1:*`, so a live view is:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>```</a-p><a-tl>bash</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>tshark </a-p><a-co>-X</a-co><a-p> lua_script:slippi.lua </a-p><a-co>-i</a-co><a-p> eth0 </a-p><a-co>-f</a-co><a-p> </a-p><a-s>&#39;host 10.11.12.158 and tcp port 51441&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>## </a-p><a-tt>What it decodes</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>* **Framing** — `u32be length` + UBJSON, with TCP reassembly for messages that</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>  span segments and multiple messages per segment.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>* **UBJSON** — generic tree (`slippi.ubjson.*`) plus typed fields for the known</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>  keys.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>* **Message types** — `HANDSHAKE` (1), `REPLAY` (2), `KEEPALIVE` (3), `MENU` (4);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>  see `slippi.type`. Handshake fields: `slippi.nick`,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>  `slippi.nintendont_version`, `slippi.client_token`, `slippi.pos`,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>  `slippi.cursor`, `slippi.is_realtime`. Replay fields: `slippi.pos`,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>  `slippi.next_pos`, `slippi.force_pos`, `slippi.data_len`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>* **Embedded .slp event stream** inside `REPLAY`/`MENU` payloads — split into</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>  events using the per-game **Event Payloads (0x35)** table when it is seen on</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>  the stream, otherwise a built-in default table (verified byte-for-byte</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>  against a live 3.17.0.0 console). Decoded per event:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>  * `0x35` Event Payloads – full command/size table</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>  * `0x36` Game Start – `slippi.slp.replay_version`, `slippi.slp.stage`,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>    per-player external character + player type, display names / connect codes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>  * `0x37` Pre-Frame / `0x38` Post-Frame – frame, player index, action state,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>    position, facing, percent, shield, stocks, internal character</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>  * `0x39` Game End – method, LRAS initiator, placements</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>  * `0x3A` Frame Start – frame, RNG seed, scene frame counter</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>  * `0x3B` Item Update – frame, item type, spawn id</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>  * `0x3C` Frame Bookend – frame, latest finalized frame</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>  * `0x10` Message Splitter – wrapped command, chunk size, last-chunk flag</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>* **Legacy / relay streams** (no length prefix — old Nintendont or a Slippi</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>  relay forwarding the raw `.slp` byte stream) are detected heuristically and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>  dissected as a bare event stream.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>The Info column summarises each packet, e.g.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>`REPLAY  frame 2001 [FS PRE PRE POST POST BE]` or `REPLAY [PAYLOADS START]`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>## </a-p><a-tt>Ports</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>Registered on TCP `51441` (Wii direct), `666` (legacy Nintendont) and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>`53741–53744` (relay instances). A heuristic also catches the protocol on any</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>other TCP port.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>## </a-p><a-tt>Protocol references</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>* &lt;https://github.com/project-slippi/slippi-wiki&gt; — `SPEC.md`, `SPECTATOR_PROTOCOL.md`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>* &lt;https://github.com/project-slippi/slippi-js&gt; — `src/node/console/*`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>* </a-p>&lt;https://github.com/altf4/libmelee&gt; — `melee/slippstream.py`</span></span></pre></div></div>
</main>
</body>
</html>
