castle-web-cli 0.4.231 → 0.4.233
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/castle-host/host.d.ts +1 -0
- package/dist/castle-host/host.js +51 -3
- package/dist/castleJson.d.ts +4 -2
- package/dist/castleJson.js +2 -0
- package/dist/check.d.ts +3 -1
- package/dist/check.js +11 -1
- package/dist/devSessionStorage.js +47 -1
- 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 +5 -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 +5 -0
- package/dist/save-deck.js +37 -4
- package/dist/serve.js +3 -0
- package/dist/serverBundle.js +5 -3
- package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
- 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/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +79 -2
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +1 -1
- package/kits/base/sdk/commands.d.ts +14 -0
- package/kits/base/sdk/hub.d.ts +6 -2
- package/kits/base/sdk/hub.js +13 -0
- package/kits/base/sdk/multiplayer.js +17 -1
- package/kits/base/sdk/save.js +2 -1
- package/kits/base/sdk/server/hub.d.ts +87 -0
- package/kits/base/sdk/server/hub.js +70 -0
- package/kits/base/sdk/server/platformHandle.d.ts +31 -1
- package/kits/base/sdk/server/storage.d.ts +13 -0
- package/kits/base/sdk/server/storage.js +46 -0
- package/kits/base/sdk/server/wrapper.d.ts +36 -5
- package/kits/base/sdk/server/wrapper.js +83 -8
- package/kits/hub-game/CLAUDE.md +352 -12
- 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/code/client/actorBudget.js +47 -0
- package/kits/hub-game/code/client/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +345 -32
- 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 +251 -0
- package/kits/hub-game/code/client/ballot.js +467 -0
- package/kits/hub-game/code/client/build.js +22 -0
- package/kits/hub-game/code/client/chat.js +12 -0
- package/kits/hub-game/code/client/chrome.js +1334 -50
- 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/decor.js +509 -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/grab.js +363 -20
- package/kits/hub-game/code/client/hats.js +26 -0
- package/kits/hub-game/code/client/hookLayer.js +328 -15
- package/kits/hub-game/code/client/hudClear.js +126 -0
- package/kits/hub-game/code/client/idle.js +163 -22
- package/kits/hub-game/code/client/interestCap.js +81 -0
- package/kits/hub-game/code/client/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +205 -0
- package/kits/hub-game/code/client/menuIcons.js +34 -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/rehello.js +167 -0
- package/kits/hub-game/code/client/shot.js +92 -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 +131 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +538 -47
- package/kits/hub-game/code/client/tiers.js +541 -27
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +98 -1
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/wear.js +470 -97
- package/kits/hub-game/code/client/yours.js +199 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/actions.js +133 -0
- package/kits/hub-game/code/server/actors.js +14 -1
- 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 +82 -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/earned.js +461 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +232 -0
- package/kits/hub-game/code/server/grab.js +296 -11
- package/kits/hub-game/code/server/history.js +5 -0
- package/kits/hub-game/code/server/hub.js +1317 -52
- package/kits/hub-game/code/server/idle.js +30 -11
- package/kits/hub-game/code/server/index.js +2 -2
- package/kits/hub-game/code/server/labels.js +28 -2
- package/kits/hub-game/code/server/manifest.js +424 -8
- package/kits/hub-game/code/server/menu.js +133 -0
- package/kits/hub-game/code/server/npcs.js +830 -80
- package/kits/hub-game/code/server/party.js +13 -2
- package/kits/hub-game/code/server/players.js +22 -0
- package/kits/hub-game/code/server/say.js +8 -2
- package/kits/hub-game/code/server/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +124 -0
- package/kits/hub-game/code/server/vis.js +113 -0
- package/kits/hub-game/code/server/wear.js +128 -11
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/decor.js +41 -0
- package/kits/hub-game/code/shared/shot.js +19 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1083 -85
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +2440 -61
- package/kits/hub-game/docs/home-pieces.md +64 -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 +2 -0
- package/kits/hub-game/package.json +2 -1
- package/kits/hub-game/scripts/check.mjs +78 -11
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -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/soundscape-wave-analysis.mjs +125 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +488 -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 +19 -17
- package/kits/hub-game/scripts/test-ask-client.mjs +358 -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 +753 -0
- package/kits/hub-game/scripts/test-avatar.mjs +540 -7
- package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
- package/kits/hub-game/scripts/test-build.mjs +31 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +694 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +198 -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-decor-client.mjs +303 -0
- package/kits/hub-game/scripts/test-decor.mjs +457 -0
- package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1194 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
- package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
- package/kits/hub-game/scripts/test-grab.mjs +864 -3
- package/kits/hub-game/scripts/test-hats.mjs +483 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
- package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
- package/kits/hub-game/scripts/test-idle.mjs +361 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
- package/kits/hub-game/scripts/test-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +596 -0
- package/kits/hub-game/scripts/test-manifest.mjs +282 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
- package/kits/hub-game/scripts/test-menu.mjs +296 -0
- package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -0
- package/kits/hub-game/scripts/test-party.mjs +22 -1
- package/kits/hub-game/scripts/test-picker.mjs +314 -0
- package/kits/hub-game/scripts/test-rehello.mjs +1039 -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-say.mjs +59 -2
- package/kits/hub-game/scripts/test-shot.mjs +756 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +416 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
- package/kits/hub-game/scripts/test-tiers.mjs +666 -3
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +940 -0
- package/kits/hub-game/scripts/test-vis.mjs +343 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
- package/kits/hub-game/scripts/test-yours.mjs +372 -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/nameTags.js +59 -4
- 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 +74 -4
- package/kits/multiplayer-3d/package.json +2 -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-own-name-tag.mjs +247 -0
- package/kits/physics-2d/CLAUDE.md +9 -0
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/scene.js +288 -1
- 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/scripts/test-skip-unchanged.mjs +370 -1
- package/kits/physics-3d/CLAUDE.md +1391 -0
- package/kits/physics-3d/behaviors/Player.jsx +921 -3
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/pxmodel-format.md +12 -0
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
- package/kits/physics-3d/engine3d/actornode.js +86 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -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 +96 -0
- package/kits/physics-3d/engine3d/gait.js +118 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +507 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -0
- package/kits/physics-3d/engine3d/motion.js +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +37 -19
- package/kits/physics-3d/engine3d/optimize.js +58 -5
- package/kits/physics-3d/engine3d/orbitinput.js +755 -0
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- package/kits/physics-3d/engine3d/pxmodel.js +42 -11
- package/kits/physics-3d/engine3d/shadowfade.js +882 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- 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 +870 -87
- package/kits/physics-3d/main.jsx +5 -0
- package/kits/physics-3d/package.json +1 -1
- package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
- package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -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 +3 -0
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -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-static-actors.mjs +13 -1
- package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +474 -12
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/server/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +97 -19
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
// On by use (v1.36): candidates, never the player's follow list. The host
|
|
2
|
+
// checks the connected player's account, age, blocks and recent client ask.
|
|
3
|
+
// The kit has no age data; friendBests keeps signed-in reporters' userId,
|
|
4
|
+
// username and best like game boards/results and per-player records. Only this
|
|
5
|
+
// gate shows them: ghost requires mutual follows, no block and both players
|
|
6
|
+
// answered over 13. Under-13 players see and show nobody; their client may ask
|
|
7
|
+
// Hub.friends, but ghost returns nothing and no data flows from that ask.
|
|
8
|
+
// Cell interest also primes candidate relations for server-only ordering;
|
|
9
|
+
// follows in either direction never become friends for the public/chat API.
|
|
10
|
+
export const USER_ID = /^\d{1,20}$/;
|
|
11
|
+
const EMPTY_MS = 40000;
|
|
12
|
+
const FRIEND_MS = 10 * 60000;
|
|
13
|
+
const MIN_READ_GAP_MS = 31000;
|
|
14
|
+
const ARRIVAL_MS = 60000;
|
|
15
|
+
const CHECK_MS = 5000;
|
|
16
|
+
const diagnostics = new WeakMap();
|
|
17
|
+
// The refusals a host or ghost answers with, by name; anything else is 'other'.
|
|
18
|
+
const REFUSAL_CODES = new Set([
|
|
19
|
+
'UNKNOWN_COMMAND',
|
|
20
|
+
'UNAVAILABLE',
|
|
21
|
+
'CAULDRON_STORAGE_INVALID_ARGUMENT',
|
|
22
|
+
'CAULDRON_STORAGE_UNAVAILABLE',
|
|
23
|
+
'CAULDRON_HUB_INVALID_ARGUMENT',
|
|
24
|
+
'CAULDRON_HUB_UNAVAILABLE',
|
|
25
|
+
'CAULDRON_HUB_FRIENDS_RATE_LIMITED',
|
|
26
|
+
'CAULDRON_HUB_FRIENDS_ACCOUNT_REQUIRED',
|
|
27
|
+
'CAULDRON_HUB_FRIENDS_AMONG_RATE_LIMITED',
|
|
28
|
+
'CAULDRON_HUB_FRIENDS_AMONG_INVALID',
|
|
29
|
+
]);
|
|
30
|
+
|
|
31
|
+
function warnOnce(session, outcome, message) {
|
|
32
|
+
let seen = diagnostics.get(session);
|
|
33
|
+
if (!seen) {
|
|
34
|
+
seen = new Set();
|
|
35
|
+
diagnostics.set(session, seen);
|
|
36
|
+
}
|
|
37
|
+
if (!seen.has(outcome)) {
|
|
38
|
+
seen.add(outcome);
|
|
39
|
+
console.warn(message);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export async function friendsAmong(h, playerId, userIds, userIdOf) {
|
|
44
|
+
try {
|
|
45
|
+
if (
|
|
46
|
+
typeof playerId !== 'string' ||
|
|
47
|
+
!USER_ID.test(userIdOf(h, playerId) ?? '') ||
|
|
48
|
+
!h.sim?.players.has(playerId) ||
|
|
49
|
+
!Array.isArray(userIds)
|
|
50
|
+
) {
|
|
51
|
+
return [];
|
|
52
|
+
}
|
|
53
|
+
const ids = [
|
|
54
|
+
...new Set(userIds.filter((id) => typeof id === 'string' && USER_ID.test(id))),
|
|
55
|
+
].slice(0, 100);
|
|
56
|
+
if (!h.friendsWanted?.has(playerId)) {
|
|
57
|
+
(h.friendsWanted ??= new Set()).add(playerId);
|
|
58
|
+
h.session?.send(playerId, { k: 'hub-friends-wanted' });
|
|
59
|
+
}
|
|
60
|
+
if (!ids.length) {
|
|
61
|
+
return [];
|
|
62
|
+
}
|
|
63
|
+
const now = Date.now();
|
|
64
|
+
const cache = (h.friendsCache ??= new Map());
|
|
65
|
+
// Retain a departing player's rate bound, but don't retain old visits forever.
|
|
66
|
+
for (const [id, entry] of cache) {
|
|
67
|
+
if (now - entry.at >= entry.ttl && !h.sim.players.has(id) && !entry.pending) {
|
|
68
|
+
cache.delete(id);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
let entry = cache.get(playerId);
|
|
72
|
+
if (h.cells) {
|
|
73
|
+
if (entry) {
|
|
74
|
+
entry.deckIds = ids;
|
|
75
|
+
}
|
|
76
|
+
if (entry?.pending) {
|
|
77
|
+
await entry.pending;
|
|
78
|
+
if (!h.sim?.players.has(playerId) || !USER_ID.test(userIdOf(h, playerId) ?? '')) {
|
|
79
|
+
return [];
|
|
80
|
+
}
|
|
81
|
+
// Another waiting ask may already have latched the covering read.
|
|
82
|
+
entry = cache.get(playerId);
|
|
83
|
+
}
|
|
84
|
+
const readAt = Date.now();
|
|
85
|
+
const placeIds = placeUsers(h, playerId, userIdOf);
|
|
86
|
+
if (!entry || (!entry.pending && readAt - entry.at >= MIN_READ_GAP_MS &&
|
|
87
|
+
(stale(entry, readAt, placeIds) || (hasNew(entry, ids) && !(entry.refused && readAt - entry.at < entry.ttl))))) {
|
|
88
|
+
entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt);
|
|
89
|
+
}
|
|
90
|
+
entry.deckIds = ids;
|
|
91
|
+
} else if (!entry || (!entry.pending && now - entry.at >= entry.ttl)) {
|
|
92
|
+
// Keyless calls keep the original TTL, candidates and pending behavior.
|
|
93
|
+
entry = startRead(h, playerId, ids, now);
|
|
94
|
+
}
|
|
95
|
+
await entry.pending;
|
|
96
|
+
return ids.filter((id) => entry.ids.includes(id));
|
|
97
|
+
} catch {
|
|
98
|
+
return [];
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
function placeUsers(h, playerId, userIdOf) {
|
|
103
|
+
return [...h.sim.players.keys()]
|
|
104
|
+
.filter((id) => id !== playerId)
|
|
105
|
+
.map((id) => userIdOf(h, id))
|
|
106
|
+
.filter((id) => typeof id === 'string' && USER_ID.test(id));
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
function hasNew(entry, placeIds) {
|
|
110
|
+
const asked = new Set(entry.asked);
|
|
111
|
+
return placeIds.some((id) => !asked.has(id));
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
function stale(entry, now, placeIds) {
|
|
115
|
+
const age = now - entry.at;
|
|
116
|
+
return age >= entry.ttl || (age >= ARRIVAL_MS && hasNew(entry, placeIds));
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
function startRead(h, playerId, ids, now) {
|
|
120
|
+
const entry = {
|
|
121
|
+
at: now, ttl: EMPTY_MS, ids: [], follows: [], followedBy: [], asked: ids, pending: null,
|
|
122
|
+
};
|
|
123
|
+
(h.friendsCache ??= new Map()).set(playerId, entry);
|
|
124
|
+
// Latch before awaiting: deck asks and background primes share this read.
|
|
125
|
+
entry.pending = read(h, playerId, ids).then((answer) => {
|
|
126
|
+
entry.ids = answer.friends;
|
|
127
|
+
entry.follows = answer.follows;
|
|
128
|
+
entry.followedBy = answer.followedBy;
|
|
129
|
+
entry.ttl = answer.friends.length ? FRIEND_MS : EMPTY_MS;
|
|
130
|
+
entry.refused = answer.refused === true;
|
|
131
|
+
entry.pending = null;
|
|
132
|
+
});
|
|
133
|
+
return entry;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
// Called after hello, and from the throttled tick check for early hellos/arrivals.
|
|
137
|
+
export function prime(h, playerId, userIdOf, placeIds) {
|
|
138
|
+
if (!h.cells || !h.players.get(playerId)?.hello || !h.sim?.players.has(playerId) ||
|
|
139
|
+
!USER_ID.test(userIdOf(h, playerId) ?? '')) {
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
const entry = h.friendsCache?.get(playerId);
|
|
143
|
+
if (entry?.pending) {
|
|
144
|
+
return;
|
|
145
|
+
}
|
|
146
|
+
const now = Date.now();
|
|
147
|
+
placeIds ??= placeUsers(h, playerId, userIdOf);
|
|
148
|
+
// Expiry retries even for an unchanged roster, including refused reads.
|
|
149
|
+
// Non-empty mutual-friend entries also refresh for arrivals after a minute.
|
|
150
|
+
if (entry && (now - entry.at < MIN_READ_GAP_MS || !stale(entry, now, placeIds))) {
|
|
151
|
+
return;
|
|
152
|
+
}
|
|
153
|
+
const ids = [...new Set([...(entry?.deckIds ?? []), ...placeIds])].slice(0, 100);
|
|
154
|
+
if (ids.length) {
|
|
155
|
+
const fresh = startRead(h, playerId, ids, now);
|
|
156
|
+
fresh.deckIds = entry?.deckIds ?? [];
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
export function tick(h, userIdOf) {
|
|
161
|
+
if (!h.cells || !h.sim) {
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
const now = Date.now();
|
|
165
|
+
if (now - (h.friendsCheckAt ?? -Infinity) < CHECK_MS) {
|
|
166
|
+
return;
|
|
167
|
+
}
|
|
168
|
+
h.friendsCheckAt = now;
|
|
169
|
+
const users = new Map([...h.sim.players.keys()].map((id) => [id, userIdOf(h, id)]));
|
|
170
|
+
const ids = [...users.values()].filter((id) => typeof id === 'string' && USER_ID.test(id));
|
|
171
|
+
for (const [playerId, userId] of users) {
|
|
172
|
+
prime(h, playerId, (_h, id) => users.get(id), ids.filter((id) => id !== userId));
|
|
173
|
+
}
|
|
174
|
+
for (const [id, entry] of h.friendsCache ?? []) {
|
|
175
|
+
if (now - entry.at >= entry.ttl && !h.sim.players.has(id) && !entry.pending) {
|
|
176
|
+
h.friendsCache.delete(id);
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
async function read(h, playerId, ids) {
|
|
182
|
+
const empty = { friends: [], follows: [], followedBy: [] };
|
|
183
|
+
try {
|
|
184
|
+
if (!h.session?.hub) {
|
|
185
|
+
// Only the local serve has a dev session id; a production named session
|
|
186
|
+
// without hub ops must still fail closed, even with this env var set.
|
|
187
|
+
return String(h.session?.sessionId ?? '').startsWith('dev') &&
|
|
188
|
+
typeof process !== 'undefined' &&
|
|
189
|
+
process.env.CASTLE_DEV_HUB_FRIENDS === 'all'
|
|
190
|
+
? { ...empty, friends: ids }
|
|
191
|
+
: empty;
|
|
192
|
+
}
|
|
193
|
+
if (h.cells && typeof h.session.hub.relationsAmong === 'function') {
|
|
194
|
+
const answer = await h.session.hub.relationsAmong(playerId, ids);
|
|
195
|
+
const list = (value) => Array.isArray(value) ? ids.filter((id) => value.includes(id)) : [];
|
|
196
|
+
const relations = {
|
|
197
|
+
friends: list(answer?.friends),
|
|
198
|
+
follows: list(answer?.follows),
|
|
199
|
+
followedBy: list(answer?.followedBy),
|
|
200
|
+
};
|
|
201
|
+
if (answer && typeof answer === 'object') {
|
|
202
|
+
warnOnce(h.session, 'answered', `[hub] friendsAmong: answered ${relations.friends.length} of ${ids.length}`);
|
|
203
|
+
}
|
|
204
|
+
return relations;
|
|
205
|
+
}
|
|
206
|
+
const answer = await h.session.hub.friendsAmong?.(playerId, ids);
|
|
207
|
+
const friends = Array.isArray(answer) ? ids.filter((id) => answer.includes(id)) : [];
|
|
208
|
+
if (Array.isArray(answer)) {
|
|
209
|
+
warnOnce(h.session, 'answered', `[hub] friendsAmong: answered ${friends.length} of ${ids.length}`);
|
|
210
|
+
}
|
|
211
|
+
return { ...empty, friends };
|
|
212
|
+
} catch (error) {
|
|
213
|
+
// Only a platform code's shape is logged (never a message, which may name someone).
|
|
214
|
+
const code = typeof error?.code === 'string' ? error.code : '';
|
|
215
|
+
const reason = REFUSAL_CODES.has(code) ? code : 'other';
|
|
216
|
+
warnOnce(h.session, `refused:${reason}`, `[hub] friendsAmong refused: ${reason}`);
|
|
217
|
+
return { ...empty, refused: true };
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
export function resend(h, playerId) {
|
|
222
|
+
if (h.friendsWanted?.has(playerId)) {
|
|
223
|
+
h.session?.send(playerId, { k: 'hub-friends-wanted' });
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
export function forget(h, playerId) {
|
|
228
|
+
h.friendsWanted?.delete(playerId);
|
|
229
|
+
for (const helper of h.friendBestHelpers?.values() ?? []) {
|
|
230
|
+
helper.forget(playerId);
|
|
231
|
+
}
|
|
232
|
+
}
|
|
@@ -10,11 +10,31 @@
|
|
|
10
10
|
// { k: 'hub-grab-deny', actor } server -> that client
|
|
11
11
|
// { k: 'hub-drop' } server -> that client
|
|
12
12
|
//
|
|
13
|
+
// A place may keep a held object its holder's (v1.25, `grab.keepHeld`):
|
|
14
|
+
// multiplayer-3d hands a loose object to whichever player is nearer, so
|
|
15
|
+
// someone standing close takes a held object out of its holder's hands. In
|
|
16
|
+
// such a place the held object is pinned -- its sim entry's `claimable` is
|
|
17
|
+
// false, so multiplayer-3d refuses every other claim -- for as long as the
|
|
18
|
+
// hold lasts and its holder's client keeps saying it holds it:
|
|
19
|
+
//
|
|
20
|
+
// { k: 'hub-grab', actor, op: 'hold' } client -> server, about once a second
|
|
21
|
+
//
|
|
22
|
+
// A place without `keepHeld` never pins, and drops that message as malformed.
|
|
23
|
+
//
|
|
24
|
+
// A place may keep a loose object for one player (v1.27, `hub.keepFor`): a
|
|
25
|
+
// grab of it by anyone else is refused here, before the place's hook is asked,
|
|
26
|
+
// and every client is told whose it is (`hubKept`, `keptOf`) so it is offered
|
|
27
|
+
// to nobody else. `keptFor` is empty until a place calls `hub.keepFor`, and
|
|
28
|
+
// every line that reads it does nothing while it is: such a place is checked,
|
|
29
|
+
// asked and sent exactly what it was.
|
|
30
|
+
//
|
|
13
31
|
// `h` is the hub layer's state: `place`, `actors`, `sim`, `hidden`, `held`,
|
|
14
32
|
// `hooks`, `ctx`, `session`, and `grabs`, `grabBudget`, `flying` from
|
|
15
33
|
// `newGrabState`. Every message is a client's word, so each is checked
|
|
16
34
|
// against the simulation and bounded per player.
|
|
17
35
|
|
|
36
|
+
import { warnOnce } from './actors.js';
|
|
37
|
+
|
|
18
38
|
// How far from a player's body (metres) an object they say they grabbed may
|
|
19
39
|
// be: the client offers one within about 2.5 m (with a place's `grab.reach`
|
|
20
40
|
// or `grab.steady`, v1.22, never one whose centre is past 3.5 m), and the
|
|
@@ -31,6 +51,16 @@ export const GRAB_BURST = 4;
|
|
|
31
51
|
// again, and the speed below which it has landed.
|
|
32
52
|
export const FLIGHT_MS = 3000;
|
|
33
53
|
const LANDED_SPEED = 4;
|
|
54
|
+
// v1.25 `keepHeld`: a pin lasts this long past the grab or the holder's last
|
|
55
|
+
// `hold`. The client ends a hold by itself without a word (a trip, the talk
|
|
56
|
+
// panel, a refusal), and one from before v1.25 never says `hold` at all, so a
|
|
57
|
+
// pin nobody renews lapses and the object is anyone's again, as before.
|
|
58
|
+
export const KEEP_LEASE_MS = 2500;
|
|
59
|
+
// A pinned object is in front of its holder (`holdDistance` is at most 3 m,
|
|
60
|
+
// `holdHeight` 2.5 m). Farther than this from the holder's body, by the
|
|
61
|
+
// server's own poses, it is not being held: the pin and the hold end, at each
|
|
62
|
+
// tick and at each `hold`, so a client cannot keep an object pinned from afar.
|
|
63
|
+
export const KEEP_REACH = THROW_REACH;
|
|
34
64
|
|
|
35
65
|
export function newGrabState() {
|
|
36
66
|
return {
|
|
@@ -41,11 +71,195 @@ export function newGrabState() {
|
|
|
41
71
|
// actorId -> { until }: thrown objects in flight (their sim entry carries
|
|
42
72
|
// the flight's `speedCap` meanwhile)
|
|
43
73
|
flying: new Map(),
|
|
74
|
+
// actorId -> { holder, claimable, until }: held objects pinned to their
|
|
75
|
+
// holder (v1.25 `keepHeld`), with the `claimable` to put back
|
|
76
|
+
pins: new Map(),
|
|
77
|
+
// `keepHeld` only: how many times a hold of each player, or of each
|
|
78
|
+
// object, or everyone's, has been ended or ruled out (`ended`), so a grab
|
|
79
|
+
// being put to the place's hook can tell that the hook itself did so
|
|
80
|
+
ends: { players: new Map(), objects: new Map(), all: 0 },
|
|
81
|
+
// actorId -> the only player who may grab it (v1.27 `hub.keepFor`); empty
|
|
82
|
+
// in a place that never calls it
|
|
83
|
+
keptFor: new Map(),
|
|
44
84
|
};
|
|
45
85
|
}
|
|
46
86
|
|
|
87
|
+
// v1.27: whether this object is kept for a player other than this one. False
|
|
88
|
+
// for everything while nothing is kept.
|
|
89
|
+
function keptFromPlayer(h, playerId, actorId) {
|
|
90
|
+
return h.keptFor.size > 0 && h.keptFor.has(actorId) && h.keptFor.get(actorId) !== playerId;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// `hub.keepFor(actorId, playerId | null)` (v1.27): from now on only that
|
|
94
|
+
// player may grab this loose object; `null` makes it anyone's again. Anyone
|
|
95
|
+
// else holding it lets go (`hub-drop`, as `hub.drop` tells them). Returns
|
|
96
|
+
// whether the object is now kept as asked; a place without `grab`, an actor
|
|
97
|
+
// that is not a dynamic one of the place's scene, or a player who is not here
|
|
98
|
+
// is warned about once and changes nothing. The mark outlives `hub.reset` and
|
|
99
|
+
// ends with `hub.hide`, with the player's leaving, and with `null`.
|
|
100
|
+
export function keepFor(h, actorId, playerId) {
|
|
101
|
+
if (!h.place.grab) {
|
|
102
|
+
warnOnce(h, 'keepFor:grab', 'hub.keepFor: this place has no "grab" in its hub block');
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
const actor = typeof actorId === 'string' ? h.actors.find((a) => a.id === actorId) : null;
|
|
106
|
+
if (actor?.components.Body?.type !== 'dynamic' || !h.sim?.objects?.get(actorId)?.body) {
|
|
107
|
+
warnOnce(h, `keepFor:${actorId}`, `hub.keepFor: "${actorId}" is not a dynamic actor of this place's scene`);
|
|
108
|
+
return false;
|
|
109
|
+
}
|
|
110
|
+
// Only `null` clears: a player id that is missing (a lookup that failed) is
|
|
111
|
+
// an invalid player, warned about below, and never frees the object.
|
|
112
|
+
if (playerId === null) {
|
|
113
|
+
h.keptFor.delete(actorId);
|
|
114
|
+
return true;
|
|
115
|
+
}
|
|
116
|
+
if (!h.players.has(playerId)) {
|
|
117
|
+
warnOnce(h, `keepFor:player:${playerId}`, `hub.keepFor: "${playerId}" is not a player in this place`);
|
|
118
|
+
return false;
|
|
119
|
+
}
|
|
120
|
+
h.keptFor.set(actorId, playerId);
|
|
121
|
+
for (const [holder, held] of [...h.grabs]) {
|
|
122
|
+
if (held === actorId && holder !== playerId) {
|
|
123
|
+
endHold(h, holder);
|
|
124
|
+
h.session?.send(holder, { k: 'hub-drop', actor: actorId });
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
return true;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
// The place hid an object (`hub.hide`): kept for nobody. (A copy made by
|
|
131
|
+
// `hub.spawn` is never a loose object, so `hub.despawn` has none to forget.)
|
|
132
|
+
export function unkeep(h, actorId) {
|
|
133
|
+
h.keptFor.delete(actorId);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
// What clients are told (`hubKept`): actor id -> the player it is kept for.
|
|
137
|
+
export function keptOf(h) {
|
|
138
|
+
const out = Object.create(null);
|
|
139
|
+
for (const [actorId, playerId] of h.keptFor) {
|
|
140
|
+
out[actorId] = playerId;
|
|
141
|
+
}
|
|
142
|
+
return out;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
// In a `keepHeld` place, note that this player's hold, this object's, or
|
|
146
|
+
// everyone's (neither given) is over, whether or not there was one.
|
|
147
|
+
function ended(h, playerId, actorId) {
|
|
148
|
+
if (!keeps(h)) {
|
|
149
|
+
return;
|
|
150
|
+
}
|
|
151
|
+
if (playerId === undefined && actorId === undefined) {
|
|
152
|
+
h.ends.all += 1;
|
|
153
|
+
}
|
|
154
|
+
if (playerId !== undefined) {
|
|
155
|
+
h.ends.players.set(playerId, (h.ends.players.get(playerId) ?? 0) + 1);
|
|
156
|
+
}
|
|
157
|
+
if (actorId !== undefined) {
|
|
158
|
+
h.ends.objects.set(actorId, (h.ends.objects.get(actorId) ?? 0) + 1);
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function endsOf(h, playerId, actorId) {
|
|
163
|
+
return `${h.ends.all}:${h.ends.players.get(playerId) ?? 0}:${h.ends.objects.get(actorId) ?? 0}`;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
function keeps(h) {
|
|
167
|
+
return h.place.grab?.keepHeld === true;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// Pin a held object to its holder, or renew the pin.
|
|
171
|
+
function pin(h, playerId, actorId, entry) {
|
|
172
|
+
if (!keeps(h)) {
|
|
173
|
+
return;
|
|
174
|
+
}
|
|
175
|
+
const until = h.sim.timeMs + KEEP_LEASE_MS;
|
|
176
|
+
const had = h.pins.get(actorId);
|
|
177
|
+
if (had) {
|
|
178
|
+
had.holder = playerId;
|
|
179
|
+
had.until = until;
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
h.pins.set(actorId, { holder: playerId, claimable: entry.claimable, until });
|
|
183
|
+
entry.claimable = false;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
// Take a pin off: the object is as claimable as it was before. With `holder`,
|
|
187
|
+
// only that player's pin. `hub.reset` unpins before its own hold on
|
|
188
|
+
// `claimable` (`actors.js`), so the two never save each other's `false`.
|
|
189
|
+
export function unpin(h, actorId, holder) {
|
|
190
|
+
const pinned = h.pins?.get(actorId);
|
|
191
|
+
if (!pinned || (holder !== undefined && pinned.holder !== holder)) {
|
|
192
|
+
return;
|
|
193
|
+
}
|
|
194
|
+
h.pins.delete(actorId);
|
|
195
|
+
const entry = h.sim?.objects?.get(actorId);
|
|
196
|
+
if (entry) {
|
|
197
|
+
entry.claimable = pinned.claimable;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
// What a hold in a `keepHeld` place needs beyond what any hold does, checked
|
|
202
|
+
// at every tick and every `hold` whether or not it is pinned just now: a
|
|
203
|
+
// player who has arrived and whose game has not ended, with their body by
|
|
204
|
+
// the object.
|
|
205
|
+
function inForce(h, playerId, entry) {
|
|
206
|
+
const player = h.players.get(playerId);
|
|
207
|
+
return Boolean(player?.arrived && !player.ended && entry?.body && near(h, playerId, entry, KEEP_REACH));
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
// The place took an object out of play (`hub.hide`, `hub.reset`): unpinned,
|
|
211
|
+
// and in a `keepHeld` place its hold is over at once, not at the next tick.
|
|
212
|
+
export function taken(h, actorId) {
|
|
213
|
+
ended(h, undefined, actorId);
|
|
214
|
+
unpin(h, actorId);
|
|
215
|
+
if (keeps(h)) {
|
|
216
|
+
for (const [playerId, held] of [...h.grabs]) {
|
|
217
|
+
if (held === actorId) {
|
|
218
|
+
endHold(h, playerId);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
// The place held a player still (`hub.hold`): in a `keepHeld` place their
|
|
225
|
+
// hold is over at once.
|
|
226
|
+
export function stilled(h, playerId) {
|
|
227
|
+
ended(h, playerId);
|
|
228
|
+
if (keeps(h)) {
|
|
229
|
+
endHold(h, playerId);
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// In a `keepHeld` place, after the place's hook has run: everything a grab
|
|
234
|
+
// had to pass before it, read again, since the hook may have ended the
|
|
235
|
+
// player's game, moved or removed their body, or taken the object away.
|
|
236
|
+
function stillGrabbable(h, playerId, actorId) {
|
|
237
|
+
const entry = looseObject(h, actorId);
|
|
238
|
+
const player = h.players.get(playerId);
|
|
239
|
+
return Boolean(
|
|
240
|
+
player?.arrived &&
|
|
241
|
+
!player.ended &&
|
|
242
|
+
h.sim.players.has(playerId) &&
|
|
243
|
+
!h.held.has(playerId) &&
|
|
244
|
+
entry?.owner === playerId &&
|
|
245
|
+
near(h, playerId, entry, GRAB_REACH),
|
|
246
|
+
);
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
// Every end of a hold goes through here, so its pin goes with it.
|
|
250
|
+
function endHold(h, playerId) {
|
|
251
|
+
const actorId = h.grabs.get(playerId);
|
|
252
|
+
if (actorId === undefined) {
|
|
253
|
+
return;
|
|
254
|
+
}
|
|
255
|
+
h.grabs.delete(playerId);
|
|
256
|
+
ended(h, playerId, actorId);
|
|
257
|
+
unpin(h, actorId, playerId);
|
|
258
|
+
}
|
|
259
|
+
|
|
47
260
|
// A scene actor whose body multiplayer-3d hands to clients: authored with a
|
|
48
|
-
// dynamic Body, built as a claimable object, and not hidden by the place.
|
|
261
|
+
// dynamic Body, built as a claimable object, and not hidden by the place. A
|
|
262
|
+
// pinned object (v1.25) is still one: it is unclaimable only because it is held.
|
|
49
263
|
function looseObject(h, actorId) {
|
|
50
264
|
if (typeof actorId !== 'string' || actorId.length > 128 || h.hidden.has(actorId)) {
|
|
51
265
|
return null;
|
|
@@ -55,7 +269,7 @@ function looseObject(h, actorId) {
|
|
|
55
269
|
return null;
|
|
56
270
|
}
|
|
57
271
|
const entry = h.sim?.objects?.get(actorId);
|
|
58
|
-
return entry?.claimable && entry.body ? entry : null;
|
|
272
|
+
return (entry?.claimable || (entry && h.pins.has(actorId))) && entry.body ? entry : null;
|
|
59
273
|
}
|
|
60
274
|
|
|
61
275
|
function near(h, playerId, entry, reach) {
|
|
@@ -79,6 +293,13 @@ function spend(h, playerId) {
|
|
|
79
293
|
}
|
|
80
294
|
|
|
81
295
|
function deny(h, playerId, actorId) {
|
|
296
|
+
// In a `keepHeld` place a refusal of what the player holds ends that hold,
|
|
297
|
+
// record and pin: the client lets go, and no later `hold` may renew a pin
|
|
298
|
+
// the place's hook has since refused. (Elsewhere a refusal leaves the
|
|
299
|
+
// record as it always did, until the object moves on.)
|
|
300
|
+
if (keeps(h) && h.grabs.get(playerId) === actorId) {
|
|
301
|
+
endHold(h, playerId);
|
|
302
|
+
}
|
|
82
303
|
h.session?.send(playerId, { k: 'hub-grab-deny', actor: actorId });
|
|
83
304
|
}
|
|
84
305
|
|
|
@@ -100,8 +321,9 @@ function ask(h, playerId, actorId, op) {
|
|
|
100
321
|
// dropped. A grab that is refused -- past the rate, not a loose object of the
|
|
101
322
|
// place, too far, not this player's to simulate, a held or departed player,
|
|
102
323
|
// or the place's hook said no -- is answered `hub-grab-deny`, and the client
|
|
103
|
-
// lets go.
|
|
104
|
-
//
|
|
324
|
+
// lets go. So is a grab of an object the place keeps for another player
|
|
325
|
+
// (v1.27), which the hook is never asked about. A throw of something the
|
|
326
|
+
// place does not know this player holds is dropped.
|
|
105
327
|
export function message(h, playerId, data) {
|
|
106
328
|
const op = data?.op;
|
|
107
329
|
if (
|
|
@@ -109,7 +331,7 @@ export function message(h, playerId, data) {
|
|
|
109
331
|
playerId === null ||
|
|
110
332
|
!h.place.grab ||
|
|
111
333
|
!h.sim ||
|
|
112
|
-
(op !== 'grab' && op !== 'throw') ||
|
|
334
|
+
(op !== 'grab' && op !== 'throw' && !(op === 'hold' && keeps(h))) ||
|
|
113
335
|
typeof data.actor !== 'string' ||
|
|
114
336
|
data.actor.length > 128
|
|
115
337
|
) {
|
|
@@ -119,16 +341,35 @@ export function message(h, playerId, data) {
|
|
|
119
341
|
if (!spend(h, playerId)) {
|
|
120
342
|
if (op === 'grab') {
|
|
121
343
|
deny(h, playerId, actorId);
|
|
344
|
+
} else if (op === 'throw' && keeps(h) && h.grabs.get(playerId) === actorId) {
|
|
345
|
+
// Past the rate a throw is not heard, but in a `keepHeld` place the
|
|
346
|
+
// hold it ends is over all the same: no `hold` renews it.
|
|
347
|
+
endHold(h, playerId);
|
|
122
348
|
}
|
|
123
349
|
return;
|
|
124
350
|
}
|
|
125
351
|
const entry = looseObject(h, actorId);
|
|
126
352
|
const entered = h.players.get(playerId)?.arrived && !h.players.get(playerId)?.ended;
|
|
353
|
+
if (op === 'hold') {
|
|
354
|
+
// Still holding it, says its holder's client: the pin is renewed (or put
|
|
355
|
+
// back after a lapse) while the hold is one the server still knows.
|
|
356
|
+
// A holder whose body is not by the object is not holding it, whatever
|
|
357
|
+
// poses its client reports for it: that hold is over.
|
|
358
|
+
if (h.grabs.get(playerId) !== actorId) {
|
|
359
|
+
return;
|
|
360
|
+
}
|
|
361
|
+
if (entry?.owner === playerId && !h.held.has(playerId) && inForce(h, playerId, entry)) {
|
|
362
|
+
pin(h, playerId, actorId, entry);
|
|
363
|
+
} else {
|
|
364
|
+
endHold(h, playerId);
|
|
365
|
+
}
|
|
366
|
+
return;
|
|
367
|
+
}
|
|
127
368
|
if (op === 'throw') {
|
|
128
369
|
if (h.grabs.get(playerId) !== actorId) {
|
|
129
370
|
return;
|
|
130
371
|
}
|
|
131
|
-
h
|
|
372
|
+
endHold(h, playerId);
|
|
132
373
|
// Still theirs, now: the object may have been handed to someone else, or
|
|
133
374
|
// the player held, since the place last looked.
|
|
134
375
|
if (entry && entry.owner === playerId && entered && !h.held.has(playerId) && near(h, playerId, entry, THROW_REACH)) {
|
|
@@ -148,7 +389,24 @@ export function message(h, playerId, data) {
|
|
|
148
389
|
deny(h, playerId, actorId);
|
|
149
390
|
return;
|
|
150
391
|
}
|
|
151
|
-
|
|
392
|
+
// v1.27: an object kept for someone else (`hub.keepFor`) is refused here,
|
|
393
|
+
// and the place's hook never hears of it.
|
|
394
|
+
if (keptFromPlayer(h, playerId, actorId)) {
|
|
395
|
+
deny(h, playerId, actorId);
|
|
396
|
+
return;
|
|
397
|
+
}
|
|
398
|
+
// In a `keepHeld` place the hook's own acts stand: if it dropped this
|
|
399
|
+
// player, hid or reset the object, or held the player still -- even if it
|
|
400
|
+
// undid that before returning -- the grab is refused, and the client is
|
|
401
|
+
// told so (`hub-grab-deny`) and lets go, rather than a hold the place just
|
|
402
|
+
// ended being recorded and pinned again.
|
|
403
|
+
const stamp = keeps(h) ? endsOf(h, playerId, actorId) : null;
|
|
404
|
+
if (
|
|
405
|
+
!ask(h, playerId, actorId, 'grab') ||
|
|
406
|
+
(stamp !== null && (endsOf(h, playerId, actorId) !== stamp || !stillGrabbable(h, playerId, actorId))) ||
|
|
407
|
+
// v1.27: the hook itself kept the object for someone else.
|
|
408
|
+
keptFromPlayer(h, playerId, actorId)
|
|
409
|
+
) {
|
|
152
410
|
deny(h, playerId, actorId);
|
|
153
411
|
return;
|
|
154
412
|
}
|
|
@@ -158,7 +416,14 @@ export function message(h, playerId, data) {
|
|
|
158
416
|
h.grabs.delete(other);
|
|
159
417
|
}
|
|
160
418
|
}
|
|
419
|
+
// The object held before goes free. The record is set in place, as ever:
|
|
420
|
+
// the order of holders is the order `hub.drop` tells them in.
|
|
421
|
+
const before = h.grabs.get(playerId);
|
|
422
|
+
if (before !== undefined && before !== actorId) {
|
|
423
|
+
unpin(h, before, playerId);
|
|
424
|
+
}
|
|
161
425
|
h.grabs.set(playerId, actorId);
|
|
426
|
+
pin(h, playerId, actorId, entry);
|
|
162
427
|
}
|
|
163
428
|
|
|
164
429
|
// A thrown object is not slowed to a shove's speed while it flies: until it
|
|
@@ -192,12 +457,13 @@ function capSpeed(body, cap) {
|
|
|
192
457
|
// `hub.drop(playerId?)`: whoever holds something lets go (default: everyone).
|
|
193
458
|
// Only players the place knows hold something are told. Returns how many.
|
|
194
459
|
export function drop(h, playerId) {
|
|
460
|
+
ended(h, playerId);
|
|
195
461
|
let n = 0;
|
|
196
462
|
for (const [holder, actorId] of [...h.grabs]) {
|
|
197
463
|
if (playerId !== undefined && holder !== playerId) {
|
|
198
464
|
continue;
|
|
199
465
|
}
|
|
200
|
-
h
|
|
466
|
+
endHold(h, holder);
|
|
201
467
|
h.session?.send(holder, { k: 'hub-drop', actor: actorId });
|
|
202
468
|
n += 1;
|
|
203
469
|
}
|
|
@@ -214,9 +480,16 @@ export function tick(h) {
|
|
|
214
480
|
!entry ||
|
|
215
481
|
entry.owner !== playerId ||
|
|
216
482
|
h.held.has(playerId) ||
|
|
217
|
-
!h.sim.players.has(playerId)
|
|
483
|
+
!h.sim.players.has(playerId) ||
|
|
484
|
+
(keeps(h) && !inForce(h, playerId, entry))
|
|
218
485
|
) {
|
|
219
|
-
h
|
|
486
|
+
endHold(h, playerId);
|
|
487
|
+
}
|
|
488
|
+
}
|
|
489
|
+
// A pin outlives nothing: not its hold, its lease, or its holder's visit.
|
|
490
|
+
for (const [actorId, pinned] of [...h.pins]) {
|
|
491
|
+
if (h.grabs.get(pinned.holder) !== actorId || h.sim.timeMs >= pinned.until) {
|
|
492
|
+
unpin(h, actorId);
|
|
220
493
|
}
|
|
221
494
|
}
|
|
222
495
|
for (const [actorId, flight] of [...h.flying]) {
|
|
@@ -238,8 +511,20 @@ export function tick(h) {
|
|
|
238
511
|
}
|
|
239
512
|
|
|
240
513
|
export function forget(h, playerId) {
|
|
241
|
-
h
|
|
514
|
+
endHold(h, playerId);
|
|
515
|
+
// Their count goes with them; `all` moves instead, so a grab in the hook
|
|
516
|
+
// just now still sees that something ended.
|
|
517
|
+
ended(h);
|
|
518
|
+
h.ends.players.delete(playerId);
|
|
242
519
|
h.grabBudget.delete(playerId);
|
|
520
|
+
// v1.27: what was kept for them is anyone's again.
|
|
521
|
+
if (h.keptFor.size > 0) {
|
|
522
|
+
for (const [actorId, keeper] of [...h.keptFor]) {
|
|
523
|
+
if (keeper === playerId) {
|
|
524
|
+
h.keptFor.delete(actorId);
|
|
525
|
+
}
|
|
526
|
+
}
|
|
527
|
+
}
|
|
243
528
|
}
|
|
244
529
|
|
|
245
530
|
// Who holds what, for the place: actor id or null.
|
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
// calling the host's results read itself. Only where the host has hub ops;
|
|
6
6
|
// null on the dev serve and for an anonymous player.
|
|
7
7
|
|
|
8
|
+
import { cleanHearts } from './yours.js';
|
|
9
|
+
|
|
8
10
|
export const HISTORY_EVERY_MS = 60000;
|
|
9
11
|
const MAX_ROWS = 20;
|
|
10
12
|
const MAX_USERS = 24;
|
|
@@ -52,6 +54,9 @@ export function take(h, playerId, read, startedAt = Date.now()) {
|
|
|
52
54
|
if (!entry || !read || (entry.historyFrom ?? -Infinity) > startedAt) {
|
|
53
55
|
return;
|
|
54
56
|
}
|
|
57
|
+
if (h.manifest?.yourGames) {
|
|
58
|
+
entry.hearts = cleanHearts(read.hearts);
|
|
59
|
+
}
|
|
55
60
|
entry.historyFrom = startedAt;
|
|
56
61
|
entry.history = {
|
|
57
62
|
recent: (Array.isArray(read.recent) ? read.recent : []).slice(0, MAX_ROWS).map(cleanRow),
|