src-net-skill

Implement the transport-independent multiplayer protocol, lobby, authority, snapshots, and network adapters.

Repository: Kevin-Liu-01/Claude-of-Tanks
Last source activity: August 20, 2026 at 19:28
Detected SKILL.md language: English
Stars: 128
Forks: 23

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Kevin-Liu-01/Claude-of-Tanks --skill src-net-skill

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

32 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

claude-of-tanks-skill

Build and verify Claude of Tanks without crossing simulation, rendering, fleet-generation, or shared-worktree ownership boundaries.

2026-08-23

src-vehicles-skill

Work on first-party procedural tank specs, builders, materials, profiles, ordering, and asset provenance.

2026-08-23

tools-skill

Maintain deterministic performance, screenshot, fleet, geometry, asset, and release verification tools.

2026-08-23

View all from this repository

claude-of-tanks / src/net

Purpose

Provide one authoritative match path for campaign, LAN, private, and ranked play without importing Three.js rendering or DOM state.

Mental model & key files

protocol.js owns wire vocabulary and untrusted input validation.

lobby.js owns teams, team size, readiness, permissions, and start policy.

matchRuntime.js owns fixed ticks, input ordering, snapshots, and client time.

snapshot.js owns quantization, visibility filtering, and interpolation.

snapshotWireCodec.js owns compact binary snapshot rows; protocol v2 uses explicit snapshot acknowledgements, per-peer deltas, and periodic keyframes.

loopbackTransport.js, channelTransport.js, and webrtcPeer.js implement the same bounded transport contract.

localSession.js proves solo play traverses the real host/client path.

rankedServiceClient.js owns service-scoped ladder identity and queue polling; dedicatedClient.js owns authenticated WebSocket handoff and reconnect.

privateRoomSession.js owns lobby WebRTC composition; privateMatchHandoff.js deterministically fills open team slots with bots and releases those same channels to match authority.

browserBattleBridge.js is presentation-only and must stay lazy from main.

Patterns and invariants

Player/entity identity is independent from specId.

Authority accepts controls only; it computes every gameplay result.

Spotting filters data before serialization.

Queues, extrapolation, catch-up, sequences, and payload sizes are bounded.

WebRTC control/events stay reliable and ordered; replaceable snapshots and live input use the unordered zero-retransmit state lane. Fire/consumable edges repeat until acknowledged and authority deduplicates them. WebSocket snapshots and input coalesce under backpressure so stale state cannot consume control headroom.

Modules remain Node-runnable with no DOM/WebGL dependency.

Tests exercise the public host/client interface, not private internals.

Verification

Run node src/net/net.selftest.mjs, node src/net/privateMatchHandoff.selftest.mjs, then npm test and npm run build. Network adapters additionally require browser-pair proof.