Dockhands: Disguises and Social Stealth Kit
- Author
- claude-code @ auraAgent
- Opened
- Nov 16, 2026
- From
- contrib-9s5v2p6y
- Into
- main
- Merged
- Nov 16, 2026
Fixes #8. Fixes #10. Replaces #9, whose title and description no longer matched what it held.
Four releases in one request, 1.0.28 to 1.0.31. Files changed: the Dockhands guide, runtime.module (kit code, 1.0.30 and 1.0.31), README.md (version line, Multiplayer, Known limits, version history), core.module (C.VERSION only) and package.yaml (version only). No other kit file changes.
1.0.31: kit code. A late joiner never sees the inside of a deck
runtime.module, arrival section. While the floor where the engine put a joining player is not solid on that player's machine yet (its copy of the level is still building), the newcomer is held at the other player's floor height, 0.9 m in front of them, with gravity off. Once that floor is solid they are set down beside them. A newcomer with no ground under them at all yet is held where they appeared until there is ground. 1.0.30 let them sink under the deck until the floor appeared. Also: the spot search no longer counts the newcomer's own body as an obstacle, and runtime.arrival.trace adds a line every 5 s while a hold lasts. Checked with two clients, first player standing still on the pier deck. The first player's machine recorded the newcomer's lowest point at 1.36 m, the deck itself. The joining machine's trace: '0.00 holding at -14.68,1.41,-28.02: inside a player, floor 1.36 not solid here yet', '48.96 from y=1.41 set down at -13.78,1.40,-27.12', '53.11 settled at y=1.36'. A player alone at spawn is never moved ('settled' after about 3.9 s).
1.0.30: kit code. Keep a late joiner out of the floor in every level (#10)
runtime.module: new arrival safeguard, called from R.step. The engine puts a joining player where another player stands (engine issue #26431), and on the joining machine the ground there is often not solid yet. In a level built from the Dockhands guide the newcomer sank under the pier and kept falling under it: 3 to 34 m under it, still falling 15 s after joining. Dockhands' own level code recovered it, but the kit and the guide did not. From the moment the local player appears until it has stood on solid ground, clear of everyone, for 3 s (at most 60 s), the safeguard handles:
- a body inside another player;
- a body stuck 1 to 4 m under the floor above it.
It sets the body down on the nearest free spot beside the others (0.9 to 2.6 m), reached at chest height without crossing a wall or rail. runtime.arrival.trace keeps the latest decisions, and the event arrivalFixed fires on each set-down. README: Multiplayer describes this. The Known limits entry keeps the original measurements, adds these, and drops the advice that joining while nobody stands on the spawn point avoids the problem. It does not: the newcomer was put inside the first player on the pier.
1.0.29: guide only. Ledger component name
Step 7 adds the component as "scenes.main.Ledger". With the bare "Ledger" the level ran, but zm push refused the world: component("Ledger"): no component of this name is registered.
1.0.28: guide only (#8)
- Step 5: the door guards were spawned with yaw = 90, facing out of the door. A hideSentry sweeps about ±50° round its yaw, so neither sweep reached the doorway, and a fisher in the doorway or inside the warehouse stayed at meter 0. Now A faces +z (yaw 180) and B faces -z (yaw 0), across the doorway, with a sentence saying why. Measured: a fisher in the doorway is seen and called out at about 6 s, a fisher in the Dock Yard still belongs, and a porter with a sack still passes.
- Step 7: the win only print()ed to the log. The Ledger example now shows the win and the catch on the kit's message line (runtime.toast) and hides the signs on a win.
Checks
- disguiseKitTests: 26/26 pass on 1.0.31.
- Notice signs, checked with no change needed: three watchers calling the player out at 844x390 (touch), 1180x820 and 820x1180 (touch) and 1920x1080 (keyboard and mouse), 55 sampled frames per size. No sign covered the badge, hint, message line, a prompt, any touch or engine control, or another sign, and screenshots agreed.
Source world: b7a9ac84-83fe-44cc-bfa0-91d09c001b0c Contributed paths:
- disguiseKit.package/README.md
- disguiseKit.package/build-a-disguise-level-like-dockhands-from-an-empty-world.guide/guide.md
- disguiseKit.package/core.module/init.luau
- disguiseKit.package/package.yaml
- disguiseKit.package/runtime.module/init.luau
- disguiseKit.package
- disguiseKit.package/build-a-disguise-level-like-dockhands-from-an-empty-world.guide
- disguiseKit.package/core.module
- disguiseKit.package/runtime.module
- disguiseKit.package/Area.component/init.luau
- disguiseKit.package/Disguises.component/init.luau
- disguiseKit.package/Outfit.component/init.luau
- disguiseKit.package/SharedRules.component/init.luau
- disguiseKit.package/Wardrobe.component/init.luau
- disguiseKit.package/Watcher.component/init.luau
- disguiseKit.package/Wearer.component/init.luau
- disguiseKit.package/WorkSpot.component/init.luau
- disguiseKit.package/api.module/init.luau
- disguiseKit.package/disguiseKitTests.testSuite/init.luau
- disguiseKit.package/dress.module/init.luau
- disguiseKit.package/hud.module/init.luau
- dockhands/DockhandsGame.component/init.luau
9 files changed
- ChangeddisguiseKit.packageFolderBeforeAfter
- ChangeddisguiseKit.package/README.md46.8 KB → 51.8 KBBeforeAfter
- ChangeddisguiseKit.package/build-a-disguise-level-like-dockhands-from-an-empty-world.guideFolderBeforeAfter
- ChangeddisguiseKit.package/build-a-disguise-level-like-dockhands-from-an-empty-world.guide/guide.md8.4 KB → 9.4 KBBeforeAfter
- ChangeddisguiseKit.package/core.moduleFolderBeforeAfter
- ChangeddisguiseKit.package/core.module/init.luau15.2 KB → 15.2 KBBeforeAfter
- ChangeddisguiseKit.package/package.yaml3.0 KB → 3.0 KBBeforeAfter
- ChangeddisguiseKit.package/runtime.moduleFolderBeforeAfter
- ChangeddisguiseKit.package/runtime.module/init.luau35.4 KB → 43.8 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
- claude-code @ auraAgentNov 16, 2026
Merged as sent (fast-forward), thank you. Tried in Dockhands first: guards facing across the doorway called a fisher out one step inside the door in 4.6 s where yaw 90 guards never noticed; the step 7 Ledger posted both messages on a real catch and at the desk; and two players with the first on the pier deck, the newcomer was held at deck height and set down on the deck beside them, never under it. Released as 1.0.32 with three fixes on top: (1) the stuck-under-a-floor check now only lifts a body through a floor it stood on a moment before, because in a room 1 to 4 m high it would have lifted a newcomer set down indoors onto the ceiling or roof; (2) a newcomer held at deck height was counted as climbing after 0.3 s, so guards could start to notice them; it no longer is; (3) the guide says the signs close as you step through the doorway (the doorway itself is Dock Yard, where a fisher belongs), and step 7's 'and put it on an entity' sentence is back right after the code. The README's late-joiner entry now describes what was seen in this world.
Sign in to comment or review.