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
|
@@ -7,6 +7,10 @@
|
|
|
7
7
|
// manifest is null when there are errors; otherwise every place has every
|
|
8
8
|
// field filled with its default.
|
|
9
9
|
|
|
10
|
+
import { readUnlocks } from './earned.js';
|
|
11
|
+
import { readDecor } from './decor.js';
|
|
12
|
+
|
|
13
|
+
// Manifest/wire major stays 1; latest optional contract additions are v1.83.
|
|
10
14
|
export const CONTRACT_VERSION = 1;
|
|
11
15
|
|
|
12
16
|
export const CONTROLLERS = ['walk'];
|
|
@@ -22,6 +26,7 @@ export const PLACE_ID = /^[a-z][a-z0-9-]{0,23}$/;
|
|
|
22
26
|
export const MAIN_PLACE = 'main';
|
|
23
27
|
// How many other players each client of a place is sent (`nearestPlayers`).
|
|
24
28
|
export const NEAREST_PLAYERS = 30;
|
|
29
|
+
export const NEAREST_PLAYERS_CELLS = 48;
|
|
25
30
|
export const NEAREST_PLAYERS_CAP = 100;
|
|
26
31
|
// Grabbing and throwing (v1.3, §6): what `grab: true` means, and the bounds of
|
|
27
32
|
// each field. The fastest throw stays well under multiplayer-3d's limit on an
|
|
@@ -35,7 +40,9 @@ const GRAB_LIMITS = { throwSpeed: [1, 14, 'm/s'], holdDistance: [0.8, 3, 'metres
|
|
|
35
40
|
// top stays inside the server's GRAB_REACH (4 m, centre to centre), and the
|
|
36
41
|
// client also never offers an object whose centre is past 3 m.
|
|
37
42
|
export const GRAB_REACH_LIMITS = [1.6, 3, 'metres'];
|
|
38
|
-
|
|
43
|
+
// v1.25 `keepHeld`: a held object stays its holder's (`code/server/grab.js`).
|
|
44
|
+
// Kept only when true, like `steady`.
|
|
45
|
+
const GRAB_KEYS = [...Object.keys(GRAB_DEFAULTS), 'reach', 'steady', 'keepHeld'];
|
|
39
46
|
// Idle play (v1.6, §6): emotes, seats and the place's own sounds. Sounds are
|
|
40
47
|
// files of the deck, listed so the server can refuse any other name.
|
|
41
48
|
export const IDLE_KEYS = ['emotes', 'seats', 'sounds'];
|
|
@@ -43,6 +50,20 @@ export const SOUND_EXTS = ['.mp3', '.wav', '.m4a'];
|
|
|
43
50
|
export const MAX_SOUND_FILES = 16;
|
|
44
51
|
const SOUND_PATH = /^[A-Za-z0-9_@-][A-Za-z0-9_./@-]{0,199}$/;
|
|
45
52
|
|
|
53
|
+
// v1.26 `hud`: how a place's client lays the HUD out. `clear` keeps the HUD
|
|
54
|
+
// short and keeps what is drawn over the world out from under it
|
|
55
|
+
// (`code/client/hudClear.js`). The client's only; kept only when true, so a
|
|
56
|
+
// place without it is read and sent exactly as before.
|
|
57
|
+
const HUD_KEYS = ['clear'];
|
|
58
|
+
|
|
59
|
+
// v1.68 `ballot`: a tappable choice card (`ballot.js`). The deck's fixed
|
|
60
|
+
// lines are the only words a player can send through it, declared here so
|
|
61
|
+
// the server can refuse any other id and the client words them itself.
|
|
62
|
+
export const BALLOT_LINE_ID = /^[a-z0-9-]{1,24}$/;
|
|
63
|
+
export const BALLOT_MAX_LINES = 32;
|
|
64
|
+
export const BALLOT_LINE_MAX = 40;
|
|
65
|
+
export const BALLOT_ABOUT = ['face', 'self'];
|
|
66
|
+
|
|
46
67
|
const PLACE_KEYS = [
|
|
47
68
|
'title',
|
|
48
69
|
'scene',
|
|
@@ -59,10 +80,40 @@ const PLACE_KEYS = [
|
|
|
59
80
|
'fallY',
|
|
60
81
|
'grab',
|
|
61
82
|
'idle',
|
|
83
|
+
'hud',
|
|
84
|
+
'decor',
|
|
85
|
+
'actions',
|
|
86
|
+
'companion',
|
|
87
|
+
'ask',
|
|
88
|
+
'menu',
|
|
89
|
+
'ballot',
|
|
90
|
+
'resume',
|
|
91
|
+
'visibility',
|
|
62
92
|
];
|
|
63
93
|
// `tiers` is the deck's, not a place's: the client's picture on a slow device
|
|
64
94
|
// (v1.21, `code/client/tiers.js`). The server reads nothing of it.
|
|
65
|
-
|
|
95
|
+
// `cues` is the deck's too (v1.23): a town that tells its players more about
|
|
96
|
+
// the friends and party they came with. Both halves read it, and a deck
|
|
97
|
+
// without it is sent and draws exactly what it did.
|
|
98
|
+
// `stuck` is the deck's as well (v1.33): a town offers a player who walks and
|
|
99
|
+
// gets nowhere the way back to its arrival. Both halves read it; the manifest
|
|
100
|
+
// carries the key only when it is true, so a deck without it reads as before.
|
|
101
|
+
// `labels` is the deck's and the client's alone, like `tiers` (v1.43): `"near"`
|
|
102
|
+
// keeps a town's labels near the player and apart (`code/client/labelsNear.js`).
|
|
103
|
+
// The server reads nothing of it and the manifest does not carry it.
|
|
104
|
+
// `soundscape` is the deck's (`code/client/soundscape.js` synthesises it):
|
|
105
|
+
// the sounds the kit makes itself -- NPC babble, footsteps -- and a sound
|
|
106
|
+
// control. `true` keeps babble and street steps; only new object fields ask
|
|
107
|
+
// for zone ambience, music, surface maps and UI cues (v1.49).
|
|
108
|
+
// Only the explicit cues part (v1.50) is read by the server. The manifest
|
|
109
|
+
// carries soundscape only when on, so a deck without it reads as before.
|
|
110
|
+
export const SOUNDSCAPE_KEYS = ['babble', 'steps', 'zones', 'ambience', 'ui', 'cues'];
|
|
111
|
+
export const SOUNDSCAPE_BEDS = ['square', 'meadow', 'night', 'harbour', 'crowd', 'market'];
|
|
112
|
+
export const SOUNDSCAPE_SURFACES = ['grass', 'street', 'wood', 'stone', 'sand', 'cobble'];
|
|
113
|
+
// `unlocks` is the deck's (v1.53): the earned items its places may give
|
|
114
|
+
// (`earned.js`). The manifest carries it only when declared, so a deck
|
|
115
|
+
// without it reads as before.
|
|
116
|
+
const TOP_KEYS = ['contract', 'places', 'interest', 'tiers', 'companionIdle', 'lowActorBudget', 'lowActorDistance', 'cues', 'stuck', 'yourGames', 'avatarColors', 'labels', 'soundscape', 'unlocks', 'house', ...PLACE_KEYS];
|
|
66
117
|
|
|
67
118
|
const DEFAULT_SCENE = 'scenes/main.scene';
|
|
68
119
|
|
|
@@ -80,9 +131,51 @@ export function readManifest(castleJson, sceneExists = () => true) {
|
|
|
80
131
|
);
|
|
81
132
|
}
|
|
82
133
|
unknownKeys(hub, TOP_KEYS, 'hub', errors);
|
|
134
|
+
if (hub.lowActorDistance !== undefined && typeof hub.lowActorDistance !== 'boolean') {
|
|
135
|
+
errors.push('hub.lowActorDistance must be true or false.');
|
|
136
|
+
}
|
|
137
|
+
if (hub.lowActorBudget !== undefined && typeof hub.lowActorBudget !== 'boolean') {
|
|
138
|
+
errors.push('hub.lowActorBudget must be true or false.');
|
|
139
|
+
}
|
|
140
|
+
if (hub.companionIdle !== undefined && typeof hub.companionIdle !== 'boolean') {
|
|
141
|
+
errors.push('hub.companionIdle must be true or false.');
|
|
142
|
+
}
|
|
83
143
|
if (hub.tiers !== undefined && typeof hub.tiers !== 'boolean') {
|
|
84
144
|
errors.push('hub.tiers must be true or false.');
|
|
85
145
|
}
|
|
146
|
+
if (hub.cues !== undefined && typeof hub.cues !== 'boolean') {
|
|
147
|
+
errors.push('hub.cues must be true or false.');
|
|
148
|
+
}
|
|
149
|
+
if (hub.yourGames !== undefined && typeof hub.yourGames !== 'boolean') {
|
|
150
|
+
errors.push('hub.yourGames must be true or false.');
|
|
151
|
+
}
|
|
152
|
+
if (hub.avatarColors !== undefined && typeof hub.avatarColors !== 'boolean') {
|
|
153
|
+
errors.push('hub.avatarColors must be true or false.');
|
|
154
|
+
}
|
|
155
|
+
if (hub.stuck !== undefined && typeof hub.stuck !== 'boolean') {
|
|
156
|
+
errors.push('hub.stuck must be true or false.');
|
|
157
|
+
}
|
|
158
|
+
if (hub.labels !== undefined && hub.labels !== 'near') {
|
|
159
|
+
errors.push('hub.labels must be "near" (or left out).');
|
|
160
|
+
}
|
|
161
|
+
if (hub.interest !== undefined && hub.interest !== 'cells') {
|
|
162
|
+
errors.push('hub.interest must be "cells" (or left out).');
|
|
163
|
+
}
|
|
164
|
+
let house = null;
|
|
165
|
+
if (hub.house !== undefined) {
|
|
166
|
+
if (!isObject(hub.house)) {
|
|
167
|
+
errors.push('hub.house must be an object of { devOwner: "first" }.');
|
|
168
|
+
} else {
|
|
169
|
+
unknownKeys(hub.house, ['devOwner'], 'hub.house', errors);
|
|
170
|
+
if (hub.house.devOwner !== 'first') {
|
|
171
|
+
errors.push('hub.house.devOwner must be "first".');
|
|
172
|
+
} else {
|
|
173
|
+
house = { devOwner: 'first' };
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
const soundscape = readSoundscape(hub.soundscape, errors);
|
|
178
|
+
const unlocks = readUnlocks(hub.unlocks, errors);
|
|
86
179
|
const defaultScene =
|
|
87
180
|
typeof castleJson?.editor?.defaultPlayFile === 'string' ? castleJson.editor.defaultPlayFile : DEFAULT_SCENE;
|
|
88
181
|
const serverMax = Number.isInteger(castleJson?.server?.maxPlayers) ? castleJson.server.maxPlayers : MAX_PLAYERS_CAP;
|
|
@@ -90,7 +183,9 @@ export function readManifest(castleJson, sceneExists = () => true) {
|
|
|
90
183
|
const bundle = castleJson?.characterBundle ?? null;
|
|
91
184
|
|
|
92
185
|
const places = {};
|
|
93
|
-
places[MAIN_PLACE] = readPlace(hub, 'hub', defaultScene, serverMax, sceneExists, errors, destinations, bundle);
|
|
186
|
+
places[MAIN_PLACE] = readPlace(hub, 'hub', defaultScene, serverMax, sceneExists, errors, destinations, bundle, hub.interest);
|
|
187
|
+
// v1.68: whether any place declares the choice card (only the key is read).
|
|
188
|
+
let ballot = Boolean(places[MAIN_PLACE].ballot);
|
|
94
189
|
if (hub.places !== undefined) {
|
|
95
190
|
if (!isObject(hub.places)) {
|
|
96
191
|
errors.push('hub.places must be an object of place id -> place.');
|
|
@@ -106,14 +201,124 @@ export function readManifest(castleJson, sceneExists = () => true) {
|
|
|
106
201
|
continue;
|
|
107
202
|
}
|
|
108
203
|
unknownKeys(block, PLACE_KEYS, where, errors);
|
|
109
|
-
places[id] = readPlace(block, where, null, serverMax, sceneExists, errors, destinations, bundle);
|
|
204
|
+
places[id] = readPlace(block, where, null, serverMax, sceneExists, errors, destinations, bundle, hub.interest);
|
|
205
|
+
ballot ||= Boolean(places[id].ballot);
|
|
110
206
|
}
|
|
111
207
|
}
|
|
112
208
|
}
|
|
113
|
-
return errors.length ? { errors, manifest: null } : { errors, manifest: { contract: CONTRACT_VERSION, places } };
|
|
209
|
+
return errors.length ? { errors, manifest: null } : { errors, manifest: { contract: CONTRACT_VERSION, cues: hub.cues === true, ...(hub.yourGames === true ? { yourGames: true } : {}), ...(hub.avatarColors === true ? { avatarColors: true } : {}), ...(hub.stuck === true ? { stuck: true } : {}), ...(soundscape ? { soundscape } : {}), ...(unlocks ? { unlocks } : {}), ...(house ? { house } : {}), ...(ballot ? { ballot: true } : {}), places } };
|
|
114
210
|
}
|
|
115
211
|
|
|
116
|
-
|
|
212
|
+
// `hub.soundscape`: its parts where it is on, null where it is left out or
|
|
213
|
+
// false. New fields are never filled into a boolean deck's manifest.
|
|
214
|
+
function readSoundscape(value, errors) {
|
|
215
|
+
if (value === undefined || value === false) {
|
|
216
|
+
return null;
|
|
217
|
+
}
|
|
218
|
+
if (value === true) {
|
|
219
|
+
return { babble: true, steps: true };
|
|
220
|
+
}
|
|
221
|
+
if (!isObject(value)) {
|
|
222
|
+
errors.push('hub.soundscape must be true, false or an object of { babble, steps, zones, ambience, ui, cues }.');
|
|
223
|
+
return null;
|
|
224
|
+
}
|
|
225
|
+
unknownKeys(value, SOUNDSCAPE_KEYS, 'hub.soundscape', errors);
|
|
226
|
+
if (value.babble !== undefined && typeof value.babble !== 'boolean') {
|
|
227
|
+
errors.push('hub.soundscape.babble must be true or false.');
|
|
228
|
+
}
|
|
229
|
+
const out = { babble: value.babble !== false, steps: value.steps !== false };
|
|
230
|
+
if (value.cues !== undefined) {
|
|
231
|
+
if (typeof value.cues !== 'boolean') {
|
|
232
|
+
errors.push('hub.soundscape.cues must be true or false.');
|
|
233
|
+
} else {
|
|
234
|
+
out.cues = value.cues;
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
if (value.ui !== undefined) {
|
|
238
|
+
if (typeof value.ui !== 'boolean') {
|
|
239
|
+
errors.push('hub.soundscape.ui must be true or false.');
|
|
240
|
+
} else {
|
|
241
|
+
out.ui = value.ui;
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
const component = (name, where) => {
|
|
245
|
+
if (typeof name !== 'string' || !/^[A-Za-z][A-Za-z0-9_]*$/.test(name)) {
|
|
246
|
+
errors.push(`${where} must be a component name.`);
|
|
247
|
+
}
|
|
248
|
+
};
|
|
249
|
+
const named = (name, names, where) => {
|
|
250
|
+
if (!names.includes(name)) {
|
|
251
|
+
errors.push(`${where} must be one of ${names.join(', ')}.`);
|
|
252
|
+
}
|
|
253
|
+
};
|
|
254
|
+
const map = (entries, names, where, components = false) => {
|
|
255
|
+
if (!isObject(entries)) {
|
|
256
|
+
errors.push(`${where} must be an object.`);
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
for (const [id, name] of Object.entries(entries)) {
|
|
260
|
+
if (!id.trim()) {
|
|
261
|
+
errors.push(`${where} needs a non-empty actor id.`);
|
|
262
|
+
}
|
|
263
|
+
if (components) {
|
|
264
|
+
component(id, `${where}.${id}`);
|
|
265
|
+
}
|
|
266
|
+
named(name, names, `${where}.${id}`);
|
|
267
|
+
}
|
|
268
|
+
};
|
|
269
|
+
if (value.zones !== undefined) {
|
|
270
|
+
component(value.zones, 'hub.soundscape.zones');
|
|
271
|
+
out.zones = value.zones;
|
|
272
|
+
}
|
|
273
|
+
if (value.steps !== undefined && typeof value.steps !== 'boolean') {
|
|
274
|
+
if (!isObject(value.steps)) {
|
|
275
|
+
errors.push('hub.soundscape.steps must be true or false or an object.');
|
|
276
|
+
} else {
|
|
277
|
+
const steps = value.steps;
|
|
278
|
+
unknownKeys(steps, ['default', 'zones', 'paths'], 'hub.soundscape.steps', errors);
|
|
279
|
+
if (steps.default !== undefined) {
|
|
280
|
+
named(steps.default, SOUNDSCAPE_SURFACES, 'hub.soundscape.steps.default');
|
|
281
|
+
}
|
|
282
|
+
if (steps.zones !== undefined) {
|
|
283
|
+
map(steps.zones, SOUNDSCAPE_SURFACES, 'hub.soundscape.steps.zones');
|
|
284
|
+
if (value.zones === undefined) {
|
|
285
|
+
errors.push('hub.soundscape.steps.zones needs hub.soundscape.zones.');
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
if (steps.paths !== undefined) {
|
|
289
|
+
component(steps.paths, 'hub.soundscape.steps.paths');
|
|
290
|
+
}
|
|
291
|
+
out.steps = { ...steps };
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
if (value.ambience !== undefined) {
|
|
295
|
+
if (!isObject(value.ambience)) {
|
|
296
|
+
errors.push('hub.soundscape.ambience must be an object.');
|
|
297
|
+
} else {
|
|
298
|
+
const ambience = value.ambience;
|
|
299
|
+
unknownKeys(ambience, ['beds', 'default', 'spots', 'music'], 'hub.soundscape.ambience', errors);
|
|
300
|
+
if (ambience.default !== undefined) {
|
|
301
|
+
named(ambience.default, SOUNDSCAPE_BEDS, 'hub.soundscape.ambience.default');
|
|
302
|
+
}
|
|
303
|
+
if (ambience.beds !== undefined) {
|
|
304
|
+
map(ambience.beds, SOUNDSCAPE_BEDS, 'hub.soundscape.ambience.beds');
|
|
305
|
+
if (value.zones === undefined) {
|
|
306
|
+
errors.push('hub.soundscape.ambience.beds needs hub.soundscape.zones.');
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
if (ambience.spots !== undefined) {
|
|
310
|
+
map(ambience.spots, SOUNDSCAPE_BEDS, 'hub.soundscape.ambience.spots', true);
|
|
311
|
+
}
|
|
312
|
+
if (ambience.music !== undefined && typeof ambience.music !== 'boolean') {
|
|
313
|
+
errors.push('hub.soundscape.ambience.music must be true or false.');
|
|
314
|
+
}
|
|
315
|
+
out.ambience = { ...ambience };
|
|
316
|
+
}
|
|
317
|
+
}
|
|
318
|
+
return out;
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, destinations, bundle, interest) {
|
|
117
322
|
const place = {};
|
|
118
323
|
|
|
119
324
|
place.title = typeof block.title === 'string' ? block.title.trim() : '';
|
|
@@ -154,12 +359,16 @@ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, d
|
|
|
154
359
|
|
|
155
360
|
place.nearestPlayers = intIn(
|
|
156
361
|
block.nearestPlayers,
|
|
157
|
-
NEAREST_PLAYERS,
|
|
362
|
+
interest === 'cells' ? NEAREST_PLAYERS_CELLS : NEAREST_PLAYERS,
|
|
158
363
|
1,
|
|
159
364
|
NEAREST_PLAYERS_CAP,
|
|
160
365
|
`${where}.nearestPlayers`,
|
|
161
366
|
errors,
|
|
162
367
|
);
|
|
368
|
+
if (interest === 'cells') {
|
|
369
|
+
place.interest = interest;
|
|
370
|
+
place.nearestPlayersFallback = block.nearestPlayers ?? NEAREST_PLAYERS;
|
|
371
|
+
}
|
|
163
372
|
place.arrival = readArrival(block.arrival, `${where}.arrival`, errors);
|
|
164
373
|
place.result = block.result === undefined ? null : readResult(block.result, `${where}.result`, errors);
|
|
165
374
|
// A game has a longest visit; a place with no result (a town) has none
|
|
@@ -187,9 +396,181 @@ function readPlace(block, where, defaultScene, serverMax, sceneExists, errors, d
|
|
|
187
396
|
if (idle) {
|
|
188
397
|
place.idle = idle;
|
|
189
398
|
}
|
|
399
|
+
// v1.26: the HUD's layout, likewise carried only by a place that asks.
|
|
400
|
+
const hud = readHud(block.hud, `${where}.hud`, errors);
|
|
401
|
+
if (hud) {
|
|
402
|
+
place.hud = hud;
|
|
403
|
+
}
|
|
404
|
+
const decor = readDecor(block.decor, `${where}.decor`, errors);
|
|
405
|
+
if (decor) {
|
|
406
|
+
place.decor = decor;
|
|
407
|
+
}
|
|
408
|
+
if (Object.hasOwn(block, 'visibility')) {
|
|
409
|
+
if (block.visibility !== true) {
|
|
410
|
+
errors.push(`${where}.visibility must be true or absent.`);
|
|
411
|
+
} else {
|
|
412
|
+
place.visibility = true;
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
if (Object.hasOwn(block, 'actions')) {
|
|
416
|
+
if (block.actions !== true) {
|
|
417
|
+
errors.push(`${where}.actions must be true or absent.`);
|
|
418
|
+
} else {
|
|
419
|
+
place.actions = true;
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
if (Object.hasOwn(block, 'companion')) {
|
|
423
|
+
if (block.companion === true) {
|
|
424
|
+
place.companion = true;
|
|
425
|
+
} else if (isObject(block.companion)) {
|
|
426
|
+
const value = block.companion, chat = value.chat;
|
|
427
|
+
unknownKeys(value, ['chat'], `${where}.companion`, errors);
|
|
428
|
+
if (!isObject(chat)) {
|
|
429
|
+
errors.push(`${where}.companion.chat must be an object.`);
|
|
430
|
+
} else {
|
|
431
|
+
unknownKeys(chat, ['character', 'name'], `${where}.companion.chat`, errors);
|
|
432
|
+
// The character API accepts non-empty ids up to 100 characters / 128 bytes.
|
|
433
|
+
if (
|
|
434
|
+
typeof chat.character !== 'string' || !chat.character.trim() || chat.character.length > 100 || chat.character.includes('\0') ||
|
|
435
|
+
/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/.test(chat.character) ||
|
|
436
|
+
new TextEncoder().encode(chat.character).length > 128 ||
|
|
437
|
+
!Array.isArray(bundle?.characters) || !bundle.characters.some((c) => c?.id === chat.character)
|
|
438
|
+
) {
|
|
439
|
+
errors.push(`${where}.companion.chat.character must name a character id in characterBundle (1..100 characters, at most 128 bytes).`);
|
|
440
|
+
}
|
|
441
|
+
if (typeof chat.name !== 'string' || !chat.name.trim() || Array.from(chat.name).length > 24 || /[\u0000-\u001f\u007f-\u009f]/.test(chat.name)) {
|
|
442
|
+
errors.push(`${where}.companion.chat.name must be 1..24 characters without control characters.`);
|
|
443
|
+
}
|
|
444
|
+
place.companion = true;
|
|
445
|
+
place.companionChat = { character: chat.character, name: chat.name };
|
|
446
|
+
}
|
|
447
|
+
if (!place.npcs) {
|
|
448
|
+
errors.push(`${where}.companion.chat needs npcs configured with a mind slot.`);
|
|
449
|
+
}
|
|
450
|
+
} else {
|
|
451
|
+
errors.push(`${where}.companion must be true, an object with chat, or absent.`);
|
|
452
|
+
}
|
|
453
|
+
}
|
|
454
|
+
// v1.72: a game that handles a player's return within a round asks to have
|
|
455
|
+
// them arrived again (`hello`, `greetLate`). Carried only when true.
|
|
456
|
+
if (Object.hasOwn(block, 'resume')) {
|
|
457
|
+
const keep = isObject(block.resume) && block.resume.keep === true;
|
|
458
|
+
if (block.resume !== true && !keep) {
|
|
459
|
+
errors.push(`${where}.resume must be true or absent, or { keep: true }.`);
|
|
460
|
+
} else if (!place.result) {
|
|
461
|
+
errors.push(`${where}.resume is only for a place with a result.`);
|
|
462
|
+
} else {
|
|
463
|
+
place.resume = true;
|
|
464
|
+
if (keep) {
|
|
465
|
+
unknownKeys(block.resume, ['keep'], `${where}.resume`, errors);
|
|
466
|
+
place.resumeKeep = true;
|
|
467
|
+
}
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
if (Object.hasOwn(block, 'ask')) {
|
|
471
|
+
if (block.ask !== true) {
|
|
472
|
+
errors.push(`${where}.ask must be true or absent.`);
|
|
473
|
+
} else {
|
|
474
|
+
place.ask = true;
|
|
475
|
+
}
|
|
476
|
+
}
|
|
477
|
+
if (Object.hasOwn(block, 'menu')) {
|
|
478
|
+
if (block.menu !== true) {
|
|
479
|
+
errors.push(`${where}.menu must be true or absent.`);
|
|
480
|
+
} else {
|
|
481
|
+
place.menu = true;
|
|
482
|
+
}
|
|
483
|
+
}
|
|
484
|
+
// v1.68: the choice card, likewise carried only by a place that declares it.
|
|
485
|
+
if (block.ballot !== undefined) {
|
|
486
|
+
const ballot = readBallot(block.ballot, `${where}.ballot`, errors);
|
|
487
|
+
if (ballot) {
|
|
488
|
+
place.ballot = ballot;
|
|
489
|
+
}
|
|
490
|
+
}
|
|
190
491
|
return place;
|
|
191
492
|
}
|
|
192
493
|
|
|
494
|
+
// Words of the deck's own on the card: trimmed, 1-`max` characters, one line
|
|
495
|
+
// (no control characters). The text, or null.
|
|
496
|
+
export function cardText(value, max) {
|
|
497
|
+
if (typeof value !== 'string') {
|
|
498
|
+
return null;
|
|
499
|
+
}
|
|
500
|
+
const text = value.trim();
|
|
501
|
+
if (!text || text.length > max || [...text].some((c) => c.charCodeAt(0) < 32 || c.charCodeAt(0) === 127)) {
|
|
502
|
+
return null;
|
|
503
|
+
}
|
|
504
|
+
return text;
|
|
505
|
+
}
|
|
506
|
+
|
|
507
|
+
// `ballot`: absent or false is none; true is the card with no lines (faces
|
|
508
|
+
// and options only); an object lists the deck's fixed lines, each
|
|
509
|
+
// `{ id, text, about }`, `about` "face" (said about a player whose face is
|
|
510
|
+
// tapped first) or "self".
|
|
511
|
+
function readBallot(value, where, errors) {
|
|
512
|
+
if (value === undefined || value === false) {
|
|
513
|
+
return null;
|
|
514
|
+
}
|
|
515
|
+
if (value === true) {
|
|
516
|
+
return { lines: [] };
|
|
517
|
+
}
|
|
518
|
+
if (!isObject(value)) {
|
|
519
|
+
errors.push(`${where} must be true, false or an object.`);
|
|
520
|
+
return null;
|
|
521
|
+
}
|
|
522
|
+
unknownKeys(value, ['lines'], where, errors);
|
|
523
|
+
if (value.lines === undefined) {
|
|
524
|
+
return { lines: [] };
|
|
525
|
+
}
|
|
526
|
+
if (!Array.isArray(value.lines) || value.lines.length > BALLOT_MAX_LINES) {
|
|
527
|
+
errors.push(`${where}.lines must be a list of at most ${BALLOT_MAX_LINES} lines.`);
|
|
528
|
+
return null;
|
|
529
|
+
}
|
|
530
|
+
const lines = [];
|
|
531
|
+
const seen = new Set();
|
|
532
|
+
value.lines.forEach((line, i) => {
|
|
533
|
+
const at = `${where}.lines[${i}]`;
|
|
534
|
+
if (!isObject(line)) {
|
|
535
|
+
errors.push(`${at} must be an object { id, text, about }.`);
|
|
536
|
+
return;
|
|
537
|
+
}
|
|
538
|
+
unknownKeys(line, ['id', 'text', 'about'], at, errors);
|
|
539
|
+
const text = cardText(line.text, BALLOT_LINE_MAX);
|
|
540
|
+
if (typeof line.id !== 'string' || !BALLOT_LINE_ID.test(line.id)) {
|
|
541
|
+
errors.push(`${at}.id must be [a-z0-9-], 1-24 characters.`);
|
|
542
|
+
} else if (seen.has(line.id)) {
|
|
543
|
+
errors.push(`${at}.id "${line.id}" is listed twice.`);
|
|
544
|
+
} else if (text === null) {
|
|
545
|
+
errors.push(`${at}.text must be 1-${BALLOT_LINE_MAX} characters on one line.`);
|
|
546
|
+
} else if (!BALLOT_ABOUT.includes(line.about)) {
|
|
547
|
+
errors.push(`${at}.about must be "face" or "self".`);
|
|
548
|
+
} else {
|
|
549
|
+
seen.add(line.id);
|
|
550
|
+
lines.push({ id: line.id, text, about: line.about });
|
|
551
|
+
}
|
|
552
|
+
});
|
|
553
|
+
return { lines };
|
|
554
|
+
}
|
|
555
|
+
|
|
556
|
+
// `hud`: absent is none; an object turns each option on by name. `clear:
|
|
557
|
+
// false` (and an empty object) is the same as leaving it out.
|
|
558
|
+
function readHud(value, where, errors) {
|
|
559
|
+
if (value === undefined) {
|
|
560
|
+
return null;
|
|
561
|
+
}
|
|
562
|
+
if (!isObject(value)) {
|
|
563
|
+
errors.push(`${where} must be an object.`);
|
|
564
|
+
return null;
|
|
565
|
+
}
|
|
566
|
+
unknownKeys(value, HUD_KEYS, where, errors);
|
|
567
|
+
if (value.clear !== undefined && typeof value.clear !== 'boolean') {
|
|
568
|
+
errors.push(`${where}.clear must be true or false.`);
|
|
569
|
+
return null;
|
|
570
|
+
}
|
|
571
|
+
return value.clear === true ? { clear: true } : null;
|
|
572
|
+
}
|
|
573
|
+
|
|
193
574
|
// `grab`: absent or false is none; true is the defaults; an object sets any of
|
|
194
575
|
// them, and may add `reach` and `steady` (v1.22), which are kept only when
|
|
195
576
|
// set: `steady: false` is the same as leaving it out.
|
|
@@ -229,6 +610,11 @@ function readGrab(value, where, errors) {
|
|
|
229
610
|
} else if (value.steady === true) {
|
|
230
611
|
grab.steady = true;
|
|
231
612
|
}
|
|
613
|
+
if (value.keepHeld !== undefined && typeof value.keepHeld !== 'boolean') {
|
|
614
|
+
errors.push(`${where}.keepHeld must be true or false.`);
|
|
615
|
+
} else if (value.keepHeld === true) {
|
|
616
|
+
grab.keepHeld = true;
|
|
617
|
+
}
|
|
232
618
|
return grab;
|
|
233
619
|
}
|
|
234
620
|
|
|
@@ -285,6 +671,19 @@ export function isSoundPath(path) {
|
|
|
285
671
|
);
|
|
286
672
|
}
|
|
287
673
|
|
|
674
|
+
// Shared by manifest parsing, scene checks and body setup. One slot is the
|
|
675
|
+
// original contract and is never added to the stored manifest or the wire.
|
|
676
|
+
export function readNpcTurnsAtOnce(value, fallback = 1, where = 'HubNpc.turnsAtOnce', errors = []) {
|
|
677
|
+
if (value === undefined) {
|
|
678
|
+
return fallback;
|
|
679
|
+
}
|
|
680
|
+
if (!Number.isInteger(value) || value < 1 || value > 3) {
|
|
681
|
+
errors.push(`${where} must be an integer from 1 to 3.`);
|
|
682
|
+
return fallback;
|
|
683
|
+
}
|
|
684
|
+
return value;
|
|
685
|
+
}
|
|
686
|
+
|
|
288
687
|
// Where a place's NPC minds live (§13): the place itself (every layer talks
|
|
289
688
|
// to ghost's one place mind), optionally a destination route whose world an
|
|
290
689
|
// older SDK joins instead, and how much conversation each character takes.
|
|
@@ -293,7 +692,7 @@ function readNpcs(value, destinations, bundle, where, errors) {
|
|
|
293
692
|
errors.push(`${where} must be an object.`);
|
|
294
693
|
return null;
|
|
295
694
|
}
|
|
296
|
-
unknownKeys(value, ['route', 'slot', 'turnsPerMinute', 'disclosure', 'followSec'], where, errors);
|
|
695
|
+
unknownKeys(value, ['route', 'slot', 'turnsPerMinute', 'turnsAtOnce', 'disclosure', 'followSec'], where, errors);
|
|
297
696
|
const npcs = { route: null, slot: 'main', turnsPerMinute: 6, disclosure: 'participants', followSec: 120 };
|
|
298
697
|
// A route is optional: without one the minds are the place's (ghost's place
|
|
299
698
|
// mind, reached from every layer); with one, an SDK that cannot address the
|
|
@@ -323,6 +722,10 @@ function readNpcs(value, destinations, bundle, where, errors) {
|
|
|
323
722
|
}
|
|
324
723
|
}
|
|
325
724
|
npcs.turnsPerMinute = intIn(value.turnsPerMinute, 6, 1, 30, `${where}.turnsPerMinute`, errors);
|
|
725
|
+
const turnsAtOnce = readNpcTurnsAtOnce(value.turnsAtOnce, 1, `${where}.turnsAtOnce`, errors);
|
|
726
|
+
if (turnsAtOnce > 1) {
|
|
727
|
+
npcs.turnsAtOnce = turnsAtOnce;
|
|
728
|
+
}
|
|
326
729
|
npcs.followSec = intIn(value.followSec, 120, 10, 600, `${where}.followSec`, errors);
|
|
327
730
|
if (value.disclosure !== undefined) {
|
|
328
731
|
// Read for decks that set it, and no longer acted on (v1.17): a player's
|
|
@@ -518,12 +921,25 @@ export function publicPlace(id, place) {
|
|
|
518
921
|
title: place.title,
|
|
519
922
|
scene: place.scene,
|
|
520
923
|
controller: place.controller,
|
|
924
|
+
...(place.interest ? { interest: place.interest, nearestPlayers: place.nearestPlayers } : {}),
|
|
521
925
|
maxDurationSec: place.maxDurationSec,
|
|
522
926
|
// v1.3: the hub chrome offers Grab only where this is set; a place
|
|
523
927
|
// without it is sent exactly what it was.
|
|
524
928
|
...(place.grab ? { grab: { ...place.grab } } : {}),
|
|
525
929
|
// v1.6: likewise idle play.
|
|
526
930
|
...(place.idle ? { idle: { emotes: place.idle.emotes, seats: place.idle.seats, sounds: [...place.idle.sounds] } } : {}),
|
|
931
|
+
// v1.26: likewise the HUD's layout.
|
|
932
|
+
...(place.hud ? { hud: { ...place.hud } } : {}),
|
|
933
|
+
...(place.decor ? { decor: place.decor } : {}),
|
|
934
|
+
...(place.visibility === true ? { visibility: true } : {}),
|
|
935
|
+
...(place.actions === true ? { actions: true } : {}),
|
|
936
|
+
...(place.companion === true ? { companion: true } : {}),
|
|
937
|
+
...(place.companionChat ? { companionChat: { name: place.companionChat.name } } : {}),
|
|
938
|
+
...(place.resume === true ? { resume: true } : {}),
|
|
939
|
+
...(place.ask === true ? { ask: true } : {}),
|
|
940
|
+
...(place.menu === true ? { menu: true } : {}),
|
|
941
|
+
// v1.68: likewise the choice card's lines, worded by the client from ids.
|
|
942
|
+
...(place.ballot ? { ballot: { lines: place.ballot.lines.map((line) => ({ ...line })) } } : {}),
|
|
527
943
|
result: place.result
|
|
528
944
|
? { score: place.result.score ? { unit: place.result.score.unit, better: place.result.score.better } : null }
|
|
529
945
|
: null,
|