castle-web-cli 0.4.239 → 0.4.241
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.js +5 -1
- package/dist/api.d.ts +20 -0
- package/dist/api.js +57 -0
- package/dist/bundle.d.ts +38 -1
- package/dist/bundle.js +309 -13
- package/dist/castle-host/host.js +163 -11
- package/dist/castleJson.d.ts +10 -0
- package/dist/castleJson.js +46 -2
- package/dist/check.js +5 -2
- package/dist/devSessionServer.js +4 -1
- package/dist/devSessionStorage.d.ts +1 -0
- package/dist/devSessionStorage.js +32 -7
- package/dist/importOrder.d.ts +2 -0
- package/dist/importOrder.js +29 -0
- package/dist/index.js +6 -3
- package/dist/init.js +24 -2
- package/dist/multiplayerDoc.d.ts +1 -1
- package/dist/multiplayerDoc.js +2 -0
- package/dist/platformDoc.js +3 -2
- package/dist/playPagePolicy.js +5 -1
- package/dist/resetLeaderboards.d.ts +8 -1
- package/dist/resetLeaderboards.js +43 -8
- package/dist/roomLogs.d.ts +1 -0
- package/dist/roomLogs.js +30 -6
- package/dist/save-deck.d.ts +32 -2
- package/dist/save-deck.js +240 -39
- package/kits/base/CLAUDE.md +1 -1
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +174 -6
- package/kits/base/sdk/analytics.d.ts +8 -0
- package/kits/base/sdk/analytics.js +92 -0
- package/kits/base/sdk/castle.d.ts +5 -1
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +48 -0
- package/kits/base/sdk/commands.js +1 -0
- package/kits/base/sdk/debugConsole.d.ts +17 -0
- package/kits/base/sdk/debugConsole.js +154 -0
- package/kits/base/sdk/experiments.js +24 -1
- package/kits/base/sdk/hostRetry.d.ts +7 -0
- package/kits/base/sdk/hostRetry.js +57 -0
- package/kits/base/sdk/hub.d.ts +20 -2
- package/kits/base/sdk/hub.js +99 -13
- package/kits/base/sdk/multiplayer.d.ts +2 -0
- package/kits/base/sdk/multiplayer.js +168 -26
- package/kits/base/sdk/reconnectBudget.d.ts +6 -0
- package/kits/base/sdk/reconnectBudget.js +41 -1
- package/kits/base/sdk/runtime.js +36 -19
- package/kits/base/sdk/server/hub.d.ts +19 -0
- package/kits/base/sdk/server/hub.js +12 -0
- package/kits/base/sdk/server/platformHandle.d.ts +1 -0
- package/kits/base/sdk/server/wrapper.d.ts +1 -1
- package/kits/base/sdk/server/wrapper.js +26 -1
- package/kits/base/sdk/transport.d.ts +2 -1
- package/kits/base/sdk/transport.js +35 -0
- package/kits/hub-game/CLAUDE.md +66 -19
- package/kits/hub-game/code/client/act.js +9 -6
- package/kits/hub-game/code/client/actCore.js +26 -6
- package/kits/hub-game/code/client/actGateLog.js +36 -0
- package/kits/hub-game/code/client/actionOverflow.js +29 -8
- package/kits/hub-game/code/client/actionRailSurface.js +186 -0
- package/kits/hub-game/code/client/actionRailTree.js +173 -0
- package/kits/hub-game/code/client/askSurface.js +85 -0
- package/kits/hub-game/code/client/askTree.js +51 -0
- package/kits/hub-game/code/client/attention.js +31 -6
- package/kits/hub-game/code/client/ballot.js +42 -5
- package/kits/hub-game/code/client/ballotSurface.js +115 -0
- package/kits/hub-game/code/client/ballotTree.js +180 -0
- package/kits/hub-game/code/client/catchingUp.js +19 -0
- package/kits/hub-game/code/client/celebrate.js +66 -0
- package/kits/hub-game/code/client/chrome.js +481 -57
- package/kits/hub-game/code/client/companion.js +93 -23
- package/kits/hub-game/code/client/companionDress.js +1 -1
- package/kits/hub-game/code/client/cornerSurface.js +106 -0
- package/kits/hub-game/code/client/cornerTree.js +83 -0
- package/kits/hub-game/code/client/decor.js +20 -11
- package/kits/hub-game/code/client/deviceStorage.js +121 -0
- package/kits/hub-game/code/client/disguise.js +23 -0
- package/kits/hub-game/code/client/disguiseDraw.js +87 -0
- package/kits/hub-game/code/client/dockSurface.js +206 -0
- package/kits/hub-game/code/client/dockTree.js +232 -0
- package/kits/hub-game/code/client/earned.js +29 -0
- package/kits/hub-game/code/client/emoteSurface.js +188 -0
- package/kits/hub-game/code/client/emoteTree.js +264 -0
- package/kits/hub-game/code/client/farAvatars.js +4 -3
- package/kits/hub-game/code/client/fpsTelemetry.js +3 -1
- package/kits/hub-game/code/client/grab.js +121 -50
- package/kits/hub-game/code/client/holdShow.js +19 -0
- package/kits/hub-game/code/client/hookLayer.js +96 -12
- package/kits/hub-game/code/client/hubControls.js +7 -1
- package/kits/hub-game/code/client/hudSurface.js +11 -3
- package/kits/hub-game/code/client/hudTree.js +7 -4
- package/kits/hub-game/code/client/idle.js +21 -3
- package/kits/hub-game/code/client/invites.js +24 -3
- package/kits/hub-game/code/client/keys.js +15 -0
- package/kits/hub-game/code/client/labelsNear.js +8 -1
- package/kits/hub-game/code/client/layoutCache.js +57 -8
- package/kits/hub-game/code/client/loadingCover.js +53 -4
- package/kits/hub-game/code/client/menuIcons.js +15 -0
- package/kits/hub-game/code/client/menuSurface.js +102 -0
- package/kits/hub-game/code/client/menuTree.js +135 -0
- package/kits/hub-game/code/client/modelLook.js +41 -0
- package/kits/hub-game/code/client/padCues.js +11 -7
- package/kits/hub-game/code/client/padReadability.js +3 -3
- package/kits/hub-game/code/client/pickerSurface.js +152 -0
- package/kits/hub-game/code/client/pickerTree.js +163 -0
- package/kits/hub-game/code/client/pushVisit.js +4 -2
- package/kits/hub-game/code/client/quality.js +188 -29
- package/kits/hub-game/code/client/qualityEntry.js +10 -1
- package/kits/hub-game/code/client/quickChatSurface.js +222 -0
- package/kits/hub-game/code/client/quickChatTree.js +201 -0
- package/kits/hub-game/code/client/rehello.js +75 -0
- package/kits/hub-game/code/client/renderVisibility.js +17 -0
- package/kits/hub-game/code/client/replay.js +118 -0
- package/kits/hub-game/code/client/role.js +3 -0
- package/kits/hub-game/code/client/safeLayout.js +441 -56
- package/kits/hub-game/code/client/safeStyle.js +13 -10
- package/kits/hub-game/code/client/say.js +2 -0
- package/kits/hub-game/code/client/soundSurface.js +77 -0
- package/kits/hub-game/code/client/soundTree.js +74 -0
- package/kits/hub-game/code/client/soundscape.js +12 -9
- package/kits/hub-game/code/client/soundscapeCues.js +1 -1
- package/kits/hub-game/code/client/state.js +67 -1
- package/kits/hub-game/code/client/stuckSurface.js +76 -0
- package/kits/hub-game/code/client/stuckTree.js +67 -0
- package/kits/hub-game/code/client/talk.js +42 -12
- package/kits/hub-game/code/client/talkTree.js +4 -2
- package/kits/hub-game/code/client/textAskSurface.js +147 -0
- package/kits/hub-game/code/client/textAskTree.js +67 -0
- package/kits/hub-game/code/client/tiers.js +252 -27
- package/kits/hub-game/code/client/together.js +4 -1
- package/kits/hub-game/code/client/uiDom.js +86 -8
- package/kits/hub-game/code/client/uiTree.js +33 -4
- package/kits/hub-game/code/client/vehicle.js +72 -51
- package/kits/hub-game/code/client/weakestTier.js +75 -31
- package/kits/hub-game/code/client/wear.js +159 -5
- package/kits/hub-game/code/client/worldLabels.js +205 -25
- package/kits/hub-game/code/companionSpec.js +4 -2
- package/kits/hub-game/code/server/act.js +3 -0
- package/kits/hub-game/code/server/actGate.js +83 -0
- package/kits/hub-game/code/server/actions.js +71 -15
- package/kits/hub-game/code/server/actors.js +20 -5
- package/kits/hub-game/code/server/analytics.js +35 -3
- package/kits/hub-game/code/server/ask.js +39 -3
- package/kits/hub-game/code/server/ballot.js +167 -4
- package/kits/hub-game/code/server/celebrate.js +64 -0
- package/kits/hub-game/code/server/companion.js +17 -2
- package/kits/hub-game/code/server/decor.js +11 -2
- package/kits/hub-game/code/server/disguise.js +63 -0
- package/kits/hub-game/code/server/earned.js +6 -2
- package/kits/hub-game/code/server/friendBests.js +13 -4
- package/kits/hub-game/code/server/friendsAmong.js +67 -8
- package/kits/hub-game/code/server/grab.js +12 -2
- package/kits/hub-game/code/server/heldOffers.js +142 -0
- package/kits/hub-game/code/server/holdShow.js +98 -0
- package/kits/hub-game/code/server/hub.js +991 -72
- package/kits/hub-game/code/server/idle.js +110 -9
- package/kits/hub-game/code/server/index.js +9 -0
- package/kits/hub-game/code/server/labels.js +13 -3
- package/kits/hub-game/code/server/manifest.js +94 -6
- package/kits/hub-game/code/server/menu.js +26 -3
- package/kits/hub-game/code/server/npcs.js +55 -9
- package/kits/hub-game/code/server/observe.js +67 -6
- package/kits/hub-game/code/server/players.js +14 -2
- package/kits/hub-game/code/server/replay.js +135 -0
- package/kits/hub-game/code/server/standing.js +7 -3
- package/kits/hub-game/code/server/storageLimit.js +4 -1
- package/kits/hub-game/code/server/townDay.js +74 -0
- package/kits/hub-game/code/server/vehicle.js +3 -0
- package/kits/hub-game/code/server/vis.js +26 -4
- package/kits/hub-game/code/server/wallet.js +677 -0
- package/kits/hub-game/code/server/wear.js +13 -3
- package/kits/hub-game/code/server/writerLease.js +191 -0
- package/kits/hub-game/code/shared/act.js +1 -1
- package/kits/hub-game/code/shared/expression.js +6 -0
- package/kits/hub-game/code/shared/replay.js +37 -0
- package/kits/hub-game/code/systems/hub.js +429 -55
- package/kits/hub-game/docs/analytics.md +16 -2
- package/kits/hub-game/docs/contract.md +956 -101
- package/kits/hub-game/docs/home-pieces.md +5 -6
- package/kits/hub-game/docs/observed-progress.md +49 -1
- package/kits/hub-game/docs/vehicle-preset.md +23 -0
- package/kits/hub-game/index.html +1 -0
- package/kits/hub-game/models/hats/baker-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/bat-clip.pxmodel +3 -3
- package/kits/hub-game/models/hats/beekeeper.pxmodel +3 -3
- package/kits/hub-game/models/hats/cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/captain.pxmodel +3 -3
- package/kits/hub-game/models/hats/chef-toque.pxmodel +3 -3
- package/kits/hub-game/models/hats/crooked-top.pxmodel +3 -3
- package/kits/hub-game/models/hats/delivery-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/fire-helmet.pxmodel +3 -3
- package/kits/hub-game/models/hats/flower-crown.pxmodel +3 -3
- package/kits/hub-game/models/hats/foam-crown.pxmodel +3 -3
- package/kits/hub-game/models/hats/hard-hat.pxmodel +3 -3
- package/kits/hub-game/models/hats/lantern.pxmodel +3 -3
- package/kits/hub-game/models/hats/laurel.pxmodel +3 -3
- package/kits/hub-game/models/hats/lighthouse.pxmodel +3 -3
- package/kits/hub-game/models/hats/nurse-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/police-cap.pxmodel +3 -3
- package/kits/hub-game/models/hats/sailor.pxmodel +3 -3
- package/kits/hub-game/models/hats/souwester.pxmodel +3 -3
- package/kits/hub-game/models/hats/straw.pxmodel +3 -3
- package/kits/hub-game/models/hats/sunflower.pxmodel +3 -3
- package/kits/hub-game/models/hats/sweatband.pxmodel +3 -3
- package/kits/hub-game/models/hats/teacher-beret.pxmodel +3 -3
- package/kits/hub-game/models/hats/witch.pxmodel +3 -3
- package/kits/hub-game/models/hold-show/daisy.pxmodel +231 -0
- package/kits/hub-game/models/hold-show/moonflower.pxmodel +171 -0
- package/kits/hub-game/models/hold-show/rose.pxmodel +191 -0
- package/kits/hub-game/models/hold-show/square/daisy.pxmodel +233 -0
- package/kits/hub-game/models/hold-show/square/moonflower.pxmodel +173 -0
- package/kits/hub-game/models/hold-show/square/rose.pxmodel +193 -0
- package/kits/hub-game/models/hold-show/square/sunflower.pxmodel +313 -0
- package/kits/hub-game/models/hold-show/square/tulip.pxmodel +133 -0
- package/kits/hub-game/models/hold-show/sunflower.pxmodel +311 -0
- package/kits/hub-game/models/hold-show/tulip.pxmodel +131 -0
- package/kits/hub-game/package-lock.json +3 -3
- package/kits/hub-game/package.json +4 -3
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +1 -0
- package/kits/hub-game/scripts/fixtures/hud-surface.json +12 -12
- package/kits/hub-game/scripts/fixtures/talk-surface.json +8 -8
- package/kits/hub-game/scripts/gen-hats.mjs +1 -1
- package/kits/hub-game/scripts/gen-hold-show.mjs +27 -0
- package/kits/hub-game/scripts/pack.mjs +89 -23
- package/kits/hub-game/scripts/test-act-client.mjs +5 -0
- package/kits/hub-game/scripts/test-act-core.mjs +32 -0
- package/kits/hub-game/scripts/test-act-gate.mjs +186 -0
- package/kits/hub-game/scripts/test-action-rail-crowded-dom.mjs +7 -1
- package/kits/hub-game/scripts/test-action-rail-default-dom.mjs +102 -0
- package/kits/hub-game/scripts/test-action-rail-never-silent-dom.mjs +50 -0
- package/kits/hub-game/scripts/test-action-rail-surface.mjs +368 -0
- package/kits/hub-game/scripts/test-action-rail-town-jobs-dom.mjs +118 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +5 -3
- package/kits/hub-game/scripts/test-actions.mjs +24 -0
- package/kits/hub-game/scripts/test-actors.mjs +19 -0
- package/kits/hub-game/scripts/test-again-corner-dom.mjs +59 -0
- package/kits/hub-game/scripts/test-analytics.mjs +79 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +25 -8
- package/kits/hub-game/scripts/test-ask-client.mjs +9 -0
- package/kits/hub-game/scripts/test-ask-surface.mjs +188 -0
- package/kits/hub-game/scripts/test-attention.mjs +43 -1
- package/kits/hub-game/scripts/test-ballot-sheet-dom.mjs +71 -0
- package/kits/hub-game/scripts/test-ballot-surface.mjs +276 -0
- package/kits/hub-game/scripts/test-ballot.mjs +421 -4
- package/kits/hub-game/scripts/test-ban-join.mjs +1 -1
- package/kits/hub-game/scripts/test-celebrate-client.mjs +62 -0
- package/kits/hub-game/scripts/test-celebrate.mjs +116 -0
- package/kits/hub-game/scripts/test-chat.mjs +73 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +203 -21
- package/kits/hub-game/scripts/test-companion.mjs +110 -3
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +57 -10
- package/kits/hub-game/scripts/test-corner-surface.mjs +268 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +59 -3
- package/kits/hub-game/scripts/test-decor.mjs +27 -0
- package/kits/hub-game/scripts/test-device-class.mjs +4 -1
- package/kits/hub-game/scripts/test-disguise-client.mjs +281 -0
- package/kits/hub-game/scripts/test-disguise.mjs +176 -0
- package/kits/hub-game/scripts/test-dock-surface.mjs +404 -0
- package/kits/hub-game/scripts/test-door-stay-client.mjs +602 -0
- package/kits/hub-game/scripts/test-door-stay.mjs +613 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +119 -0
- package/kits/hub-game/scripts/test-emote-surface.mjs +616 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +39 -4
- package/kits/hub-game/scripts/test-friend-bests.mjs +38 -12
- package/kits/hub-game/scripts/test-ghost-click-dom.mjs +75 -0
- package/kits/hub-game/scripts/test-grab-client.mjs +29 -2
- package/kits/hub-game/scripts/test-grab-orbit.mjs +260 -11
- package/kits/hub-game/scripts/test-grab.mjs +10 -1
- package/kits/hub-game/scripts/test-hats.mjs +28 -0
- package/kits/hub-game/scripts/test-held-offers.mjs +394 -0
- package/kits/hub-game/scripts/test-high-only.mjs +3 -3
- package/kits/hub-game/scripts/test-hold-show-client.mjs +175 -0
- package/kits/hub-game/scripts/test-hold-show.mjs +355 -0
- package/kits/hub-game/scripts/test-hub-controls.mjs +3 -1
- package/kits/hub-game/scripts/test-hub-idle.mjs +348 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +21 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +119 -0
- package/kits/hub-game/scripts/test-hub-trip.mjs +240 -4
- package/kits/hub-game/scripts/test-hud-clear.mjs +83 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +2 -1
- package/kits/hub-game/scripts/test-idle.mjs +160 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +53 -0
- package/kits/hub-game/scripts/test-labels.mjs +11 -0
- package/kits/hub-game/scripts/test-landscape-layout.mjs +20 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +67 -1
- package/kits/hub-game/scripts/test-manifest.mjs +27 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +54 -5
- package/kits/hub-game/scripts/test-menu-surface.mjs +236 -0
- package/kits/hub-game/scripts/test-npcs.mjs +128 -0
- package/kits/hub-game/scripts/test-observed.mjs +171 -3
- package/kits/hub-game/scripts/test-pack.mjs +166 -0
- package/kits/hub-game/scripts/test-pad-cues.mjs +39 -0
- package/kits/hub-game/scripts/test-picker-surface.mjs +321 -0
- package/kits/hub-game/scripts/test-placeat-server.mjs +648 -0
- package/kits/hub-game/scripts/test-placement-cache.mjs +1 -1
- package/kits/hub-game/scripts/test-pointer-clear-dom.mjs +82 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +184 -6
- package/kits/hub-game/scripts/test-push-visit.mjs +9 -0
- package/kits/hub-game/scripts/test-quality.mjs +312 -9
- package/kits/hub-game/scripts/test-quick-chat-surface.mjs +511 -0
- package/kits/hub-game/scripts/test-rehello.mjs +242 -3
- package/kits/hub-game/scripts/test-rejoin-yaw.mjs +138 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +13 -7
- package/kits/hub-game/scripts/test-relations-refresh.mjs +90 -2
- package/kits/hub-game/scripts/test-replay-client.mjs +110 -0
- package/kits/hub-game/scripts/test-replay.mjs +178 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +13 -0
- package/kits/hub-game/scripts/test-resume-pose-server.mjs +43 -5
- package/kits/hub-game/scripts/test-role-client.mjs +2 -1
- package/kits/hub-game/scripts/test-safe-act.mjs +233 -0
- package/kits/hub-game/scripts/test-safe-caption.mjs +364 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +79 -0
- package/kits/hub-game/scripts/test-safe-prompt.mjs +163 -0
- package/kits/hub-game/scripts/test-sound-surface.mjs +256 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +85 -2
- package/kits/hub-game/scripts/test-standing.mjs +135 -2
- package/kits/hub-game/scripts/test-stuck-surface.mjs +174 -0
- package/kits/hub-game/scripts/test-stuck.mjs +36 -1
- package/kits/hub-game/scripts/test-talk-surface.mjs +23 -6
- package/kits/hub-game/scripts/test-talk-walk-dom.mjs +123 -0
- package/kits/hub-game/scripts/test-text-ask-surface.mjs +273 -0
- package/kits/hub-game/scripts/test-tiers.mjs +453 -3
- package/kits/hub-game/scripts/test-toast-no-row-dom.mjs +71 -0
- package/kits/hub-game/scripts/test-together.mjs +11 -0
- package/kits/hub-game/scripts/test-town-day.mjs +90 -0
- package/kits/hub-game/scripts/test-try-on.mjs +39 -0
- package/kits/hub-game/scripts/test-ui-dom-dom.mjs +49 -2
- package/kits/hub-game/scripts/test-ui-tree.mjs +28 -0
- package/kits/hub-game/scripts/test-vehicle-client.mjs +68 -1
- package/kits/hub-game/scripts/test-vis.mjs +145 -0
- package/kits/hub-game/scripts/test-wallet.mjs +650 -0
- package/kits/hub-game/scripts/test-weakest-tier.mjs +135 -1
- package/kits/hub-game/scripts/test-world-labels.mjs +340 -0
- package/kits/hub-game/scripts/test-writer-lease-server.mjs +234 -0
- package/kits/hub-game/scripts/test-writer-lease.mjs +281 -0
- package/kits/hub-game/scripts/writer-storage-fixture.mjs +37 -0
- package/kits/hub-game/tools/hubScene/export.mjs +6 -5
- package/kits/hub-game/tools/hubScene/hubdata.mjs +10 -0
- package/kits/hub-game/tools/hubScene/test/export-fixture.mjs +36 -2
- package/kits/hub-game/tools/hubScene/validate-manifest.mjs +10 -2
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/resumeGate.js +66 -2
- package/kits/multiplayer-3d/code/server/ownership.js +25 -6
- package/kits/multiplayer-3d/code/server/world.js +19 -4
- package/kits/multiplayer-3d/code/systems/multiplayer.js +108 -18
- package/kits/multiplayer-3d/package-lock.json +1 -1
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/test-ground-half.mjs +56 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +54 -3
- package/kits/multiplayer-3d/scripts/test-owned-moves.mjs +190 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +417 -5
- package/kits/multiplayer-3d/scripts/test-resync-reconnect.mjs +68 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +10 -2
- package/kits/physics-3d/CLAUDE.md +14 -0
- package/kits/physics-3d/behaviors/Player.jsx +39 -3
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-model-cache.md +109 -0
- package/kits/physics-3d/docs/engine-player.md +76 -0
- package/kits/physics-3d/docs/engine-skip-work.md +16 -0
- package/kits/physics-3d/docs/pxmodel-format.md +5 -1
- package/kits/physics-3d/engine3d/gait.js +16 -8
- package/kits/physics-3d/engine3d/groundsize.js +23 -0
- package/kits/physics-3d/engine3d/kithooks.js +50 -0
- package/kits/physics-3d/engine3d/look.js +110 -17
- package/kits/physics-3d/engine3d/lookbake.js +19 -1
- package/kits/physics-3d/engine3d/materialpresets.js +3 -2
- package/kits/physics-3d/engine3d/modelcache.js +280 -0
- package/kits/physics-3d/engine3d/modelcachedigest.js +37 -0
- package/kits/physics-3d/engine3d/modelcachegate.js +69 -0
- package/kits/physics-3d/engine3d/modelrefs.js +13 -0
- package/kits/physics-3d/engine3d/optimize.js +20 -9
- package/kits/physics-3d/engine3d/playerRun.js +26 -1
- package/kits/physics-3d/engine3d/pxmodel.js +7 -3
- package/kits/physics-3d/engine3d/templatecache.js +722 -0
- package/kits/physics-3d/engine3d/world3d.js +211 -17
- package/kits/physics-3d/package-lock.json +1 -1
- package/kits/physics-3d/package.json +2 -1
- package/kits/physics-3d/play/behaviors/Player.js +43 -3
- package/kits/physics-3d/scripts/render.mjs +56 -8
- package/kits/physics-3d/scripts/template-cache-fixtures.mjs +37 -0
- package/kits/physics-3d/scripts/template-cache-v1-bytes.json +49 -0
- package/kits/physics-3d/scripts/test-coaxial-escape.mjs +176 -0
- package/kits/physics-3d/scripts/test-gait.mjs +53 -9
- package/kits/physics-3d/scripts/test-ground-half.mjs +120 -0
- package/kits/physics-3d/scripts/test-model-cache.mjs +600 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1 -0
- package/kits/physics-3d/scripts/test-sleeping-models.mjs +384 -0
- package/kits/physics-3d/scripts/test-template-cache-minified.mjs +106 -0
- package/kits/physics-3d/scripts/test-template-cache.mjs +519 -0
- package/kits/physics-3d/scripts/test-wall-slide.mjs +272 -0
- package/kits/physics-3d/systems/physics3d.js +59 -2
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +3 -0
- package/package.json +2 -2
- package/vendor/three/examples/jsm/libs/fflate.module.js +2672 -0
|
@@ -93,10 +93,10 @@ try {
|
|
|
93
93
|
assert.deepEqual(m.avatarFits[style][i], m.avatarFits.toon[i], 'all fallback fits use toon');
|
|
94
94
|
}
|
|
95
95
|
}
|
|
96
|
-
const wearFiles = ['hats', 'earned', 'role'].flatMap((dir) => fs.readdirSync(path.join(kits, 'hub-game/models', dir), { recursive: true })
|
|
96
|
+
const wearFiles = ['hats', 'earned', 'role', 'hold-show'].flatMap((dir) => fs.readdirSync(path.join(kits, 'hub-game/models', dir), { recursive: true })
|
|
97
97
|
.filter((file) => file.endsWith('.pxmodel')).map((file) => `${dir === 'hats' ? 'hat' : dir}/${file.slice(0, -'.pxmodel'.length).split(path.sep).join('/')}`));
|
|
98
98
|
assert.deepEqual(Object.keys(m.wearModels).sort(), wearFiles.sort(), 'every kit wear model, including square variants');
|
|
99
|
-
for (const id of ['role/top-vest', 'role/tool-torch', 'hat/police-cap', 'role/square/top-vest', 'earned/square/belt-plain']) {
|
|
99
|
+
for (const id of ['role/top-vest', 'role/tool-torch', 'hat/police-cap', 'role/square/top-vest', 'earned/square/belt-plain', 'hold-show/daisy', 'hold-show/square/moonflower']) {
|
|
100
100
|
const asset = m.wearModels[id];
|
|
101
101
|
assert.equal(asset.type, 'glb');
|
|
102
102
|
assert.deepEqual(asset, m.assets[id], 'registered for cache restaging and upload');
|
|
@@ -106,6 +106,14 @@ try {
|
|
|
106
106
|
assert.equal(m.wearPieces['role/top-vest'].scale, undefined, 'top stretching depends on the fit');
|
|
107
107
|
assert.equal(m.wearPieces['role/tool-torch'].scale, 1.2);
|
|
108
108
|
assert.equal(m.wearPieces['role/tool-torch'].anchor, 'hand');
|
|
109
|
+
// v1.182 hold-show flowers: right hand, holdShowLook's scale, tinted from the model's main colour.
|
|
110
|
+
for (const shape of ['daisy', 'tulip', 'sunflower', 'rose', 'moonflower']) {
|
|
111
|
+
assert.ok(m.wearModels[`hold-show/${shape}`] && m.wearModels[`hold-show/square/${shape}`], `hold-show ${shape} and its square variant`);
|
|
112
|
+
assert.equal(m.wearPieces[`hold-show/${shape}`].anchor, 'hand');
|
|
113
|
+
assert.equal(m.wearPieces[`hold-show/${shape}`].scale, 1.2);
|
|
114
|
+
assert.match(m.wearPieces[`hold-show/${shape}`].placement, /hubHoldShow/);
|
|
115
|
+
assert.equal(m.wearPieces[`hold-show/square/${shape}`], undefined, 'one piece per shape; the square model is chosen by fit');
|
|
116
|
+
}
|
|
109
117
|
assert.equal(m.wearPieces['earned/badge-star'].scale, 2.6);
|
|
110
118
|
assert.equal(m.wearPieces['earned/pin-round'].scale, 2.1);
|
|
111
119
|
assert.equal(m.wearPieces['earned/belt-plain'].anchor, 'waist');
|
|
@@ -117,6 +125,15 @@ try {
|
|
|
117
125
|
assert.ok(wearFaults({ wearPieces: null }).includes('wearPieces is not an object'));
|
|
118
126
|
const missingHat = { ...m.wearModels }; delete missingHat['hat/police-cap'];
|
|
119
127
|
assert.ok(wearFaults({ wearModels: missingHat }).includes('wearModels: missing hat/police-cap'));
|
|
128
|
+
// Flowers are optional (older manifests have none) but all or nothing, each with its piece.
|
|
129
|
+
const noFlowers = Object.fromEntries(Object.entries(m.wearModels).filter(([id]) => !id.startsWith('hold-show/')));
|
|
130
|
+
const noFlowerPieces = Object.fromEntries(Object.entries(m.wearPieces).filter(([id]) => !id.startsWith('hold-show/')));
|
|
131
|
+
assert.deepEqual(wearFaults({ wearModels: noFlowers, wearPieces: noFlowerPieces }), []);
|
|
132
|
+
const oneFlowerShort = { ...m.wearModels }; delete oneFlowerShort['hold-show/square/rose'];
|
|
133
|
+
assert.ok(wearFaults({ wearModels: oneFlowerShort }).includes('wearModels: missing hold-show/square/rose'));
|
|
134
|
+
assert.ok(wearFaults({ wearPieces: noFlowerPieces }).includes('wearPieces: missing hold-show/rose'));
|
|
135
|
+
assert.ok(wearFaults({ wearModels: noFlowers }).includes('wearPieces hold-show/daisy: anchor'));
|
|
136
|
+
assert.ok(wearFaults({ wearModels: { ...m.wearModels, 'hold-show/lily': m.wearModels['hold-show/daisy'] } }).includes('wearModels hold-show/lily: id'));
|
|
120
137
|
// export-hub --deck-wear: what source.wear.deck.leftOut lists may be absent, with its pieces; nothing
|
|
121
138
|
// else may, and a listed id must be a kit wear model that is really absent.
|
|
122
139
|
const deckOnly = (leftOut, models = m.wearModels, pieces = m.wearPieces) =>
|
|
@@ -129,6 +146,13 @@ try {
|
|
|
129
146
|
assert.ok(deckOnly(['hats/police-cap', ...roleIds], { ...noRole, 'role/tool-torch': m.wearModels['role/tool-torch'] }, noRolePieces).includes('wearModels role/tool-torch: listed as left out'));
|
|
130
147
|
assert.ok(deckOnly(['hats/police-cap', 'hats/nonsense', ...roleIds], noRole, noRolePieces).includes('source.wear.deck.leftOut: hat/nonsense is not a kit wear model'));
|
|
131
148
|
assert.ok(deckOnly(['hats/police-cap', ...roleIds], noRole, m.wearPieces).includes('wearPieces role/top-vest: no model'));
|
|
149
|
+
// leftOut never excuses a flower: listing one faults, and a manifest with any still needs all.
|
|
150
|
+
assert.ok(deckOnly(['hold-show/square/rose'], oneFlowerShort).includes('wearModels: missing hold-show/square/rose'));
|
|
151
|
+
assert.ok(deckOnly(['hold-show/square/rose'], oneFlowerShort).includes('source.wear.deck.leftOut: hold-show/square/rose is not a kit wear model'));
|
|
152
|
+
const noRose = Object.fromEntries(Object.entries(m.wearModels).filter(([id]) => !id.endsWith('/rose')));
|
|
153
|
+
const noRosePiece = { ...m.wearPieces }; delete noRosePiece['hold-show/rose'];
|
|
154
|
+
const roseOut = deckOnly(['hold-show/rose', 'hold-show/square/rose'], noRose, noRosePiece);
|
|
155
|
+
assert.ok(roseOut.includes('wearModels: missing hold-show/rose') && roseOut.includes('wearPieces: missing hold-show/rose'));
|
|
132
156
|
const badWear = { ...m.wearModels, 'role/top-vest': { ...m.wearModels['role/top-vest'], uri: '../shared/missing.glb' } };
|
|
133
157
|
assert.ok(wearFaults({ wearModels: badWear }).some((fault) => fault.startsWith('asset wearModels role/top-vest:') && fault.endsWith('missing')));
|
|
134
158
|
const benchLayers = m.layers.filter((l) => l.role === 'prop');
|
|
@@ -269,6 +293,16 @@ try {
|
|
|
269
293
|
fs.rmSync(path.join(deck, 'code/server/rocks.js'));
|
|
270
294
|
assert.equal(run().cached, false, 'removing it exports again');
|
|
271
295
|
assert.equal(manifest().actors['rock-a'], undefined);
|
|
296
|
+
// A car, disguise or replay look names the actor whose model it draws: a file making any one of
|
|
297
|
+
// those calls (spaces around it allowed) keeps its quoted ids apart too.
|
|
298
|
+
for (const call of ["hub.drive(p, { look: 'rock-a' })", "hub.disguise ?. (p, { look: 'rock-a' })", "hub.replay (p, 0, { trace: [], look: 'rock-a' })"]) {
|
|
299
|
+
fs.writeFileSync(path.join(deck, 'code/server/looks.js'), `export const go = (hub, p) => ${call};\n`);
|
|
300
|
+
assert.equal(run().cached, false, `${call}: exports again`);
|
|
301
|
+
assert.ok(manifest().actors['rock-a'] && !Object.values(manifest().merged).flat().includes('rock-a'), `${call}: its look has its own node`);
|
|
302
|
+
fs.rmSync(path.join(deck, 'code/server/looks.js'));
|
|
303
|
+
assert.equal(run().cached, false);
|
|
304
|
+
assert.equal(manifest().actors['rock-a'], undefined);
|
|
305
|
+
}
|
|
272
306
|
|
|
273
307
|
// What a place can spawn, hide or show by an id the code never quotes for hide/show keeps its own
|
|
274
308
|
// node: a template only ever spawned, one the decor catalogue copies (`"decor": true`), and ids
|
|
@@ -9,6 +9,7 @@ import crypto from 'node:crypto';
|
|
|
9
9
|
import { HATS } from '../../code/client/hats.js';
|
|
10
10
|
import { ROLE_TOPS, ROLE_TOOLS } from '../../code/client/role.js';
|
|
11
11
|
import { EARNED_SHAPES, EARNED_SHAPE_CLASS, SQUARE_SHAPES } from '../../code/client/earned.js';
|
|
12
|
+
import { HOLD_SHOW_SHAPES } from '../../code/client/holdShow.js';
|
|
12
13
|
|
|
13
14
|
export function validateManifest(m, dir, { hash = true } = {}) {
|
|
14
15
|
const faults = [];
|
|
@@ -66,6 +67,10 @@ export function validateManifest(m, dir, { hash = true } = {}) {
|
|
|
66
67
|
...ROLE_TOPS.flatMap((id) => [`role/top-${id}`, `role/square/top-${id}`]),
|
|
67
68
|
...ROLE_TOOLS.map((id) => `role/tool-${id}`),
|
|
68
69
|
];
|
|
70
|
+
// v1.182 hold-show flowers: optional (manifests exported before them, and castle-client's
|
|
71
|
+
// export-hub, have none), but all or nothing, each with its square variant and piece.
|
|
72
|
+
const flowerModels = HOLD_SHOW_SHAPES.flatMap((id) => [`hold-show/${id}`, `hold-show/square/${id}`]);
|
|
73
|
+
const flowers = isObj(m.wearModels) && Object.keys(m.wearModels).some((id) => id.startsWith('hold-show/'));
|
|
69
74
|
// castle-client export-hub --deck-wear builds only the wear models the deck's own bundle ships
|
|
70
75
|
// and lists the kit's others in source.wear.deck.leftOut ('hats/<id>', 'role/...'): those may be
|
|
71
76
|
// absent (with their pieces), never present; every other id is still required.
|
|
@@ -75,12 +80,14 @@ export function validateManifest(m, dir, { hash = true } = {}) {
|
|
|
75
80
|
if (!isObj(m.wearModels)) fault('wearModels is not an object');
|
|
76
81
|
else {
|
|
77
82
|
for (const id of requiredModels) if (!Object.hasOwn(m.wearModels, id) && !leftOut.has(id)) fault(`wearModels: missing ${id}`);
|
|
83
|
+
// leftOut never excuses a flower: a manifest with any has every one.
|
|
84
|
+
if (flowers) for (const id of flowerModels) if (!Object.hasOwn(m.wearModels, id)) fault(`wearModels: missing ${id}`);
|
|
78
85
|
for (const id of leftOut) {
|
|
79
86
|
if (!requiredModels.includes(id)) fault(`source.wear.deck.leftOut: ${id} is not a kit wear model`);
|
|
80
87
|
else if (Object.hasOwn(m.wearModels, id)) fault(`wearModels ${id}: listed as left out`);
|
|
81
88
|
}
|
|
82
89
|
for (const [id, asset] of Object.entries(m.wearModels)) {
|
|
83
|
-
if (!/^(hat|earned|role)\/(square\/)?[a-z0-9-]+$/.test(id)) fault(`wearModels ${id}: id`);
|
|
90
|
+
if (!/^(hat|earned|role|hold-show)\/(square\/)?[a-z0-9-]+$/.test(id) || (id.startsWith('hold-show/') && !flowerModels.includes(id))) fault(`wearModels ${id}: id`);
|
|
84
91
|
if (asset?.type !== 'glb') fault(`wearModels ${id}: not a glb asset`);
|
|
85
92
|
if (asset?.uri !== `../shared/${asset?.sha256}.glb`) fault(`wearModels ${id}: uri`);
|
|
86
93
|
checkAsset(`wearModels ${id}`, asset);
|
|
@@ -89,6 +96,7 @@ export function validateManifest(m, dir, { hash = true } = {}) {
|
|
|
89
96
|
}
|
|
90
97
|
const anchors = Object.fromEntries([
|
|
91
98
|
...ROLE_TOPS.map((id) => [`role/top-${id}`, 'waist']), ...ROLE_TOOLS.map((id) => [`role/tool-${id}`, 'hand']),
|
|
99
|
+
...(flowers ? HOLD_SHOW_SHAPES.map((id) => [`hold-show/${id}`, 'hand']) : []),
|
|
92
100
|
...EARNED_SHAPES.map((shape) => {
|
|
93
101
|
const cls = EARNED_SHAPE_CLASS[shape];
|
|
94
102
|
return [`earned/${shape}`, cls === 'badge' || cls === 'pin' ? 'chest' : cls === 'belt' ? 'waist' : cls === 'held' ? 'hand' : 'sash'];
|
|
@@ -96,7 +104,7 @@ export function validateManifest(m, dir, { hash = true } = {}) {
|
|
|
96
104
|
]);
|
|
97
105
|
if (!isObj(m.wearPieces)) fault('wearPieces is not an object');
|
|
98
106
|
else {
|
|
99
|
-
for (const id of Object.keys(anchors)) if (!Object.hasOwn(m.wearPieces, id) && !leftOut.has(id)) fault(`wearPieces: missing ${id}`);
|
|
107
|
+
for (const id of Object.keys(anchors)) if (!Object.hasOwn(m.wearPieces, id) && (!leftOut.has(id) || id.startsWith('hold-show/'))) fault(`wearPieces: missing ${id}`);
|
|
100
108
|
for (const [id, piece] of Object.entries(m.wearPieces)) {
|
|
101
109
|
if (!isObj(piece)) { fault(`wearPieces ${id}: not an object`); continue; }
|
|
102
110
|
if (!anchors[id] || piece.anchor !== anchors[id]) fault(`wearPieces ${id}: anchor`);
|
|
@@ -7,26 +7,26 @@
|
|
|
7
7
|
"imports": {
|
|
8
8
|
"castle.real-time": {
|
|
9
9
|
"deckId": "xFVr-afOLuUQ",
|
|
10
|
-
"version": "2026-
|
|
10
|
+
"version": "2026-11-15T00:41:55.124Z"
|
|
11
11
|
},
|
|
12
12
|
"castle.physics-3d": {
|
|
13
13
|
"deckId": "JH0SclbPVP0y",
|
|
14
|
-
"version": "2026-
|
|
14
|
+
"version": "2026-11-15T00:45:03.769Z"
|
|
15
15
|
},
|
|
16
16
|
"castle.physics-2d": {
|
|
17
17
|
"deckId": "ckRZGFW4iPrx",
|
|
18
|
-
"version": "2026-
|
|
18
|
+
"version": "2026-11-15T00:41:50.817Z",
|
|
19
19
|
"via": "castle.physics-3d"
|
|
20
20
|
},
|
|
21
21
|
"castle.base": {
|
|
22
22
|
"deckId": "yRcmH4_aYllE",
|
|
23
|
-
"version": "2026-
|
|
23
|
+
"version": "2026-11-15T00:40:25.157Z"
|
|
24
24
|
}
|
|
25
25
|
},
|
|
26
26
|
"autoUpdateWhenImported": true,
|
|
27
27
|
"deckId": "ZwA_P_-VO-Qh",
|
|
28
28
|
"cardId": "bvRmCzyUpt_a",
|
|
29
|
-
"publishedVersion": "2026-
|
|
29
|
+
"publishedVersion": "2026-11-17T22:31:57.174Z",
|
|
30
30
|
"main": "main.jsx",
|
|
31
31
|
"server": {
|
|
32
32
|
"main": "code/server/index.js",
|
|
@@ -57,14 +57,21 @@ const WORLD = 'w';
|
|
|
57
57
|
// ordinary release, as does a session that offers none.
|
|
58
58
|
export const RESYNC_AWAY_MS = 5000;
|
|
59
59
|
|
|
60
|
+
// A socket can read connected and carry nothing after an away. A resync left
|
|
61
|
+
// unanswered this long asks the transport to recover instead of waiting for
|
|
62
|
+
// its keepalive deadline.
|
|
63
|
+
export const RESYNC_REPLY_MS = 3000;
|
|
64
|
+
|
|
60
65
|
// An unarmed gate. `since` is the page time the room was last current,
|
|
61
66
|
// `serverAt` the simulation time then (null with no clock yet), `shownAt` the
|
|
62
67
|
// first page time the page was visible again while armed, `dropped` whether
|
|
63
68
|
// the connection left `connected` during the away, `lostAt` the last page time
|
|
64
69
|
// it was seen not connected, `backAt` when it came back after that, and
|
|
65
|
-
// `asked` whether a resync was asked for (`ask`)
|
|
70
|
+
// `asked` whether a resync was asked for (`ask`), `askedAt` the page time then,
|
|
71
|
+
// `replyExpired` whether its unanswered reply has been reported, and `hiddenAt`
|
|
72
|
+
// the page time the page hid with a resync out (`suspendReply`).
|
|
66
73
|
export function makeGate() {
|
|
67
|
-
return { armed: false, since: 0, serverAt: null, shownAt: null, dropped: false, lostAt: null, backAt: null, asked: false };
|
|
74
|
+
return { armed: false, since: 0, serverAt: null, shownAt: null, dropped: false, lostAt: null, backAt: null, asked: false, askedAt: null, replyExpired: false, hiddenAt: null, pausedAt: null };
|
|
68
75
|
}
|
|
69
76
|
|
|
70
77
|
// Arm the gate for an away that began at page time `since`, when the server's
|
|
@@ -82,6 +89,10 @@ export function arm(gate, since, serverAt) {
|
|
|
82
89
|
gate.lostAt = null;
|
|
83
90
|
gate.backAt = null;
|
|
84
91
|
gate.asked = false;
|
|
92
|
+
gate.askedAt = null;
|
|
93
|
+
gate.replyExpired = false;
|
|
94
|
+
gate.hiddenAt = null;
|
|
95
|
+
gate.pausedAt = null;
|
|
85
96
|
return true;
|
|
86
97
|
}
|
|
87
98
|
|
|
@@ -93,6 +104,10 @@ export function clear(gate) {
|
|
|
93
104
|
gate.lostAt = null;
|
|
94
105
|
gate.backAt = null;
|
|
95
106
|
gate.asked = false;
|
|
107
|
+
gate.askedAt = null;
|
|
108
|
+
gate.replyExpired = false;
|
|
109
|
+
gate.hiddenAt = null;
|
|
110
|
+
gate.pausedAt = null;
|
|
96
111
|
}
|
|
97
112
|
|
|
98
113
|
// Whether to ask for a resync now, at page time `now`: once per away, an away
|
|
@@ -103,9 +118,43 @@ export function ask(gate, now) {
|
|
|
103
118
|
return false;
|
|
104
119
|
}
|
|
105
120
|
gate.asked = true;
|
|
121
|
+
gate.askedAt = now;
|
|
106
122
|
return true;
|
|
107
123
|
}
|
|
108
124
|
|
|
125
|
+
// Whether a resync has gone unanswered at page time `now`, once per away.
|
|
126
|
+
// A limit of zero or less leaves recovery to the transport's own deadline.
|
|
127
|
+
export function unanswered(gate, now, limit) {
|
|
128
|
+
resumeReply(gate, now);
|
|
129
|
+
if (limit <= 0 || !gate.armed || !gate.asked || gate.dropped || gate.replyExpired || now - gate.askedAt < limit) {
|
|
130
|
+
return false;
|
|
131
|
+
}
|
|
132
|
+
gate.replyExpired = true;
|
|
133
|
+
return true;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
// The page went away again at page time `now` with a resync out. A reply cannot
|
|
137
|
+
// be drained while hidden, so the reply wait and the give-up both count visible
|
|
138
|
+
// time only: `resumeReply` moves them on by the time away. Neither restarts, so
|
|
139
|
+
// a page that keeps hiding still reaches both.
|
|
140
|
+
export function suspendReply(gate, now) {
|
|
141
|
+
if (gate.armed && gate.asked && gate.hiddenAt === null) {
|
|
142
|
+
gate.hiddenAt = now;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
function resumeReply(gate, now) {
|
|
147
|
+
if (gate.hiddenAt === null) {
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
const away = now - gate.hiddenAt;
|
|
151
|
+
gate.hiddenAt = null;
|
|
152
|
+
gate.askedAt += away;
|
|
153
|
+
if (gate.shownAt !== null) {
|
|
154
|
+
gate.shownAt += away;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
109
158
|
// Note whether the connection is connected at page time `now`, while armed.
|
|
110
159
|
// A return seen only by a frame dates from the last time it was seen lost, so
|
|
111
160
|
// a WORLD that arrived between the two still counts.
|
|
@@ -155,6 +204,15 @@ export function current(gate, msg) {
|
|
|
155
204
|
return msg.t >= expected - Math.max(LAG_MS, away * LAG_SHARE);
|
|
156
205
|
}
|
|
157
206
|
|
|
207
|
+
// A gate whose visible wait must not count an away (the report wait after a
|
|
208
|
+
// reconnect) is paused at page time `at`, when the page hid or its frames
|
|
209
|
+
// stopped; the next visible `waited` moves its start on by the time away.
|
|
210
|
+
export function pauseWait(gate, at) {
|
|
211
|
+
if (gate.armed && gate.pausedAt === null) {
|
|
212
|
+
gate.pausedAt = at;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
158
216
|
// Note one frame while armed. `visible` is whether the page is shown. Returns
|
|
159
217
|
// true when the gate has waited `RESUME_WAIT_MS` of visible time and should
|
|
160
218
|
// give up.
|
|
@@ -162,6 +220,12 @@ export function waited(gate, now, visible) {
|
|
|
162
220
|
if (!gate.armed || !visible) {
|
|
163
221
|
return false;
|
|
164
222
|
}
|
|
223
|
+
if (gate.pausedAt !== null) {
|
|
224
|
+
if (gate.shownAt !== null) {
|
|
225
|
+
gate.shownAt += Math.max(0, now - gate.pausedAt);
|
|
226
|
+
}
|
|
227
|
+
gate.pausedAt = null;
|
|
228
|
+
}
|
|
165
229
|
gate.shownAt ??= now;
|
|
166
230
|
return now - gate.shownAt > RESUME_WAIT_MS;
|
|
167
231
|
}
|
|
@@ -96,12 +96,19 @@ function handOver(sim, entry, id, playerId, handovers) {
|
|
|
96
96
|
entry.reportedAt = sim.timeMs;
|
|
97
97
|
entry.claimedAt = sim.timeMs;
|
|
98
98
|
entry.velocity = velocity;
|
|
99
|
+
// A grant starts with delivery slack only: neither elapsed time nor unused
|
|
100
|
+
// movement from the previous owner (or the server) belongs to this owner.
|
|
101
|
+
entry.moveBudget = Limits.MOVE_SLACK;
|
|
99
102
|
const pose = entry.pose;
|
|
100
103
|
entry.pose = null;
|
|
101
104
|
if (playerId) {
|
|
102
105
|
// An owned object is kinematic-position-based, so owner reports place it and
|
|
103
106
|
// its collider remains active in the shared Rapier world.
|
|
104
107
|
entry.body.setBodyType(RAPIER.RigidBodyType.KinematicPositionBased, true);
|
|
108
|
+
// A takeover can happen before the old owner's target has stepped. Cancel
|
|
109
|
+
// that target too, so the new grant starts at the body's current pose.
|
|
110
|
+
entry.body.setNextKinematicTranslation(entry.body.translation());
|
|
111
|
+
entry.body.setNextKinematicRotation(entry.body.rotation());
|
|
105
112
|
} else {
|
|
106
113
|
// A returned object becomes dynamic and keeps the velocity it had, so a
|
|
107
114
|
// rolling object is still rolling when the server takes it back. Its last
|
|
@@ -168,20 +175,32 @@ export function setObjectPoses(sim, playerId, poses, handovers) {
|
|
|
168
175
|
if (!asked) {
|
|
169
176
|
continue;
|
|
170
177
|
}
|
|
171
|
-
|
|
172
|
-
|
|
178
|
+
// The body reaches its kinematic target only at a physics step. A second
|
|
179
|
+
// report in the same tick must start from the newest accepted target of
|
|
180
|
+
// this grant, not the older body position. handOver clears that target.
|
|
181
|
+
const at = entry.pose?.at ?? entry.body.translation();
|
|
182
|
+
// Bank unused elapsed movement for reports delivered in a burst, up to the
|
|
183
|
+
// ownership timeout: a report gap shorter than that kept its whole
|
|
184
|
+
// elapsed allowance before, so no single report is judged more strictly
|
|
185
|
+
// than it was, and idle time never banks past it (60 m at 40 m/s).
|
|
186
|
+
// Slack is part of the shared budget, not a fresh allowance per report.
|
|
187
|
+
const bankS = Limits.OWNER_TIMEOUT_MS / 1000;
|
|
188
|
+
const elapsed = Math.min(bankS, Math.max(0, sim.timeMs - entry.reportedAt) / 1000);
|
|
189
|
+
const budget = Math.min(
|
|
190
|
+
Limits.MAX_OBJECT_SPEED * bankS + Limits.MOVE_SLACK,
|
|
191
|
+
(entry.moveBudget ?? Limits.MOVE_SLACK) + Limits.MAX_OBJECT_SPEED * elapsed,
|
|
192
|
+
);
|
|
193
|
+
const distance = Math.hypot(asked.x - at.x, asked.y - at.y, asked.z - at.z);
|
|
173
194
|
entry.reportedAt = sim.timeMs;
|
|
174
195
|
|
|
175
196
|
// A report beyond the object speed allowance releases the object to server
|
|
176
197
|
// simulation. Player reports use clamping instead because each client must
|
|
177
198
|
// continue controlling its own player (`players.js`).
|
|
178
|
-
if (
|
|
179
|
-
Math.hypot(asked.x - at.x, asked.y - at.y, asked.z - at.z) >
|
|
180
|
-
Limits.MAX_OBJECT_SPEED * elapsed + Limits.MOVE_SLACK
|
|
181
|
-
) {
|
|
199
|
+
if (distance > budget) {
|
|
182
200
|
handOver(sim, entry, id, null, handovers);
|
|
183
201
|
continue;
|
|
184
202
|
}
|
|
203
|
+
entry.moveBudget = budget - distance;
|
|
185
204
|
const rotation = { x: number(qx), y: number(qy), z: number(qz), w: number(qw) };
|
|
186
205
|
entry.body.setNextKinematicTranslation(asked);
|
|
187
206
|
entry.body.setNextKinematicRotation(rotation);
|
|
@@ -69,15 +69,30 @@ export async function createSimulation(scenePath) {
|
|
|
69
69
|
return sim;
|
|
70
70
|
}
|
|
71
71
|
|
|
72
|
-
// Add the server's
|
|
73
|
-
//
|
|
72
|
+
// Add the server's ground slab below the authored scene, unless the scene has
|
|
73
|
+
// none (`"ground": { "none": true }`, as the engine reads it): 200 m square, or
|
|
74
|
+
// twice the scene's `ground.half`, the size the engine's own collider takes
|
|
75
|
+
// (physics-3d engine3d/groundsize.js, whose rule `colliderHalf` repeats: the
|
|
76
|
+
// server bundle does not reach into the physics-3d import).
|
|
74
77
|
// `Limits.FELL_OUT_Y` handles dynamic bodies that fall beyond its edge.
|
|
75
78
|
function buildGround(sim) {
|
|
76
|
-
|
|
79
|
+
const setting = sceneGround(sim.scenePath);
|
|
80
|
+
if (setting?.none === true) {
|
|
77
81
|
return;
|
|
78
82
|
}
|
|
83
|
+
const half = colliderHalf(setting);
|
|
79
84
|
const ground = sim.world.createRigidBody(RAPIER.RigidBodyDesc.fixed().setTranslation(0, -0.5, 0));
|
|
80
|
-
sim.world.createCollider(RAPIER.ColliderDesc.cuboid(
|
|
85
|
+
sim.world.createCollider(RAPIER.ColliderDesc.cuboid(half, 0.5, half), ground);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// `ground.half` clamped to 1..200 (the world's xz bounds), or 100 when it is
|
|
89
|
+
// not a finite number.
|
|
90
|
+
function colliderHalf(setting) {
|
|
91
|
+
const half = setting?.half;
|
|
92
|
+
if (typeof half !== 'number' || !Number.isFinite(half)) {
|
|
93
|
+
return 100;
|
|
94
|
+
}
|
|
95
|
+
return Math.min(Limits.BOUNDS.xz, Math.max(1, half));
|
|
81
96
|
}
|
|
82
97
|
|
|
83
98
|
// Create Rapier bodies and indexes from the reduced scene representation.
|