castle-web-cli 0.4.232 → 0.4.234
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent-failures.d.ts +8 -0
- package/dist/agent-failures.js +19 -2
- package/dist/agent-prompts.d.ts +1 -1
- package/dist/agent-prompts.js +10 -3
- package/dist/agent.d.ts +64 -3
- package/dist/agent.js +170 -81
- package/dist/api.d.ts +11 -0
- package/dist/api.js +43 -0
- package/dist/bundle.d.ts +64 -0
- package/dist/bundle.js +558 -2
- package/dist/castle-host/host.d.ts +18 -2
- package/dist/castle-host/host.js +844 -39
- package/dist/castleJson.d.ts +23 -2
- package/dist/castleJson.js +46 -2
- package/dist/check.d.ts +3 -1
- package/dist/check.js +20 -3
- package/dist/chunkLoader.d.ts +3 -0
- package/dist/chunkLoader.js +111 -0
- package/dist/devParty.d.ts +26 -0
- package/dist/devParty.js +231 -0
- package/dist/devSaveStorage.js +4 -0
- package/dist/devSessionStorage.js +50 -2
- package/dist/devSocial.d.ts +24 -0
- package/dist/devSocial.js +70 -0
- package/dist/ide.d.ts +2 -0
- package/dist/ide.js +119 -15
- package/dist/importPinMismatch.d.ts +22 -0
- package/dist/importPinMismatch.js +77 -0
- package/dist/importRegression.js +3 -15
- package/dist/imports.d.ts +10 -3
- package/dist/imports.js +88 -20
- package/dist/index.js +11 -4
- package/dist/init.js +1 -1
- package/dist/platformDoc.js +22 -0
- package/dist/routerFences.d.ts +5 -0
- package/dist/routerFences.js +12 -2
- package/dist/save-deck.d.ts +25 -1
- package/dist/save-deck.js +178 -9
- package/dist/serve.js +32 -11
- package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
- package/dist/shell/assets/index-MVLfNYd9.css +1 -0
- package/dist/shell/index.html +2 -2
- package/dist/taskSteer.d.ts +13 -0
- package/dist/taskSteer.js +22 -2
- package/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +339 -5
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +176 -1
- package/kits/base/sdk/commands.js +3 -0
- package/kits/base/sdk/display.d.ts +3 -0
- package/kits/base/sdk/display.js +9 -3
- package/kits/base/sdk/hub.d.ts +37 -6
- package/kits/base/sdk/hub.js +63 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +148 -32
- package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
- package/kits/base/sdk/party.d.ts +23 -0
- package/kits/base/sdk/party.js +91 -0
- package/kits/base/sdk/reconnectBudget.d.ts +23 -0
- package/kits/base/sdk/reconnectBudget.js +96 -0
- package/kits/base/sdk/save.d.ts +38 -1
- package/kits/base/sdk/save.js +81 -7
- package/kits/base/sdk/server/hub.d.ts +117 -0
- package/kits/base/sdk/server/hub.js +119 -2
- package/kits/base/sdk/server/platformHandle.d.ts +43 -1
- package/kits/base/sdk/server/storage.d.ts +17 -0
- package/kits/base/sdk/server/storage.js +65 -3
- package/kits/base/sdk/server/wrapper.d.ts +43 -6
- package/kits/base/sdk/server/wrapper.js +93 -9
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +451 -13
- package/kits/hub-game/README.md +63 -0
- package/kits/hub-game/blueprints/avatar-10.scene +28 -0
- package/kits/hub-game/blueprints/avatar-11.scene +28 -0
- package/kits/hub-game/blueprints/avatar-12.scene +28 -0
- package/kits/hub-game/blueprints/avatar-13.scene +28 -0
- package/kits/hub-game/blueprints/avatar-14.scene +28 -0
- package/kits/hub-game/blueprints/avatar-15.scene +28 -0
- package/kits/hub-game/blueprints/avatar-4.scene +28 -0
- package/kits/hub-game/blueprints/avatar-5.scene +28 -0
- package/kits/hub-game/blueprints/avatar-6.scene +28 -0
- package/kits/hub-game/blueprints/avatar-7.scene +28 -0
- package/kits/hub-game/blueprints/avatar-8.scene +28 -0
- package/kits/hub-game/blueprints/avatar-9.scene +28 -0
- package/kits/hub-game/castle.json +5 -5
- package/kits/hub-game/code/client/act.js +312 -0
- package/kits/hub-game/code/client/actionLayout.js +147 -0
- package/kits/hub-game/code/client/actionOverflow.js +556 -0
- package/kits/hub-game/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/arrivalCamera.js +50 -0
- package/kits/hub-game/code/client/askSlot.js +117 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +311 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +253 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +472 -0
- package/kits/hub-game/code/client/build.js +38 -0
- package/kits/hub-game/code/client/chat.js +41 -5
- package/kits/hub-game/code/client/chatModeration.js +5 -0
- package/kits/hub-game/code/client/chrome.js +2144 -160
- package/kits/hub-game/code/client/companion.js +716 -0
- package/kits/hub-game/code/client/companionDress.js +99 -0
- package/kits/hub-game/code/client/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +515 -0
- package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
- package/kits/hub-game/code/client/doorErrors.js +39 -0
- package/kits/hub-game/code/client/earned.js +131 -0
- package/kits/hub-game/code/client/emoteBubble.js +75 -0
- package/kits/hub-game/code/client/fall.js +18 -0
- package/kits/hub-game/code/client/farAvatars.js +233 -0
- package/kits/hub-game/code/client/firstJoin.js +9 -2
- package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
- package/kits/hub-game/code/client/frameBatch.js +5 -0
- package/kits/hub-game/code/client/grab.js +368 -29
- package/kits/hub-game/code/client/hookLayer.js +385 -20
- package/kits/hub-game/code/client/hudCopy.js +51 -0
- package/kits/hub-game/code/client/hudRate.js +20 -0
- package/kits/hub-game/code/client/idle.js +177 -24
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/invites.js +231 -0
- package/kits/hub-game/code/client/joinError.js +9 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +234 -0
- package/kits/hub-game/code/client/landscapeLayout.js +17 -0
- package/kits/hub-game/code/client/layoutCache.js +264 -0
- package/kits/hub-game/code/client/loadTelemetry.js +20 -0
- package/kits/hub-game/code/client/loadingCover.js +148 -0
- package/kits/hub-game/code/client/loadingEntry.js +8 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -0
- package/kits/hub-game/code/client/menuRows.js +43 -0
- package/kits/hub-game/code/client/modelReady.js +7 -0
- package/kits/hub-game/code/client/pack.js +6 -2
- package/kits/hub-game/code/client/packFormat.js +3 -3
- package/kits/hub-game/code/client/padCueArrival.js +23 -0
- package/kits/hub-game/code/client/padCues.js +112 -0
- package/kits/hub-game/code/client/padOccupancy.js +88 -0
- package/kits/hub-game/code/client/padReadability.js +26 -0
- package/kits/hub-game/code/client/padRings.js +69 -0
- package/kits/hub-game/code/client/pushVisit.js +14 -0
- package/kits/hub-game/code/client/quality.js +205 -0
- package/kits/hub-game/code/client/qualityEntry.js +55 -0
- package/kits/hub-game/code/client/rehello.js +167 -0
- package/kits/hub-game/code/client/safeLayout.js +338 -0
- package/kits/hub-game/code/client/safeStyle.js +42 -0
- package/kits/hub-game/code/client/say.js +12 -3
- package/kits/hub-game/code/client/shot.js +146 -0
- package/kits/hub-game/code/client/shotFit.js +56 -0
- package/kits/hub-game/code/client/signIn.js +28 -0
- package/kits/hub-game/code/client/sound.js +63 -8
- package/kits/hub-game/code/client/soundscape.js +1151 -0
- package/kits/hub-game/code/client/soundscapeActions.js +99 -0
- package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
- package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
- package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
- package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
- package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
- package/kits/hub-game/code/client/soundscapeCues.js +362 -0
- package/kits/hub-game/code/client/soundscapeMap.js +181 -0
- package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
- package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
- package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
- package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
- package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
- package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
- package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
- package/kits/hub-game/code/client/soundscapeUi.js +211 -0
- package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
- package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
- package/kits/hub-game/code/client/spin.js +101 -0
- package/kits/hub-game/code/client/state.js +162 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +714 -59
- package/kits/hub-game/code/client/tiers.js +543 -52
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +39 -2
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/weakestLookBake.js +92 -0
- package/kits/hub-game/code/client/weakestTier.js +295 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- package/kits/hub-game/code/client/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +200 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +138 -0
- package/kits/hub-game/code/server/actors.js +11 -2
- package/kits/hub-game/code/server/analytics.js +83 -0
- package/kits/hub-game/code/server/anonymousEntry.js +49 -0
- package/kits/hub-game/code/server/arrivalPose.js +36 -0
- package/kits/hub-game/code/server/ask.js +155 -0
- package/kits/hub-game/code/server/ballot.js +539 -0
- package/kits/hub-game/code/server/cells.js +100 -0
- package/kits/hub-game/code/server/companion.js +107 -0
- package/kits/hub-game/code/server/cues.js +70 -0
- package/kits/hub-game/code/server/decor.js +269 -0
- package/kits/hub-game/code/server/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +478 -0
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +272 -0
- package/kits/hub-game/code/server/history.js +7 -0
- package/kits/hub-game/code/server/hub.js +2510 -95
- package/kits/hub-game/code/server/idle.js +60 -12
- package/kits/hub-game/code/server/index.js +28 -6
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +36 -2
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +586 -7
- package/kits/hub-game/code/server/menu.js +161 -0
- package/kits/hub-game/code/server/npcs.js +1025 -113
- package/kits/hub-game/code/server/observe.js +408 -0
- package/kits/hub-game/code/server/padOccupancy.js +85 -0
- package/kits/hub-game/code/server/party.js +2 -2
- package/kits/hub-game/code/server/players.js +30 -0
- package/kits/hub-game/code/server/resumePose.js +152 -0
- package/kits/hub-game/code/server/say.js +1 -1
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +123 -0
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +175 -0
- package/kits/hub-game/code/server/wear.js +12 -0
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/act.js +35 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/loadStages.js +12 -0
- package/kits/hub-game/code/shared/quality.js +74 -0
- package/kits/hub-game/code/shared/say.js +2 -0
- package/kits/hub-game/code/shared/shot.js +53 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1753 -202
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +3475 -77
- package/kits/hub-game/docs/home-pieces.md +71 -0
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -0
- package/kits/hub-game/models/avatar-10.pxmodel +28 -0
- package/kits/hub-game/models/avatar-11.pxmodel +28 -0
- package/kits/hub-game/models/avatar-12.pxmodel +27 -0
- package/kits/hub-game/models/avatar-13.pxmodel +24 -0
- package/kits/hub-game/models/avatar-14.pxmodel +29 -0
- package/kits/hub-game/models/avatar-15.pxmodel +24 -0
- package/kits/hub-game/models/avatar-4.pxmodel +29 -0
- package/kits/hub-game/models/avatar-5.pxmodel +27 -0
- package/kits/hub-game/models/avatar-6.pxmodel +26 -0
- package/kits/hub-game/models/avatar-7.pxmodel +25 -0
- package/kits/hub-game/models/avatar-8.pxmodel +24 -0
- package/kits/hub-game/models/avatar-9.pxmodel +30 -0
- package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
- package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
- package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
- package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
- package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
- package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
- package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
- package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
- package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
- package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
- package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
- package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
- package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
- package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
- package/kits/hub-game/models/hats/cap.pxmodel +162 -0
- package/kits/hub-game/models/hats/captain.pxmodel +178 -0
- package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
- package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
- package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
- package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
- package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
- package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
- package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
- package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
- package/kits/hub-game/models/hats/straw.pxmodel +139 -0
- package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
- package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
- package/kits/hub-game/models/hats/witch.pxmodel +147 -0
- package/kits/hub-game/package-lock.json +10 -1
- package/kits/hub-game/package.json +6 -2
- package/kits/hub-game/play/player.js +142 -0
- package/kits/hub-game/play/registry.js +47 -0
- package/kits/hub-game/play.jsx +37 -0
- package/kits/hub-game/scripts/check.mjs +117 -16
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
- package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
- package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
- package/kits/hub-game/scripts/gen-earned.mjs +285 -0
- package/kits/hub-game/scripts/gen-hats.mjs +827 -0
- package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
- package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-act-client.mjs +186 -0
- package/kits/hub-game/scripts/test-act.mjs +171 -0
- package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
- package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
- package/kits/hub-game/scripts/test-actions.mjs +298 -0
- package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
- package/kits/hub-game/scripts/test-actors.mjs +38 -23
- package/kits/hub-game/scripts/test-analytics.mjs +76 -0
- package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
- package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
- package/kits/hub-game/scripts/test-ask.mjs +269 -0
- package/kits/hub-game/scripts/test-attention.mjs +10 -1
- package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
- package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
- package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
- package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
- package/kits/hub-game/scripts/test-avatar.mjs +584 -7
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +49 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +863 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
- package/kits/hub-game/scripts/test-companion.mjs +259 -0
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
- package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
- package/kits/hub-game/scripts/test-decor.mjs +464 -0
- package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
- package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
- package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
- package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1224 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
- package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
- package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
- package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
- package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
- package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
- package/kits/hub-game/scripts/test-idle.mjs +427 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-interest.mjs +15 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
- package/kits/hub-game/scripts/test-invites.mjs +109 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +664 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
- package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
- package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
- package/kits/hub-game/scripts/test-manifest.mjs +472 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
- package/kits/hub-game/scripts/test-menu.mjs +319 -0
- package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-observed.mjs +745 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
- package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
- package/kits/hub-game/scripts/test-picker.mjs +541 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
- package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
- package/kits/hub-game/scripts/test-quality.mjs +385 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
- package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
- package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
- package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
- package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
- package/kits/hub-game/scripts/test-say.mjs +1 -1
- package/kits/hub-game/scripts/test-shot.mjs +901 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +449 -0
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
- package/kits/hub-game/scripts/test-tiers.mjs +476 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +770 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
- package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
- package/kits/hub-game/scripts/test-yours.mjs +403 -0
- package/kits/multiplayer-3d/CLAUDE.md +50 -0
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/avatars.js +7 -0
- package/kits/multiplayer-3d/code/client/gait.js +65 -0
- package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- package/kits/multiplayer-3d/code/options.js +5 -0
- package/kits/multiplayer-3d/code/server/ownership.js +10 -2
- package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
- package/kits/multiplayer-3d/code/server/world.js +7 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +3 -1
- package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
- package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
- package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
- package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
- package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
- package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
- package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +19 -1
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/frozenActors.js +233 -0
- package/kits/physics-2d/engine/scene.js +337 -3
- package/kits/physics-2d/engine/skyKey.js +129 -0
- package/kits/physics-2d/engine/stillClock.js +106 -0
- package/kits/physics-2d/engine/updateBudget.js +21 -0
- package/kits/physics-2d/eslint.config.js +1 -1
- package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
- package/kits/physics-2d/play/behaviors/Camera.js +40 -0
- package/kits/physics-2d/play/behaviors/Collider.js +122 -0
- package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
- package/kits/physics-2d/play/behaviors/Goal.js +46 -0
- package/kits/physics-2d/play/behaviors/Joints.js +126 -0
- package/kits/physics-2d/play/behaviors/Layout.js +71 -0
- package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
- package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
- package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
- package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
- package/kits/physics-2d/play/behaviors/Style.js +209 -0
- package/kits/physics-2d/play/behaviors/Text.js +85 -0
- package/kits/physics-2d/play/behaviors/Video.js +93 -0
- package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +42 -529
- package/kits/physics-3d/behaviors/Body.jsx +3 -0
- package/kits/physics-3d/behaviors/Model.jsx +3 -0
- package/kits/physics-3d/behaviors/Player.jsx +661 -87
- package/kits/physics-3d/behaviors/Shape.jsx +3 -0
- package/kits/physics-3d/behaviors/Solid.jsx +3 -0
- package/kits/physics-3d/behaviors/Transform.jsx +3 -0
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-camera.md +542 -0
- package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
- package/kits/physics-3d/docs/engine-load.md +149 -0
- package/kits/physics-3d/docs/engine-look.md +114 -0
- package/kits/physics-3d/docs/engine-shadows.md +372 -0
- package/kits/physics-3d/docs/engine-skip-work.md +187 -0
- package/kits/physics-3d/docs/engine-sky.md +198 -0
- package/kits/physics-3d/docs/engine-static-actors.md +226 -0
- package/kits/physics-3d/docs/engine-view.md +37 -0
- package/kits/physics-3d/docs/pxmodel-format.md +9 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
- package/kits/physics-3d/engine3d/actornode.js +87 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -0
- package/kits/physics-3d/engine3d/branches.js +3 -13
- package/kits/physics-3d/engine3d/cage.js +2 -7
- package/kits/physics-3d/engine3d/cageops.js +2 -17
- package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
- package/kits/physics-3d/engine3d/editorWorld.js +6 -0
- package/kits/physics-3d/engine3d/emptynodes.js +232 -0
- package/kits/physics-3d/engine3d/framecap.js +99 -0
- package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
- package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
- package/kits/physics-3d/engine3d/gait.js +126 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +514 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/modelFiles.js +3 -17
- package/kits/physics-3d/engine3d/modelMath.js +49 -0
- package/kits/physics-3d/engine3d/modelready.js +16 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +106 -21
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +522 -10
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/partgeometry.js +1 -16
- package/kits/physics-3d/engine3d/paths.js +1 -9
- package/kits/physics-3d/engine3d/playTimings.js +50 -0
- package/kits/physics-3d/engine3d/playerRun.js +372 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/rapier.js +27 -0
- package/kits/physics-3d/engine3d/scatter.js +1 -11
- package/kits/physics-3d/engine3d/shadowfade.js +890 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- package/kits/physics-3d/engine3d/squarefirst.js +177 -0
- package/kits/physics-3d/engine3d/stillshadows.js +399 -0
- package/kits/physics-3d/engine3d/sweep.js +1 -25
- package/kits/physics-3d/engine3d/unchanged.js +11 -0
- package/kits/physics-3d/engine3d/viewrange.js +52 -0
- package/kits/physics-3d/engine3d/world3d.js +1253 -76
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +10 -2
- package/kits/physics-3d/package-lock.json +7 -0
- package/kits/physics-3d/package.json +5 -1
- package/kits/physics-3d/play/behaviors/Body.js +31 -0
- package/kits/physics-3d/play/behaviors/Door.js +37 -0
- package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
- package/kits/physics-3d/play/behaviors/Model.js +23 -0
- package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
- package/kits/physics-3d/play/behaviors/Player.js +1204 -0
- package/kits/physics-3d/play/behaviors/Shape.js +47 -0
- package/kits/physics-3d/play/behaviors/Solid.js +16 -0
- package/kits/physics-3d/play/behaviors/Transform.js +29 -0
- package/kits/physics-3d/pnpm-lock.yaml +8 -0
- package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
- package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
- package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
- package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
- package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
- package/kits/physics-3d/scripts/test-gait.mjs +387 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
- package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
- package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
- package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
- package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
- package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +419 -9
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +33 -10
- package/kits/real-time/code/client/gameHooks.js +2 -0
- package/kits/real-time/code/client/joinOverlay.js +9 -4
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +102 -22
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
|
@@ -0,0 +1,408 @@
|
|
|
1
|
+
// Observed progress (contract v1.141, `docs/observed-progress.md`): where the
|
|
2
|
+
// kit has seen a player walk, for a door that scores from where players stand.
|
|
3
|
+
//
|
|
4
|
+
// A connected player's body is a kinematic capsule the server sets from the
|
|
5
|
+
// client's last accepted report, so the body is never evidence on its own.
|
|
6
|
+
// Once a tick, after physics and before any authored step, the kit looks at
|
|
7
|
+
// every body and asks whether the move since the last look is one a walker
|
|
8
|
+
// could make. What it admits is the observed position (`hub.observed`); a door
|
|
9
|
+
// declares the spots it scores (`hub.station`) and reads how long each player
|
|
10
|
+
// has stood there after walking in (`hub.dwell`).
|
|
11
|
+
//
|
|
12
|
+
// hub.observed(playerId) -> { at, step, ok, travel, since, speed } | null
|
|
13
|
+
// hub.station(id, { at, radius, height? } | null)
|
|
14
|
+
// hub.dwell(playerId, id) -> { inside, entered, ms } | null
|
|
15
|
+
//
|
|
16
|
+
// Nothing is kept until a place first calls `hub.observed` or `hub.station`
|
|
17
|
+
// (`h.observe` stays null), so a place that never asks pays nothing.
|
|
18
|
+
|
|
19
|
+
import { warnOnce } from './actors.js';
|
|
20
|
+
|
|
21
|
+
// multiplayer-3d's world bounds (`Limits.BOUNDS`), which its `setPose` holds
|
|
22
|
+
// every report to. Mirrored rather than imported: the hub layer's own modules
|
|
23
|
+
// load without multiplayer-3d's server, as its unit tests run them.
|
|
24
|
+
export const BOUNDS = { xz: 200, low: -30, high: 80 };
|
|
25
|
+
|
|
26
|
+
// The walk speed a scene's Player has when it names none (physics-3d's
|
|
27
|
+
// `Player.defaultProps.speed`), and the tolerance over it a walker gets.
|
|
28
|
+
export const DEFAULT_SPEED = 6;
|
|
29
|
+
export const TOLERANCE = 1.25;
|
|
30
|
+
// The most credit a player may hold: this many seconds of allowance, plus a
|
|
31
|
+
// fixed slack (metres).
|
|
32
|
+
export const CREDIT_S = 0.4;
|
|
33
|
+
export const CREDIT_SLACK = 0.3;
|
|
34
|
+
// Slack on the reachability test every step must pass (metres).
|
|
35
|
+
export const REACH_SLACK = 0.5;
|
|
36
|
+
// The most a tick may add to the credit clock beyond the sim's own delta
|
|
37
|
+
// (seconds): a server stall the sim delta does not show (`pass`).
|
|
38
|
+
export const MAX_EXTRA_S = 1;
|
|
39
|
+
// A station's exit band beyond its radius (metres), and its default height.
|
|
40
|
+
export const EXIT_BAND = 0.25;
|
|
41
|
+
export const DEFAULT_HEIGHT = 2;
|
|
42
|
+
// A placement nearer than this (flat metres) to the observed spot is not a move.
|
|
43
|
+
export const PLACE_SAME_M = 0.05;
|
|
44
|
+
// The most stations a place may declare, and the bounds on their numbers.
|
|
45
|
+
export const MAX_STATIONS = 64;
|
|
46
|
+
export const MAX_RADIUS = 200;
|
|
47
|
+
export const MAX_HEIGHT = 200;
|
|
48
|
+
const MAX_COORD = 1e6;
|
|
49
|
+
const EPS = 1e-6;
|
|
50
|
+
const ID = /^[A-Za-z0-9_.:-]{1,64}$/;
|
|
51
|
+
|
|
52
|
+
// The wall clock, which a test may replace through the layer's engine
|
|
53
|
+
// (`engine.wallNow`).
|
|
54
|
+
function wallNow(h) {
|
|
55
|
+
return (h.engine?.wallNow ?? Date.now)();
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function flat(a, b) {
|
|
59
|
+
return Math.hypot(a.x - b.x, a.z - b.z);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function finitePoint(p) {
|
|
63
|
+
return Boolean(p) && Number.isFinite(p.x) && Number.isFinite(p.y) && Number.isFinite(p.z);
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
function inBounds(p) {
|
|
67
|
+
return Math.abs(p.x) <= BOUNDS.xz && Math.abs(p.z) <= BOUNDS.xz && p.y >= BOUNDS.low && p.y <= BOUNDS.high;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// Where a body is after physics: its capsule's translation, or the accepted
|
|
71
|
+
// target for an entry without one.
|
|
72
|
+
function bodyAt(entry) {
|
|
73
|
+
const t = entry.body?.translation?.() ?? entry.at;
|
|
74
|
+
return { x: t.x, y: t.y, z: t.z };
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// The allowance for one player, m/s: the scene Player's speed times their own
|
|
78
|
+
// `hub.tune` speed, times the tolerance.
|
|
79
|
+
function allowanceOf(h, playerId) {
|
|
80
|
+
const props = h.actors?.find((a) => a.components?.Player)?.components.Player;
|
|
81
|
+
const base = Number.isFinite(props?.speed) && props.speed > 0 ? props.speed : DEFAULT_SPEED;
|
|
82
|
+
const tuned = h.tunes?.get(playerId)?.speed;
|
|
83
|
+
return base * (Number.isFinite(tuned) && tuned > 0 ? tuned : 1) * TOLERANCE;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
// --- state -------------------------------------------------------------------
|
|
87
|
+
|
|
88
|
+
// The first call that needs it starts observation: every current body is
|
|
89
|
+
// reset where it stands.
|
|
90
|
+
function activate(h) {
|
|
91
|
+
if (h.observe) {
|
|
92
|
+
return h.observe;
|
|
93
|
+
}
|
|
94
|
+
h.observe = {
|
|
95
|
+
// playerId -> the record below (`resetRecord`)
|
|
96
|
+
records: new Map(),
|
|
97
|
+
// station id -> { at, radius, height }
|
|
98
|
+
stations: new Map(),
|
|
99
|
+
// The credit clock (seconds since observation began): the larger of the
|
|
100
|
+
// sim's and the wall's totals, so a server stall the sim does not show is
|
|
101
|
+
// still counted, but tick quantisation is never counted twice. `simTotal`
|
|
102
|
+
// is the sim's total at the last pass.
|
|
103
|
+
clock: 0,
|
|
104
|
+
simTotal: 0,
|
|
105
|
+
simStart: h.sim?.timeMs ?? 0,
|
|
106
|
+
wallStart: wallNow(h),
|
|
107
|
+
};
|
|
108
|
+
for (const [playerId, entry] of h.sim?.players ?? []) {
|
|
109
|
+
resetRecord(h, playerId, entry);
|
|
110
|
+
}
|
|
111
|
+
return h.observe;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// Is the point inside a station's cylinder: within `radius` (or `reach`)
|
|
115
|
+
// flat and within its height band.
|
|
116
|
+
function within(station, at, reach = station.radius) {
|
|
117
|
+
return flat(at, station.at) <= reach + EPS && Math.abs(at.y - station.at.y) <= station.height / 2 + EPS;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function freshPair(station, at) {
|
|
121
|
+
return { state: 'unknown', inside: within(station, at), ms: 0 };
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// A reset (contract: Resets): the body is where the player is, from now. Travel
|
|
125
|
+
// and credit start over and every station must be walked into again.
|
|
126
|
+
// `at` is where the reset puts the player: the body, or a placement's
|
|
127
|
+
// destination (`placed`).
|
|
128
|
+
function resetRecord(h, playerId, entry, at = bodyAt(entry)) {
|
|
129
|
+
const obs = h.observe;
|
|
130
|
+
const rec = {
|
|
131
|
+
entry,
|
|
132
|
+
body: entry.body ?? null,
|
|
133
|
+
at,
|
|
134
|
+
step: { x: 0, y: 0, z: 0 },
|
|
135
|
+
ok: true,
|
|
136
|
+
travel: 0,
|
|
137
|
+
since: h.sim?.timeMs ?? 0,
|
|
138
|
+
speed: allowanceOf(h, playerId),
|
|
139
|
+
// Signed walking credit, metres (`observe`): filled by the allowance,
|
|
140
|
+
// capped, spent by every step taken, and negative while a jump is owed.
|
|
141
|
+
credit: 0,
|
|
142
|
+
// the credit clock when `at` last moved (a walked step, a resync or a reset)
|
|
143
|
+
movedAt: obs.clock,
|
|
144
|
+
// where a placement since the last pass put the body, or null (`placed`)
|
|
145
|
+
placedAt: null,
|
|
146
|
+
// station id -> { state: 'unknown' | 'out' | 'in', inside, ms }
|
|
147
|
+
pairs: new Map(),
|
|
148
|
+
};
|
|
149
|
+
for (const [id, station] of obs.stations) {
|
|
150
|
+
rec.pairs.set(id, freshPair(station, at));
|
|
151
|
+
}
|
|
152
|
+
obs.records.set(playerId, rec);
|
|
153
|
+
return rec;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
// Every station back to unknown, and its dwell to nothing.
|
|
157
|
+
function clearPairs(rec, inside = null) {
|
|
158
|
+
for (const pair of rec.pairs.values()) {
|
|
159
|
+
pair.state = 'unknown';
|
|
160
|
+
pair.ms = 0;
|
|
161
|
+
if (inside !== null) {
|
|
162
|
+
pair.inside = inside;
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
// --- the pass ----------------------------------------------------------------
|
|
168
|
+
|
|
169
|
+
// Once a tick, first in the layer's `step`: each body is admitted, resynced or
|
|
170
|
+
// rejected against where it was last observed. Nothing at all before a place
|
|
171
|
+
// asked for observation.
|
|
172
|
+
export function pass(h) {
|
|
173
|
+
const obs = h.observe;
|
|
174
|
+
if (!obs || !h.sim) {
|
|
175
|
+
return;
|
|
176
|
+
}
|
|
177
|
+
const simTotal = Math.max(obs.simTotal, (h.sim.timeMs - obs.simStart) / 1000);
|
|
178
|
+
const wallTotal = (wallNow(h) - obs.wallStart) / 1000;
|
|
179
|
+
const simDt = Number.isFinite(simTotal) ? simTotal - obs.simTotal : 0;
|
|
180
|
+
obs.simTotal = Number.isFinite(simTotal) ? simTotal : obs.simTotal;
|
|
181
|
+
// Real time caps the sim delta after a server stall; the wall clock does
|
|
182
|
+
// not. One clock, the larger total, never a sum of per-tick maxima.
|
|
183
|
+
const ahead = Number.isFinite(wallTotal) ? Math.max(obs.simTotal, wallTotal) : obs.simTotal;
|
|
184
|
+
const clock = Math.max(obs.clock, Math.min(ahead, obs.clock + simDt + MAX_EXTRA_S));
|
|
185
|
+
const elapsed = clock - obs.clock;
|
|
186
|
+
obs.clock = clock;
|
|
187
|
+
for (const playerId of obs.records.keys()) {
|
|
188
|
+
if (!h.sim.players.has(playerId)) {
|
|
189
|
+
obs.records.delete(playerId);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
const present = new Set((h.session?.players ?? []).map((p) => p.playerId));
|
|
193
|
+
for (const [playerId, entry] of h.sim.players) {
|
|
194
|
+
let rec = obs.records.get(playerId);
|
|
195
|
+
if (!rec || rec.entry !== entry || rec.body !== (entry.body ?? null)) {
|
|
196
|
+
// A new sim entry or a new capsule: observed for the first time.
|
|
197
|
+
rec = resetRecord(h, playerId, entry);
|
|
198
|
+
} else if (rec.placedAt) {
|
|
199
|
+
// A placement: reset where the kit put the body, then admit whatever
|
|
200
|
+
// reports moved it since, from there and with no credit.
|
|
201
|
+
rec = resetRecord(h, playerId, entry, rec.placedAt);
|
|
202
|
+
observe(h, playerId, rec, bodyAt(entry), 0);
|
|
203
|
+
} else {
|
|
204
|
+
observe(h, playerId, rec, bodyAt(entry), elapsed);
|
|
205
|
+
}
|
|
206
|
+
stations(h, rec, present.has(playerId), simDt);
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
// One body against its record (contract: Admission). One signed credit, a
|
|
211
|
+
// token bucket that may go negative: the allowance fills it, every step spends
|
|
212
|
+
// it, so no metre of allowance is spent twice and a deficit is paid back by
|
|
213
|
+
// walking slower than the allowance or by standing, never discarded.
|
|
214
|
+
function observe(h, playerId, rec, at, elapsed) {
|
|
215
|
+
const obs = h.observe;
|
|
216
|
+
rec.speed = allowanceOf(h, playerId);
|
|
217
|
+
rec.credit = Math.min(CREDIT_S * rec.speed + CREDIT_SLACK, rec.credit + rec.speed * elapsed);
|
|
218
|
+
rec.funded = false;
|
|
219
|
+
if (!finitePoint(at) || !inBounds(at)) {
|
|
220
|
+
reject(rec);
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
const d = flat(at, rec.at);
|
|
224
|
+
// Unreachable from where the player last moved at the allowance: rejected,
|
|
225
|
+
// and nothing is spent. Standing still does not renew `movedAt`: a server
|
|
226
|
+
// that hears nothing cannot tell a player standing from a stalled connection.
|
|
227
|
+
if (d > rec.speed * (obs.clock - rec.movedAt) + REACH_SLACK) {
|
|
228
|
+
reject(rec);
|
|
229
|
+
return;
|
|
230
|
+
}
|
|
231
|
+
rec.credit -= d;
|
|
232
|
+
// Under EPS is the capsule's float rounding, not a step.
|
|
233
|
+
if (d > EPS) {
|
|
234
|
+
rec.movedAt = obs.clock;
|
|
235
|
+
}
|
|
236
|
+
const from = rec.at;
|
|
237
|
+
rec.at = at;
|
|
238
|
+
rec.ok = true;
|
|
239
|
+
if (rec.credit >= -EPS) {
|
|
240
|
+
// Funded: walked, and the step is travel.
|
|
241
|
+
rec.step = { x: at.x - from.x, y: at.y - from.y, z: at.z - from.z };
|
|
242
|
+
if (d > EPS) {
|
|
243
|
+
rec.travel += d;
|
|
244
|
+
}
|
|
245
|
+
rec.funded = true;
|
|
246
|
+
return;
|
|
247
|
+
}
|
|
248
|
+
// Unfunded (a resync): a stall's burst, a sparse curved walk, a jump. The
|
|
249
|
+
// body is adopted, but nothing is earned until the credit is back.
|
|
250
|
+
rec.step = { x: 0, y: 0, z: 0 };
|
|
251
|
+
clearPairs(rec);
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
function reject(rec) {
|
|
255
|
+
rec.step = { x: 0, y: 0, z: 0 };
|
|
256
|
+
rec.ok = false;
|
|
257
|
+
clearPairs(rec);
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
// Each station against the observed position (contract: Stations). Only a
|
|
261
|
+
// funded observation moves a station's state. `simDt` is game time, which is
|
|
262
|
+
// what dwell counts.
|
|
263
|
+
function stations(h, rec, present, simDt) {
|
|
264
|
+
for (const [id, station] of h.observe.stations) {
|
|
265
|
+
let pair = rec.pairs.get(id);
|
|
266
|
+
if (!pair) {
|
|
267
|
+
pair = freshPair(station, rec.at);
|
|
268
|
+
rec.pairs.set(id, pair);
|
|
269
|
+
}
|
|
270
|
+
const exit = station.radius + EXIT_BAND;
|
|
271
|
+
const beyond = flat(rec.at, station.at) > exit + EPS;
|
|
272
|
+
// Hysteresis on `inside`: in from the radius, out beyond the exit band.
|
|
273
|
+
if (within(station, rec.at)) {
|
|
274
|
+
pair.inside = true;
|
|
275
|
+
} else if (beyond || !within(station, rec.at, exit)) {
|
|
276
|
+
pair.inside = false;
|
|
277
|
+
}
|
|
278
|
+
if (!rec.funded) {
|
|
279
|
+
// An unfunded or rejected observation's position sets nothing.
|
|
280
|
+
} else if (beyond) {
|
|
281
|
+
pair.state = 'out';
|
|
282
|
+
pair.ms = 0;
|
|
283
|
+
} else if (pair.state === 'out' && within(station, rec.at)) {
|
|
284
|
+
// Walked in, by a funded step.
|
|
285
|
+
pair.state = 'in';
|
|
286
|
+
pair.ms = 0;
|
|
287
|
+
}
|
|
288
|
+
if (pair.state === 'in' && rec.ok && present) {
|
|
289
|
+
pair.ms += simDt * 1000;
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
rec.funded = false;
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
// --- placements ---------------------------------------------------------------
|
|
296
|
+
|
|
297
|
+
// Every `moveBody` (hub.js), before the body moves: a placement more than
|
|
298
|
+
// PLACE_SAME_M from the observed spot invalidates the player at once, so a
|
|
299
|
+
// resume hook in the same tick already reads nothing. The next pass resets
|
|
300
|
+
// the player at the placement's destination, never at wherever reports took
|
|
301
|
+
// the body after it. A placement onto the same spot changes nothing, unless
|
|
302
|
+
// another placement is already pending, which the latest one replaces.
|
|
303
|
+
export function placed(h, playerId, at) {
|
|
304
|
+
const rec = h.observe?.records.get(playerId);
|
|
305
|
+
if (!rec || (!rec.placedAt && flat(at, rec.at) <= PLACE_SAME_M)) {
|
|
306
|
+
return;
|
|
307
|
+
}
|
|
308
|
+
rec.placedAt = { x: at.x, y: at.y, z: at.z };
|
|
309
|
+
rec.ok = false;
|
|
310
|
+
rec.travel = 0;
|
|
311
|
+
rec.step = { x: 0, y: 0, z: 0 };
|
|
312
|
+
clearPairs(rec, false);
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
// --- the API ------------------------------------------------------------------
|
|
316
|
+
|
|
317
|
+
// `hub.observed(playerId)`: copies of the player's observation, or null for a
|
|
318
|
+
// player with no body here.
|
|
319
|
+
export function observed(h, playerId) {
|
|
320
|
+
if (typeof playerId !== 'string') {
|
|
321
|
+
warnOnce(h, 'observed:id', 'hub.observed: playerId must be a string');
|
|
322
|
+
return null;
|
|
323
|
+
}
|
|
324
|
+
const obs = activate(h);
|
|
325
|
+
const entry = h.sim?.players.get(playerId);
|
|
326
|
+
if (!entry) {
|
|
327
|
+
return null;
|
|
328
|
+
}
|
|
329
|
+
let rec = obs.records.get(playerId);
|
|
330
|
+
if (!rec) {
|
|
331
|
+
// A body that joined since the last pass: observed for the first time.
|
|
332
|
+
rec = resetRecord(h, playerId, entry);
|
|
333
|
+
}
|
|
334
|
+
return {
|
|
335
|
+
at: { ...rec.at },
|
|
336
|
+
step: { ...rec.step },
|
|
337
|
+
ok: rec.ok,
|
|
338
|
+
travel: rec.travel,
|
|
339
|
+
since: rec.since,
|
|
340
|
+
speed: rec.speed,
|
|
341
|
+
};
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
function readStation(h, spec) {
|
|
345
|
+
if (!spec || typeof spec !== 'object' || !finitePoint(spec.at)) {
|
|
346
|
+
return null;
|
|
347
|
+
}
|
|
348
|
+
const at = { x: spec.at.x, y: spec.at.y, z: spec.at.z };
|
|
349
|
+
if (![at.x, at.y, at.z].every((v) => Math.abs(v) <= MAX_COORD)) {
|
|
350
|
+
return null;
|
|
351
|
+
}
|
|
352
|
+
const { radius } = spec;
|
|
353
|
+
const height = spec.height === undefined ? DEFAULT_HEIGHT : spec.height;
|
|
354
|
+
if (!Number.isFinite(radius) || radius <= 0 || radius > MAX_RADIUS) {
|
|
355
|
+
return null;
|
|
356
|
+
}
|
|
357
|
+
if (!Number.isFinite(height) || height <= 0 || height > MAX_HEIGHT) {
|
|
358
|
+
return null;
|
|
359
|
+
}
|
|
360
|
+
return { at, radius, height };
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
// `hub.station(id, { at, radius, height } | null)`: declare, change or remove
|
|
364
|
+
// a station. The same shape again changes nothing; a new shape zeroes every
|
|
365
|
+
// player's dwell there. True when taken; a bad call warns once, returns false
|
|
366
|
+
// and changes nothing.
|
|
367
|
+
export function station(h, id, spec) {
|
|
368
|
+
if (typeof id !== 'string' || !ID.test(id)) {
|
|
369
|
+
warnOnce(h, 'station:id', 'hub.station: id must be 1-64 letters, digits, _ . : or -');
|
|
370
|
+
return false;
|
|
371
|
+
}
|
|
372
|
+
const obs = activate(h);
|
|
373
|
+
if (spec === null) {
|
|
374
|
+
obs.stations.delete(id);
|
|
375
|
+
for (const rec of obs.records.values()) {
|
|
376
|
+
rec.pairs.delete(id);
|
|
377
|
+
}
|
|
378
|
+
return true;
|
|
379
|
+
}
|
|
380
|
+
const shape = readStation(h, spec);
|
|
381
|
+
if (!shape) {
|
|
382
|
+
warnOnce(h, 'station:spec', `hub.station: "${id}" needs { at: { x, y, z }, radius, height? }, finite, radius and height above 0 and at most ${MAX_RADIUS} m`);
|
|
383
|
+
return false;
|
|
384
|
+
}
|
|
385
|
+
const old = obs.stations.get(id);
|
|
386
|
+
if (old && old.radius === shape.radius && old.height === shape.height && old.at.x === shape.at.x && old.at.y === shape.at.y && old.at.z === shape.at.z) {
|
|
387
|
+
return true;
|
|
388
|
+
}
|
|
389
|
+
if (!old && obs.stations.size >= MAX_STATIONS) {
|
|
390
|
+
warnOnce(h, 'station:max', `hub.station: at most ${MAX_STATIONS} stations`);
|
|
391
|
+
return false;
|
|
392
|
+
}
|
|
393
|
+
obs.stations.set(id, shape);
|
|
394
|
+
for (const rec of obs.records.values()) {
|
|
395
|
+
rec.pairs.set(id, freshPair(shape, rec.at));
|
|
396
|
+
}
|
|
397
|
+
return true;
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
// `hub.dwell(playerId, id)`: `{ inside, entered, ms }` for a player observed
|
|
401
|
+
// here and a declared station, or null.
|
|
402
|
+
export function dwell(h, playerId, id) {
|
|
403
|
+
const pair = h.observe?.records.get(playerId)?.pairs.get(id);
|
|
404
|
+
if (!pair) {
|
|
405
|
+
return null;
|
|
406
|
+
}
|
|
407
|
+
return { inside: pair.inside, entered: pair.state === 'in', ms: pair.ms };
|
|
408
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
// Scene-only opt-in. No roster or membership metadata is sent to the client:
|
|
2
|
+
// the existing private label carries the viewer's own eligible count.
|
|
3
|
+
export function makePadOccupancy(actors) {
|
|
4
|
+
const pads = actors.filter((a) => a.components.HubPad && a.components.Transform);
|
|
5
|
+
const doors = new Set();
|
|
6
|
+
const ambiguous = new Set();
|
|
7
|
+
for (const pad of pads) {
|
|
8
|
+
const door = pad.components.HubPad.door;
|
|
9
|
+
if (doors.has(door)) {ambiguous.add(door);}
|
|
10
|
+
doors.add(door);
|
|
11
|
+
}
|
|
12
|
+
return {
|
|
13
|
+
pads,
|
|
14
|
+
ambiguous,
|
|
15
|
+
reportedAt: new Map(),
|
|
16
|
+
selected: new Map(),
|
|
17
|
+
known: null,
|
|
18
|
+
knownAt: -Infinity,
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
const fresh = (at, now) => Number.isFinite(at) && now >= at && now - at <= 500;
|
|
23
|
+
const visible = (h, viewer, id) => !(h.visMe?.get(viewer)?.get(id) ?? h.hidden.has(id));
|
|
24
|
+
|
|
25
|
+
// Only the roster already committed by the transport is eligible, and only
|
|
26
|
+
// while current. Revocations and departures beat that roster immediately.
|
|
27
|
+
export function occupancyLine(h, pad, viewer, blocked) {
|
|
28
|
+
const state = h.padOccupancy;
|
|
29
|
+
const now = h.sim.timeMs;
|
|
30
|
+
const door = pad.components.HubPad.door;
|
|
31
|
+
const members = h.padDoors.get(door);
|
|
32
|
+
const known = state.known?.get(viewer);
|
|
33
|
+
if (state.ambiguous.has(door) || !members || !known || !fresh(state.reportedAt.get(door), now) || !fresh(state.knownAt, now)) {
|
|
34
|
+
return 'occupancy unavailable';
|
|
35
|
+
}
|
|
36
|
+
const connected = new Set(h.session?.players.map((p) => p.playerId) ?? []);
|
|
37
|
+
const self = members.has(viewer) && connected.has(viewer) && h.sim.players.has(viewer);
|
|
38
|
+
let others = 0;
|
|
39
|
+
for (const id of members) {
|
|
40
|
+
if (id !== viewer && known.has(id) && connected.has(id) && h.sim.players.has(id) && !blocked?.has(id) && visible(h, viewer, id)) {
|
|
41
|
+
others += 1;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return self ? `you + ${others} more` : `${others} here`;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
// A single pad per viewer, retained while valid. Being on another pad wins
|
|
48
|
+
// over the previous nearby pad; overlapping valid pads retain their identity.
|
|
49
|
+
export function selectedPad(h, viewer) {
|
|
50
|
+
const state = h.padOccupancy;
|
|
51
|
+
const at = h.sim.players.get(viewer)?.at;
|
|
52
|
+
if (!at) {return null;}
|
|
53
|
+
const now = h.sim.timeMs;
|
|
54
|
+
const candidates = state.pads.filter((pad) => {
|
|
55
|
+
const t = pad.components.Transform;
|
|
56
|
+
return visible(h, viewer, pad.id) && Math.hypot(t.x - at.x, t.z - at.z) <= 4 && h.labels.has(pad.id);
|
|
57
|
+
});
|
|
58
|
+
const on = candidates.filter((pad) => fresh(state.reportedAt.get(pad.components.HubPad.door), now) && h.padDoors.get(pad.components.HubPad.door)?.has(viewer));
|
|
59
|
+
const pool = on.length ? on : candidates;
|
|
60
|
+
const prior = pool.find((pad) => pad.id === state.selected.get(viewer));
|
|
61
|
+
const chosen = prior ?? pool.sort((a, b) => {
|
|
62
|
+
const ta = a.components.Transform;
|
|
63
|
+
const tb = b.components.Transform;
|
|
64
|
+
return Math.hypot(ta.x - at.x, ta.z - at.z) - Math.hypot(tb.x - at.x, tb.z - at.z) || a.id.localeCompare(b.id);
|
|
65
|
+
})[0];
|
|
66
|
+
if (chosen) {state.selected.set(viewer, chosen.id);} else {state.selected.delete(viewer);}
|
|
67
|
+
return chosen ?? null;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function addOccupancy(h, viewer, out, blocked, labelFor) {
|
|
71
|
+
const pad = selectedPad(h, viewer);
|
|
72
|
+
if (!pad) {return;}
|
|
73
|
+
const label = out[pad.id] ?? (labelFor ? labelFor(pad.id) : h.labels.get(pad.id));
|
|
74
|
+
// Goals and NPC speech retain their existing precedence.
|
|
75
|
+
if (!label || label.style === 'goal' || label.style === 'speech') {return;}
|
|
76
|
+
const line = occupancyLine(h, pad, viewer, blocked);
|
|
77
|
+
// A long decorative title/record yields to the supporting occupancy line;
|
|
78
|
+
// compact cabinet instructions are authored by the marker-ON deck branch.
|
|
79
|
+
const text = String(label.text);
|
|
80
|
+
if (text.length + line.length + 1 > 64) {
|
|
81
|
+
out[pad.id] = { text: line, style: label.style };
|
|
82
|
+
return;
|
|
83
|
+
}
|
|
84
|
+
out[pad.id] = { text: `${text}\n${line}`, style: label.style };
|
|
85
|
+
}
|
|
@@ -111,7 +111,7 @@ function hidden(d, a, b) {
|
|
|
111
111
|
return Boolean(d.blockedPairs(d.h)?.get(a)?.has(b));
|
|
112
112
|
}
|
|
113
113
|
|
|
114
|
-
// `d` is the hub layer's own: `{ h, blockedPairs, usernameOf, placeAt, stand,
|
|
114
|
+
// `d` is the hub layer's own: `{ h, blockedPairs, usernameOf, standingY, placeAt, stand,
|
|
115
115
|
// jumpDoors, front }`.
|
|
116
116
|
export function message(d, player, data) {
|
|
117
117
|
const h = d.h;
|
|
@@ -256,7 +256,7 @@ export function toPad(d, playerId, door, n) {
|
|
|
256
256
|
}
|
|
257
257
|
const facing = ((door.t.rotationY ?? 0) + 180) * DEG;
|
|
258
258
|
const at = padPoint(h, door, n, playerId) ?? d.front(door);
|
|
259
|
-
d.placeAt(h, playerId, { x: at.x, y: 1.2, z: at.z }, facing);
|
|
259
|
+
d.placeAt(h, playerId, { x: at.x, y: d.standingY(h, { ...at, y: 1.2 }), z: at.z }, facing);
|
|
260
260
|
h.session?.send(playerId, { k: 'hub-jumped', facing });
|
|
261
261
|
return true;
|
|
262
262
|
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
// A hub's first WORLD must put a new body at standing height (v1.48). The
|
|
2
|
+
// multiplayer spawn's drop height lifted a client that had already landed,
|
|
3
|
+
// before the arrival row ran. A readable saved pose remains the player's own.
|
|
4
|
+
//
|
|
5
|
+
// And on the scene's spawn itself, not the multiplayer spawn ring around it:
|
|
6
|
+
// the client starts its body at the spawn, and a WORLD that put it 1.1 m off
|
|
7
|
+
// on the ring was followed by the arrival row back at the spawn, which the
|
|
8
|
+
// client eased to as a correction: a glide just after the cover lifted (Oct
|
|
9
|
+
// 17, live Town; v1.147). A player waits for their group where their client agrees
|
|
10
|
+
// they are; the arrival row spreads a group out.
|
|
11
|
+
import * as Players from '@imports/castle.multiplayer-3d/code/server/players.js';
|
|
12
|
+
import { readPoint } from '@imports/castle.multiplayer-3d/code/server/limits.js';
|
|
13
|
+
|
|
14
|
+
// The hub layer has read the place and its actors in ready before admission.
|
|
15
|
+
// Keep a closure over that layer, so joins see spawned and hidden actors too.
|
|
16
|
+
export function hubPlayers(hub) {
|
|
17
|
+
return {
|
|
18
|
+
...Players,
|
|
19
|
+
addPlayer(sim, playerId, pose) {
|
|
20
|
+
const result = Players.addPlayer(sim, playerId, pose);
|
|
21
|
+
if (!pose || !readPoint(pose)) {
|
|
22
|
+
const player = sim.players.get(playerId);
|
|
23
|
+
const at = { ...player.at, x: sim.spawn?.x ?? player.at.x, z: sim.spawn?.z ?? player.at.z };
|
|
24
|
+
player.at = { ...at, y: hub.standingY?.(sim, at) ?? at.y };
|
|
25
|
+
player.body.setTranslation(player.at, true);
|
|
26
|
+
}
|
|
27
|
+
return result;
|
|
28
|
+
},
|
|
29
|
+
};
|
|
30
|
+
}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
// Revision-checked, server-owned deck rows survive private-session shutdown.
|
|
2
|
+
// Empty active targets fence delayed end/travel writes without storing a row.
|
|
3
|
+
export const TTL_MS = 10 * 60000;
|
|
4
|
+
export const READ_MS = 5000;
|
|
5
|
+
const PREFIX = 'hub:resumePose:';
|
|
6
|
+
|
|
7
|
+
export function store(session, placeId, owner = null) {
|
|
8
|
+
const storage = session?.storage?.deck;
|
|
9
|
+
const pending = new Map();
|
|
10
|
+
const leases = new Map();
|
|
11
|
+
let cleanup = null;
|
|
12
|
+
let cursor = null;
|
|
13
|
+
const prefix = (userId) => `${PREFIX}${JSON.stringify([placeId, owner, userId])}:`;
|
|
14
|
+
const operationId = () => `pose-${Date.now()}-${Math.random().toString(36).slice(2)}`;
|
|
15
|
+
const enqueue = (userId, run) => {
|
|
16
|
+
const next = (pending.get(userId) ?? Promise.resolve()).then(run).catch((error) => {
|
|
17
|
+
console.warn(`[hub] resumePose storage failed: ${error?.code ?? error?.message ?? error}`);
|
|
18
|
+
return null;
|
|
19
|
+
});
|
|
20
|
+
pending.set(userId, next);
|
|
21
|
+
void next.then(() => {
|
|
22
|
+
if (pending.get(userId) === next) {
|
|
23
|
+
pending.delete(userId);
|
|
24
|
+
}
|
|
25
|
+
});
|
|
26
|
+
return next;
|
|
27
|
+
};
|
|
28
|
+
const change = async (p, snapshot, revision, rows) => {
|
|
29
|
+
const receipt = await storage.transaction({
|
|
30
|
+
operationId: operationId(),
|
|
31
|
+
expectedAccess: snapshot.access,
|
|
32
|
+
changes: [{ prefix: p, expectedRevision: revision, replace: rows }],
|
|
33
|
+
});
|
|
34
|
+
return receipt.revisions[0].revision;
|
|
35
|
+
};
|
|
36
|
+
const supported = () =>
|
|
37
|
+
typeof storage?.snapshot === 'function' && typeof storage?.transaction === 'function';
|
|
38
|
+
const valid = (row) =>
|
|
39
|
+
row &&
|
|
40
|
+
Number.isFinite(row.endedAt) &&
|
|
41
|
+
Date.now() >= row.endedAt &&
|
|
42
|
+
Date.now() - row.endedAt < TTL_MS &&
|
|
43
|
+
row.at &&
|
|
44
|
+
[row.at.x, row.at.y, row.at.z, row.facing].every(Number.isFinite);
|
|
45
|
+
return {
|
|
46
|
+
end(userId, pose, endedAt = Date.now(), visitId = userId) {
|
|
47
|
+
if (!userId || !supported()) {
|
|
48
|
+
return Promise.resolve();
|
|
49
|
+
}
|
|
50
|
+
return enqueue(userId, async () => {
|
|
51
|
+
const lease = leases.get(visitId);
|
|
52
|
+
leases.delete(visitId);
|
|
53
|
+
if (!lease) {
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
const p = prefix(userId);
|
|
57
|
+
await change(p, lease, lease.revision, {
|
|
58
|
+
[p + 'pose']: { at: { ...pose.at }, facing: pose.facing, endedAt },
|
|
59
|
+
});
|
|
60
|
+
});
|
|
61
|
+
},
|
|
62
|
+
clear(userId, visitId = userId) {
|
|
63
|
+
if (!userId || !supported()) {
|
|
64
|
+
return Promise.resolve();
|
|
65
|
+
}
|
|
66
|
+
return enqueue(userId, async () => {
|
|
67
|
+
const lease = leases.get(visitId);
|
|
68
|
+
leases.delete(visitId);
|
|
69
|
+
if (lease) {
|
|
70
|
+
await change(prefix(userId), lease, lease.revision, {});
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
},
|
|
74
|
+
async take(userId, visitId = userId) {
|
|
75
|
+
if (!userId || !supported()) {
|
|
76
|
+
return null;
|
|
77
|
+
}
|
|
78
|
+
const deadline = Date.now() + READ_MS;
|
|
79
|
+
const work = enqueue(userId, async () => {
|
|
80
|
+
if (Date.now() >= deadline) {
|
|
81
|
+
return null;
|
|
82
|
+
}
|
|
83
|
+
const p = prefix(userId);
|
|
84
|
+
const snapshot = await storage.snapshot({ prefix: p });
|
|
85
|
+
if (Date.now() >= deadline) {
|
|
86
|
+
return null;
|
|
87
|
+
}
|
|
88
|
+
const target = snapshot.targets[0];
|
|
89
|
+
const row = target.rows[p + 'pose'];
|
|
90
|
+
// A concurrent claim or a door clear changes this revision. A failed
|
|
91
|
+
// transaction restores nothing, and an old socket cannot write later.
|
|
92
|
+
const revision = await change(p, snapshot, target.revision, {});
|
|
93
|
+
if (Date.now() >= deadline) {
|
|
94
|
+
return null;
|
|
95
|
+
}
|
|
96
|
+
leases.set(visitId, { access: snapshot.access, revision });
|
|
97
|
+
return valid(row) ? { at: { ...row.at }, facing: row.facing } : null;
|
|
98
|
+
});
|
|
99
|
+
let timer;
|
|
100
|
+
try {
|
|
101
|
+
return await Promise.race([
|
|
102
|
+
work,
|
|
103
|
+
new Promise((resolve) => {
|
|
104
|
+
timer = setTimeout(() => resolve(null), READ_MS);
|
|
105
|
+
}),
|
|
106
|
+
]);
|
|
107
|
+
} finally {
|
|
108
|
+
clearTimeout(timer);
|
|
109
|
+
}
|
|
110
|
+
},
|
|
111
|
+
// Lazy expiry across owners/places too: at most one page per minute.
|
|
112
|
+
// Revision checks prevent cleanup from removing a concurrently resumed row.
|
|
113
|
+
prune() {
|
|
114
|
+
if (cleanup) {
|
|
115
|
+
return cleanup;
|
|
116
|
+
}
|
|
117
|
+
cleanup = (async () => {
|
|
118
|
+
if (!supported() || typeof storage.list !== 'function') {
|
|
119
|
+
return;
|
|
120
|
+
}
|
|
121
|
+
try {
|
|
122
|
+
const page = await storage.list({
|
|
123
|
+
prefix: PREFIX,
|
|
124
|
+
limit: 32,
|
|
125
|
+
...(cursor ? { cursor } : {}),
|
|
126
|
+
});
|
|
127
|
+
cursor = page.cursor ?? null;
|
|
128
|
+
for (const { key, value } of page.entries) {
|
|
129
|
+
if (valid(value) || !key.endsWith(':pose')) {
|
|
130
|
+
continue;
|
|
131
|
+
}
|
|
132
|
+
const p = key.slice(0, -4);
|
|
133
|
+
const snapshot = await storage.snapshot({ prefix: p });
|
|
134
|
+
if (snapshot.targets[0].rows[key] !== undefined && !valid(snapshot.targets[0].rows[key])) {
|
|
135
|
+
await change(p, snapshot, snapshot.targets[0].revision, {});
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
} catch (error) {
|
|
139
|
+
console.warn(
|
|
140
|
+
`[hub] resumePose cleanup failed: ${error?.code ?? error?.message ?? error}`,
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
})().finally(() => {
|
|
144
|
+
cleanup = null;
|
|
145
|
+
});
|
|
146
|
+
return cleanup;
|
|
147
|
+
},
|
|
148
|
+
async drain() {
|
|
149
|
+
await Promise.all(pending.values());
|
|
150
|
+
},
|
|
151
|
+
};
|
|
152
|
+
}
|