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
|
@@ -15,6 +15,22 @@
|
|
|
15
15
|
// saves the traversal and matrix work as well as the draw. Nothing here
|
|
16
16
|
// touches colliders, physics, the network, labels or anything another player
|
|
17
17
|
// sees: it is this client's picture only.
|
|
18
|
+
// A deck may mark an actor in its scene file `"tier": "keep"` (beside `id`,
|
|
19
|
+
// not a component): it is drawn on every tier, whatever it would be called
|
|
20
|
+
// here -- a place's ground is often plain Transform/Shape/Model, and a place
|
|
21
|
+
// drawn without it stands on nothing. `"tier": "near"` instead treats a non-NPC
|
|
22
|
+
// actor as scenery on Low, whatever its components: drawn within 30 m of its
|
|
23
|
+
// bounds, taken out beyond that. High draws it as authored; NPCs keep their
|
|
24
|
+
// own distance rule, and keep always wins over distance. `"tier": "low"`
|
|
25
|
+
// draws only on Low, at any distance; High takes its node out instead.
|
|
26
|
+
// Low also draws no kit sky (`engine.sky`): while Low the runtime's `sky`
|
|
27
|
+
// reads null (`skyOff` below), so the engine makes no dome and uploads no art.
|
|
28
|
+
// A scene file may also carry visibility cells (`readCells` below): on Low an
|
|
29
|
+
// actor tagged with cells the camera's cell cannot see is not drawn, `keep`
|
|
30
|
+
// or not -- keep is about distance, a cell about what is in the way.
|
|
31
|
+
// Actors the place hides for this viewer are also taken out on Low, whatever
|
|
32
|
+
// their mark or components, except Player/avatar roots. High keeps the
|
|
33
|
+
// existing underground visibility path alone.
|
|
18
34
|
//
|
|
19
35
|
// Where a device starts: low if it was found slow here in the last week
|
|
20
36
|
// (remembered in localStorage), or its GPU or memory says it is a weak phone;
|
|
@@ -23,6 +39,7 @@
|
|
|
23
39
|
// over all of it.
|
|
24
40
|
|
|
25
41
|
import { Box3, Sphere } from 'three';
|
|
42
|
+
import { hub, deck } from './state.js';
|
|
26
43
|
|
|
27
44
|
export const TIERS = ['low', 'high'];
|
|
28
45
|
export const MODES = ['auto', 'low', 'high'];
|
|
@@ -169,6 +186,15 @@ const GAMEPLAY = /^Hub|^Town|^Body$|^Ball$|^Player$/;
|
|
|
169
186
|
const DECOR = new Set(['Transform', 'Shape', 'Model']);
|
|
170
187
|
const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
|
|
171
188
|
|
|
189
|
+
// The mark a scene file puts on an actor (`"tier": "keep"`, a field of the
|
|
190
|
+
// actor beside `id`) to have it drawn on every tier whatever `classify` says
|
|
191
|
+
// of it. `"tier": "near"` makes a non-NPC actor scenery on Low (the sized
|
|
192
|
+
// 30 m test), whatever its components. `"tier": "low"` is drawn only on Low,
|
|
193
|
+
// exempt from distance/decor there. Other values are no mark.
|
|
194
|
+
export const KEEP = 'keep';
|
|
195
|
+
export const NEAR = 'near';
|
|
196
|
+
export const LOW = 'low';
|
|
197
|
+
|
|
172
198
|
export function classify(components) {
|
|
173
199
|
const names = Object.keys(components ?? {});
|
|
174
200
|
// physics-3d makes an actor's collider block when it has `Solid` or its
|
|
@@ -187,6 +213,154 @@ export function classify(components) {
|
|
|
187
213
|
return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
|
|
188
214
|
}
|
|
189
215
|
|
|
216
|
+
// Visibility cells: a scene file may cut its ground into cells and say, for
|
|
217
|
+
// each, which cells can be seen from somewhere in it (a top-level `cells`
|
|
218
|
+
// key beside `engine` and `actors`; experiments/hub-town town_cells.py
|
|
219
|
+
// writes the 4x world's), and tag still actors with the cell their footprint
|
|
220
|
+
// is in (`"cell": "n-plaza"`, or a list when it spans several, beside `id`
|
|
221
|
+
// like `tier`). On Low an actor none of whose cells is seen from the
|
|
222
|
+
// camera's cell is taken out, wherever it is and whatever else is said of it:
|
|
223
|
+
// it is behind buildings, so the distance rules and `keep` do not apply. The
|
|
224
|
+
// table is read strictly: anything off and there is no table, and the scene
|
|
225
|
+
// is drawn as it would be without one.
|
|
226
|
+
export const CELLS_VERSION = 1;
|
|
227
|
+
// Which tagged actors the cells may take out, by an invariant: an actor is
|
|
228
|
+
// out for its cell only if (i) none of its components reacts to a player or
|
|
229
|
+
// the server (an interaction, a pad, a door, a seat, a wardrobe, a shop, a
|
|
230
|
+
// label writer, a mover, a body), (ii) nothing moves it, and (iii) that is
|
|
231
|
+
// decided again from its components every time it is needed, never
|
|
232
|
+
// remembered by id: the engine may replace an actor under the same id (a
|
|
233
|
+
// Body, a HubDoor) and the scene may add a component while playing.
|
|
234
|
+
// So: every component of the actor as it is now is one of CELL_INERT --
|
|
235
|
+
// a Lookable's words are read from the scene data by the client whether or
|
|
236
|
+
// not the node is drawn, and RouteAnchor and WalkSurface are data -- and
|
|
237
|
+
// none is CELL_PROTECTED, a backstop for what a player must see to find their
|
|
238
|
+
// way or play. An actor with no components, or none to be found, is drawn.
|
|
239
|
+
// Taking a node out stops its drawing and nothing else.
|
|
240
|
+
export const CELL_INERT = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable', 'RouteAnchor', 'WalkSurface']);
|
|
241
|
+
export const CELL_PROTECTED = new Set([
|
|
242
|
+
'HubDoor',
|
|
243
|
+
'HubPad',
|
|
244
|
+
'HubNpc',
|
|
245
|
+
'Body',
|
|
246
|
+
'Player',
|
|
247
|
+
'Ball',
|
|
248
|
+
'HubSpin',
|
|
249
|
+
'TownHats',
|
|
250
|
+
'TownStamp',
|
|
251
|
+
'TownHatMat',
|
|
252
|
+
'TownWardrobeMat',
|
|
253
|
+
'TownWardrobeItem',
|
|
254
|
+
'TownWardrobe',
|
|
255
|
+
]);
|
|
256
|
+
|
|
257
|
+
// Whether an actor's current components let the cells take it out.
|
|
258
|
+
export function cellInert(components) {
|
|
259
|
+
const names = components && typeof components === 'object' ? Object.keys(components) : [];
|
|
260
|
+
return names.length > 0 && names.every((name) => CELL_INERT.has(name) && !CELL_PROTECTED.has(name));
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
const finitePair = (p) => Array.isArray(p) && p.length === 2 && Number.isFinite(p[0]) && Number.isFinite(p[1]);
|
|
264
|
+
|
|
265
|
+
// The scene file's `cells` key as { eyeMax, hysteresis, cells: [{ id,
|
|
266
|
+
// outline, sees: Set }], byId }, or null when it is absent or malformed.
|
|
267
|
+
export function readCells(value) {
|
|
268
|
+
if (!value || typeof value !== 'object' || value.version !== CELLS_VERSION || !Array.isArray(value.cells) || !value.cells.length) {
|
|
269
|
+
return null;
|
|
270
|
+
}
|
|
271
|
+
if (!Number.isFinite(value.eyeMax) || !Number.isFinite(value.hysteresis) || value.hysteresis < 0) {
|
|
272
|
+
return null;
|
|
273
|
+
}
|
|
274
|
+
const byId = new Map();
|
|
275
|
+
for (const c of value.cells) {
|
|
276
|
+
if (!c || typeof c.id !== 'string' || !c.id || byId.has(c.id)) {
|
|
277
|
+
return null;
|
|
278
|
+
}
|
|
279
|
+
if (!Array.isArray(c.outline) || c.outline.length < 3 || !c.outline.every(finitePair) || !Array.isArray(c.sees)) {
|
|
280
|
+
return null;
|
|
281
|
+
}
|
|
282
|
+
byId.set(c.id, { id: c.id, outline: c.outline.map(([x, z]) => [x, z]), sees: c.sees });
|
|
283
|
+
}
|
|
284
|
+
for (const c of byId.values()) {
|
|
285
|
+
// A row that does not see itself is a mistake in the table, not a cell
|
|
286
|
+
// whose own ground is hidden: no table.
|
|
287
|
+
if (!c.sees.includes(c.id) || !c.sees.every((id) => typeof id === 'string' && byId.has(id))) {
|
|
288
|
+
return null;
|
|
289
|
+
}
|
|
290
|
+
c.sees = new Set(c.sees);
|
|
291
|
+
}
|
|
292
|
+
return { eyeMax: value.eyeMax, hysteresis: value.hysteresis, cells: [...byId.values()], byId };
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
// An actor's `cell` field as a list of the table's ids, or null: a string or
|
|
296
|
+
// a non-empty list of strings, every one a cell of the table. Anything else
|
|
297
|
+
// is no cell, and the actor is never taken out for it.
|
|
298
|
+
export function actorCells(value, table) {
|
|
299
|
+
const list = typeof value === 'string' ? [value] : value;
|
|
300
|
+
if (!table || !Array.isArray(list) || !list.length) {
|
|
301
|
+
return null;
|
|
302
|
+
}
|
|
303
|
+
return list.every((id) => typeof id === 'string' && table.byId.has(id)) ? list : null;
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
export function insideOutline(outline, x, z) {
|
|
307
|
+
let inside = false;
|
|
308
|
+
for (let i = 0, j = outline.length - 1; i < outline.length; j = i++) {
|
|
309
|
+
const [xi, zi] = outline[i];
|
|
310
|
+
const [xj, zj] = outline[j];
|
|
311
|
+
if (zi > z !== zj > z && x < ((xj - xi) * (z - zi)) / (zj - zi) + xi) {
|
|
312
|
+
inside = !inside;
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
return inside;
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
// How far a point is from an outline's nearest edge.
|
|
319
|
+
export function outlineDistance(outline, x, z) {
|
|
320
|
+
let best = Infinity;
|
|
321
|
+
for (let i = 0, j = outline.length - 1; i < outline.length; j = i++) {
|
|
322
|
+
const [ax, az] = outline[j];
|
|
323
|
+
const [bx, bz] = outline[i];
|
|
324
|
+
const dx = bx - ax;
|
|
325
|
+
const dz = bz - az;
|
|
326
|
+
const len = dx * dx + dz * dz;
|
|
327
|
+
const t = len > 0 ? Math.max(0, Math.min(1, ((x - ax) * dx + (z - az) * dz) / len)) : 0;
|
|
328
|
+
best = Math.min(best, Math.hypot(ax + t * dx - x, az + t * dz - z));
|
|
329
|
+
}
|
|
330
|
+
return best;
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
// The cell the eye at (x, z) is in, given the one it was in. Outside every
|
|
334
|
+
// outline, and at no finite place, there is no cell (null), first and
|
|
335
|
+
// whatever the hysteresis: the cells hide nothing rather than keep hiding
|
|
336
|
+
// what a cell the eye has left could not see. Inside some outline, the cell
|
|
337
|
+
// it was in is kept while the eye is inside it or within the table's
|
|
338
|
+
// hysteresis of it, so a border walked along does not flicker; otherwise the
|
|
339
|
+
// cell whose outline holds the eye.
|
|
340
|
+
export function eyeCell(table, current, x, z) {
|
|
341
|
+
if (!Number.isFinite(x) || !Number.isFinite(z)) {
|
|
342
|
+
return null;
|
|
343
|
+
}
|
|
344
|
+
const was = current === null ? null : table.byId.get(current);
|
|
345
|
+
// The cell it was in first: inside it is the common case, one outline.
|
|
346
|
+
if (was && insideOutline(was.outline, x, z)) {
|
|
347
|
+
return current;
|
|
348
|
+
}
|
|
349
|
+
const holder = table.cells.find((c) => c !== was && insideOutline(c.outline, x, z));
|
|
350
|
+
if (!holder) {
|
|
351
|
+
return null;
|
|
352
|
+
}
|
|
353
|
+
return was && outlineDistance(was.outline, x, z) <= table.hysteresis ? current : holder.id;
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
function cellsDebugUrl() {
|
|
357
|
+
try {
|
|
358
|
+
return new URLSearchParams(globalThis.location?.search ?? '').get('hubcells') === '1';
|
|
359
|
+
} catch {
|
|
360
|
+
return false;
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
|
|
190
364
|
// A node's bounds once, as its middle's offset from the node's position and a
|
|
191
365
|
// radius: scenery does not change shape, and the offset follows a node the
|
|
192
366
|
// place moves (a hidden actor waits far below the ground).
|
|
@@ -213,13 +387,41 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
213
387
|
lights: new Set(),
|
|
214
388
|
// node -> the parent it was taken out of.
|
|
215
389
|
removed: new WeakMap(),
|
|
390
|
+
// The runtime whose `sky` reads null for Low (`skyOff`), or null.
|
|
391
|
+
skyOff: null,
|
|
392
|
+
// Shared model instances draw outside the actor graph: hide their
|
|
393
|
+
// detached Low-only root too, preserving its authored visibility.
|
|
394
|
+
visibility: new WeakMap(),
|
|
216
395
|
hidden: 0,
|
|
217
396
|
bounds: new WeakMap(),
|
|
218
397
|
// The authored actors of the scene playing: only these are ever hidden
|
|
219
|
-
// (never a player's avatar
|
|
398
|
+
// for scenery/cells (never a player's avatar or what they wear). The
|
|
399
|
+
// place's merged hidden set also takes out spawned non-player actors.
|
|
220
400
|
authored: null,
|
|
401
|
+
distances: null,
|
|
221
402
|
authoredFor: null,
|
|
403
|
+
// Of those, the ids marked `"tier": "keep"`: exempt from distance/decor.
|
|
404
|
+
// null when the file marks none.
|
|
405
|
+
kept: null,
|
|
406
|
+
// The ids marked `"tier": "near"`: scenery on Low, except NPCs.
|
|
407
|
+
near: null,
|
|
408
|
+
// The ids drawn only on Low, exempt from distance/decor there.
|
|
409
|
+
low: null,
|
|
222
410
|
seen: { path: undefined, nodes: null, size: -1 },
|
|
411
|
+
// The scene file's visibility cells (`readCells`) and, by actor id, the
|
|
412
|
+
// cells each authored actor is tagged with; null when the file has none.
|
|
413
|
+
cells: null,
|
|
414
|
+
actorCells: null,
|
|
415
|
+
// The rule on or off (the harness's A/B), the eye's cell (hysteresis
|
|
416
|
+
// keeps it), the cell the last look drew from (null: everything), how
|
|
417
|
+
// many nodes are out for cells alone, and the last change of cell.
|
|
418
|
+
cellsOn: true,
|
|
419
|
+
cell: null,
|
|
420
|
+
cellKey: null,
|
|
421
|
+
cellHidden: 0,
|
|
422
|
+
pop: null,
|
|
423
|
+
overlay: null,
|
|
424
|
+
debugUrl: undefined,
|
|
223
425
|
// The entries taken out on the last look, [actor id, entry]: the engine
|
|
224
426
|
// replaces an entry in the same map when an actor's look changes
|
|
225
427
|
// (world3d.js `ensureActorNode`), and the new node is drawn, so these are
|
|
@@ -228,14 +430,30 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
228
430
|
nextAt: 0,
|
|
229
431
|
};
|
|
230
432
|
|
|
433
|
+
const sleeping = new Set();
|
|
434
|
+
const wakeSleeping = () => {
|
|
435
|
+
for (const actor of sleeping) {delete actor.runtime.renderSleep;}
|
|
436
|
+
sleeping.clear();
|
|
437
|
+
};
|
|
231
438
|
const adopt = (world) => {
|
|
232
439
|
if (lv.world !== world) {
|
|
440
|
+
wakeSleeping();
|
|
233
441
|
// A new world: nothing changed on the old one is put back there.
|
|
234
442
|
lv.world = world;
|
|
235
443
|
lv.lights = new Set();
|
|
236
444
|
lv.removed = new WeakMap();
|
|
445
|
+
lv.visibility = new WeakMap();
|
|
237
446
|
lv.authored = null;
|
|
238
447
|
lv.authoredFor = null;
|
|
448
|
+
lv.kept = null;
|
|
449
|
+
lv.near = null;
|
|
450
|
+
lv.low = null;
|
|
451
|
+
lv.cells = null;
|
|
452
|
+
lv.actorCells = null;
|
|
453
|
+
lv.cell = null;
|
|
454
|
+
lv.cellKey = null;
|
|
455
|
+
lv.cellHidden = 0;
|
|
456
|
+
lv.pop = null;
|
|
239
457
|
lv.seen = { path: undefined, nodes: null, size: -1 };
|
|
240
458
|
lv.watch = [];
|
|
241
459
|
lv.nextAt = 0;
|
|
@@ -258,17 +476,66 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
258
476
|
if (lv.authoredFor === scene.data && lv.authored) {
|
|
259
477
|
return lv.authored;
|
|
260
478
|
}
|
|
479
|
+
wakeSleeping();
|
|
261
480
|
lv.authoredFor = scene.data;
|
|
481
|
+
const ids = new Set();
|
|
482
|
+
let kept = null;
|
|
483
|
+
let near = null;
|
|
484
|
+
let low = null;
|
|
485
|
+
let cells = null;
|
|
486
|
+
let tagged = null;
|
|
487
|
+
const distances = new Map();
|
|
262
488
|
try {
|
|
263
489
|
const file = scene.readFromFile(scene.scenePath);
|
|
264
|
-
|
|
490
|
+
cells = file?.cells === undefined ? null : readCells(file.cells);
|
|
491
|
+
for (const a of file?.actors ?? []) {
|
|
492
|
+
ids.add(a.id);
|
|
493
|
+
if (Number.isFinite(a.lowDrawDistance) && a.lowDrawDistance > 0) {
|
|
494
|
+
distances.set(a.id, a.lowDrawDistance);
|
|
495
|
+
}
|
|
496
|
+
if (a.tier === KEEP) {
|
|
497
|
+
(kept ??= new Set()).add(a.id);
|
|
498
|
+
} else if (a.tier === NEAR) {
|
|
499
|
+
(near ??= new Set()).add(a.id);
|
|
500
|
+
} else if (a.tier === LOW) {
|
|
501
|
+
(low ??= new Set()).add(a.id);
|
|
502
|
+
}
|
|
503
|
+
const list = cells && actorCells(a.cell, cells);
|
|
504
|
+
if (list) {
|
|
505
|
+
(tagged ??= new Map()).set(a.id, list);
|
|
506
|
+
}
|
|
507
|
+
}
|
|
265
508
|
} catch {
|
|
266
|
-
|
|
509
|
+
// A scene that cannot be read has no authored actors: nothing is hidden.
|
|
510
|
+
ids.clear();
|
|
511
|
+
distances.clear();
|
|
512
|
+
kept = null;
|
|
513
|
+
near = null;
|
|
514
|
+
low = null;
|
|
515
|
+
cells = null;
|
|
516
|
+
tagged = null;
|
|
517
|
+
}
|
|
518
|
+
lv.authored = ids;
|
|
519
|
+
lv.distances = distances;
|
|
520
|
+
lv.kept = kept;
|
|
521
|
+
lv.near = near;
|
|
522
|
+
lv.low = low;
|
|
523
|
+
if (lv.cells !== cells) {
|
|
524
|
+
// Another table: the eye's cell is found again in it.
|
|
525
|
+
lv.cell = null;
|
|
267
526
|
}
|
|
527
|
+
lv.cells = cells;
|
|
528
|
+
lv.actorCells = tagged;
|
|
268
529
|
return lv.authored;
|
|
269
530
|
};
|
|
270
531
|
|
|
271
|
-
const hide = (node) => {
|
|
532
|
+
const hide = (node, instanced = false) => {
|
|
533
|
+
if (instanced) {
|
|
534
|
+
if (!lv.visibility.has(node)) {
|
|
535
|
+
lv.visibility.set(node, node.visible);
|
|
536
|
+
}
|
|
537
|
+
node.visible = false;
|
|
538
|
+
}
|
|
272
539
|
if (node.parent) {
|
|
273
540
|
lv.removed.set(node, node.parent);
|
|
274
541
|
node.parent.remove(node);
|
|
@@ -276,6 +543,10 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
276
543
|
};
|
|
277
544
|
|
|
278
545
|
const unhide = (node) => {
|
|
546
|
+
if (lv.visibility.has(node)) {
|
|
547
|
+
node.visible = lv.visibility.get(node);
|
|
548
|
+
lv.visibility.delete(node);
|
|
549
|
+
}
|
|
279
550
|
const parent = lv.removed.get(node);
|
|
280
551
|
if (parent && !node.parent) {
|
|
281
552
|
parent.add(node);
|
|
@@ -283,8 +554,8 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
283
554
|
lv.removed.delete(node);
|
|
284
555
|
};
|
|
285
556
|
|
|
286
|
-
const far = (node, near, cam, sized) => {
|
|
287
|
-
const p = node.position;
|
|
557
|
+
const far = (node, near, cam, sized, at) => {
|
|
558
|
+
const p = at && [at.x, at.y, at.z].every(Number.isFinite) ? at : node.position;
|
|
288
559
|
let b = { dx: 0, dy: 0, dz: 0, r: 0 };
|
|
289
560
|
if (sized) {
|
|
290
561
|
b = lv.bounds.get(node);
|
|
@@ -297,65 +568,288 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
297
568
|
return d > near;
|
|
298
569
|
};
|
|
299
570
|
|
|
571
|
+
// The cell whose table row decides what is drawn, or null when the cells
|
|
572
|
+
// decide nothing (no table, the rule off, the eye in no cell yet or above
|
|
573
|
+
// the roofs). Moves the eye's cell along as a side effect.
|
|
574
|
+
const eyeKey = (world) => {
|
|
575
|
+
const table = lv.cells;
|
|
576
|
+
const p = world.camera?.position;
|
|
577
|
+
if (!table || !p) {
|
|
578
|
+
return null;
|
|
579
|
+
}
|
|
580
|
+
lv.cell = eyeCell(table, lv.cell, p.x, p.z);
|
|
581
|
+
return lv.cellsOn && Number.isFinite(p.y) && p.y <= table.eyeMax ? lv.cell : null;
|
|
582
|
+
};
|
|
583
|
+
|
|
584
|
+
// An authored actor tagged with cells none of which is seen from `visible`,
|
|
585
|
+
// and inert as it is now (`cellInert`, read on every look that asks).
|
|
586
|
+
const unseen = (id, visible, scene) => {
|
|
587
|
+
const tagged = lv.actorCells?.get(id);
|
|
588
|
+
if (!tagged || tagged.some((c) => visible.has(c))) {
|
|
589
|
+
return false;
|
|
590
|
+
}
|
|
591
|
+
return cellInert(scene.getActor?.(id)?.components);
|
|
592
|
+
};
|
|
593
|
+
|
|
594
|
+
const cellsDebug = () => {
|
|
595
|
+
if (globalThis.__hubCellsDebug === true) {
|
|
596
|
+
return true;
|
|
597
|
+
}
|
|
598
|
+
lv.debugUrl ??= cellsDebugUrl();
|
|
599
|
+
return lv.debugUrl;
|
|
600
|
+
};
|
|
601
|
+
|
|
602
|
+
const dropOverlay = () => {
|
|
603
|
+
try {
|
|
604
|
+
lv.overlay?.remove();
|
|
605
|
+
} catch {
|
|
606
|
+
// A node already gone is as good as removed.
|
|
607
|
+
}
|
|
608
|
+
lv.overlay = null;
|
|
609
|
+
};
|
|
610
|
+
|
|
611
|
+
// The tuning overlay (`?hubcells=1`): which cell the eye is in, what is out
|
|
612
|
+
// and why, and what the last change of cell put back and took out.
|
|
613
|
+
const showCells = (world, now) => {
|
|
614
|
+
if (!lv.cells || !cellsDebug()) {
|
|
615
|
+
dropOverlay();
|
|
616
|
+
return;
|
|
617
|
+
}
|
|
618
|
+
try {
|
|
619
|
+
if (!lv.overlay) {
|
|
620
|
+
const el = globalThis.document.createElement('div');
|
|
621
|
+
el.style.cssText = 'position:fixed;top:4px;left:4px;z-index:2147483647;pointer-events:none;font:11px/1.35 monospace;color:#fff;background:rgba(0,0,0,.65);padding:4px 6px;white-space:pre;border-radius:3px';
|
|
622
|
+
globalThis.document.body.appendChild(el);
|
|
623
|
+
lv.overlay = el;
|
|
624
|
+
}
|
|
625
|
+
const y = world.camera?.position?.y;
|
|
626
|
+
const pop = lv.pop;
|
|
627
|
+
lv.overlay.textContent = [
|
|
628
|
+
`cell ${lv.cellKey ?? (lv.cell ? `${lv.cell} (all drawn)` : 'none/all')}`,
|
|
629
|
+
`eye y ${Number.isFinite(y) ? y.toFixed(1) : '?'} (all over ${lv.cells.eyeMax})`,
|
|
630
|
+
`out: cells ${lv.cellHidden}, other ${lv.hidden - lv.cellHidden}`,
|
|
631
|
+
pop ? `pop ${pop.from ?? 'all'} -> ${pop.to ?? 'all'}: +${pop.back} back, -${pop.out} out, ${((now - pop.at) / 1000).toFixed(1)}s ago` : 'pop none yet',
|
|
632
|
+
].join('\n');
|
|
633
|
+
} catch {
|
|
634
|
+
// No document (a worker, a test): no overlay.
|
|
635
|
+
lv.overlay = null;
|
|
636
|
+
}
|
|
637
|
+
};
|
|
638
|
+
|
|
300
639
|
// One look at every node: what should not be drawn is taken out, what should
|
|
301
640
|
// be is put back.
|
|
302
|
-
const pass = (world, scene, actors) => {
|
|
303
|
-
|
|
641
|
+
const pass = (world, scene, actors, now = 0, tier = LOW) => {
|
|
642
|
+
const isLow = tier === LOW;
|
|
643
|
+
wakeSleeping();
|
|
644
|
+
if (isLow) {
|
|
645
|
+
lightsOff(world);
|
|
646
|
+
}
|
|
304
647
|
const authored = actors ? authoredIds(scene) : null;
|
|
305
648
|
const cam = world.camera?.position ?? { x: 0, y: 0, z: 0 };
|
|
649
|
+
// The cells seen from the eye's cell, or null: the cell rule is off.
|
|
650
|
+
const key = isLow && actors ? eyeKey(world) : null;
|
|
651
|
+
const visible = key === null ? null : lv.cells.byId.get(key).sees;
|
|
652
|
+
// Remote avatars have no Player component. Their roots carry wearables
|
|
653
|
+
// and shared model rigs; ownmodel handles the local Player's visibility.
|
|
654
|
+
const avatars = new Set(scene.multiplayer?.avatars?.actors?.values() ?? []);
|
|
306
655
|
const watch = [];
|
|
656
|
+
let cellHidden = 0;
|
|
657
|
+
let back = 0;
|
|
658
|
+
let out = 0;
|
|
307
659
|
for (const [id, entry] of world.nodes) {
|
|
308
660
|
const node = entry?.node;
|
|
309
|
-
if (!node
|
|
661
|
+
if (!node) {
|
|
310
662
|
continue;
|
|
311
663
|
}
|
|
312
664
|
let want = false;
|
|
313
|
-
|
|
314
|
-
|
|
665
|
+
const distance = actors && deck.lowActorDistance === true ? lv.distances?.get(id) : undefined;
|
|
666
|
+
const components = scene.getActor?.(id)?.components;
|
|
667
|
+
const placeHidden = hub.hidden.has(id) && !('Player' in (components ?? {})) && !avatars.has(id) && id !== scene.orbitOwnModel;
|
|
668
|
+
// applyVisibility has lifted the Transform already, but syncActors
|
|
669
|
+
// writes the node later, before rendering. Judge a newly shown actor
|
|
670
|
+
// at its lifted pose, not last frame's underground node position.
|
|
671
|
+
const shownAt = lv.removed.has(node) && !hub.hidden.has(id) ? components?.Transform : null;
|
|
672
|
+
// Not seen from the eye's cell: out, whatever the rules below say,
|
|
673
|
+
// `keep` and `near` included.
|
|
674
|
+
const cellOut =
|
|
675
|
+
(!entry.instancedRig || lv.low?.has(id)) && visible !== null && authored?.has(id) && unseen(id, visible, scene);
|
|
676
|
+
if (!isLow) {
|
|
677
|
+
want = actors && lv.low?.has(id);
|
|
678
|
+
} else if (placeHidden || cellOut) {
|
|
679
|
+
want = true;
|
|
680
|
+
} else if (
|
|
681
|
+
!entry.instancedRig &&
|
|
682
|
+
authored?.has(id) &&
|
|
683
|
+
!lv.kept?.has(id) &&
|
|
684
|
+
!lv.low?.has(id)
|
|
685
|
+
) {
|
|
686
|
+
let kind = classify(components);
|
|
687
|
+
if (kind !== 'npc' && lv.near?.has(id)) {
|
|
688
|
+
kind = 'static';
|
|
689
|
+
}
|
|
315
690
|
want =
|
|
316
691
|
kind === 'decor' ||
|
|
317
|
-
(kind === 'static' && far(node, SCENERY_NEAR_M, cam, true)) ||
|
|
318
|
-
(kind === 'npc' && far(node, NPC_NEAR_M, cam, false));
|
|
692
|
+
(kind === 'static' && far(node, distance ?? SCENERY_NEAR_M, cam, true, shownAt)) ||
|
|
693
|
+
(kind === 'npc' && far(node, distance ?? NPC_NEAR_M, cam, false, shownAt));
|
|
694
|
+
}
|
|
695
|
+
if (isLow && distance && !lv.kept?.has(id) && !lv.low?.has(id) && !avatars.has(id) && !components?.Player) {
|
|
696
|
+
want ||= far(node, distance, cam, !components?.HubNpc, shownAt);
|
|
697
|
+
}
|
|
698
|
+
const actor = scene.getActor?.(id);
|
|
699
|
+
if (actor && distance) {
|
|
700
|
+
if (isLow && want && !entry.instancedRig && !avatars.has(id) && !components?.Player) {
|
|
701
|
+
actor.runtime.renderSleep = true;
|
|
702
|
+
sleeping.add(actor);
|
|
703
|
+
} else {
|
|
704
|
+
delete actor.runtime.renderSleep;
|
|
705
|
+
sleeping.delete(actor);
|
|
706
|
+
}
|
|
319
707
|
}
|
|
320
708
|
if (want) {
|
|
321
|
-
|
|
709
|
+
if (node.parent) {
|
|
710
|
+
out += 1;
|
|
711
|
+
}
|
|
712
|
+
hide(node, entry.instancedRig && (!isLow || lv.low?.has(id)));
|
|
322
713
|
if (!node.parent) {
|
|
323
714
|
watch.push([id, entry]);
|
|
715
|
+
cellHidden += cellOut ? 1 : 0;
|
|
324
716
|
}
|
|
325
717
|
} else if (lv.removed.has(node)) {
|
|
718
|
+
back += node.parent ? 0 : 1;
|
|
326
719
|
unhide(node);
|
|
327
720
|
}
|
|
328
721
|
}
|
|
329
722
|
lv.watch = watch;
|
|
330
723
|
lv.hidden = watch.length;
|
|
724
|
+
lv.cellHidden = cellHidden;
|
|
725
|
+
if (key !== lv.cellKey) {
|
|
726
|
+
lv.pop = { from: lv.cellKey, to: key, back, out, at: now };
|
|
727
|
+
lv.cellKey = key;
|
|
728
|
+
}
|
|
729
|
+
if (lv.cells || lv.overlay) {
|
|
730
|
+
showCells(world, now);
|
|
731
|
+
}
|
|
331
732
|
};
|
|
332
733
|
|
|
333
734
|
// Whether a node taken out was replaced (a rebuild) or put back since.
|
|
334
735
|
const watchBroken = (world) => {
|
|
335
736
|
for (const [id, entry] of lv.watch) {
|
|
336
|
-
if (world.nodes.get(id) !== entry || entry.node.parent) {
|
|
737
|
+
if (world.nodes.get(id) !== entry || entry.node.parent || (lv.visibility.has(entry.node) && entry.node.visible !== false)) {
|
|
337
738
|
return true;
|
|
338
739
|
}
|
|
339
740
|
}
|
|
340
741
|
return false;
|
|
341
742
|
};
|
|
342
743
|
|
|
343
|
-
//
|
|
744
|
+
// The kit sky off while Low. physics-3d draws what the runtime's `sky`
|
|
745
|
+
// getter answers (the scene's parsed `engine.sky`, or null) and reads it
|
|
746
|
+
// afresh every frame, releasing a dome whose key is gone; it has no switch
|
|
747
|
+
// of its own. So Low puts an own `sky` of null on the runtime, over the
|
|
748
|
+
// getter, and leaving Low deletes it: the getter answers again and the
|
|
749
|
+
// next frame makes the sky. `skyZone` is not touched (nothing steps it).
|
|
750
|
+
// Never on High, so a deck that is never Low has no such property.
|
|
751
|
+
const skyOff = (scene) => {
|
|
752
|
+
const held = lv.skyOff;
|
|
753
|
+
if (held && held !== scene) {
|
|
754
|
+
if (Object.getOwnPropertyDescriptor(held, 'sky')?.value === null) {
|
|
755
|
+
delete held.sky;
|
|
756
|
+
}
|
|
757
|
+
lv.skyOff = null;
|
|
758
|
+
}
|
|
759
|
+
if (scene && !lv.skyOff) {
|
|
760
|
+
if (!Object.hasOwn(scene, 'sky')) {
|
|
761
|
+
Object.defineProperty(scene, 'sky', { value: null, configurable: true, enumerable: false });
|
|
762
|
+
}
|
|
763
|
+
lv.skyOff = scene;
|
|
764
|
+
}
|
|
765
|
+
};
|
|
766
|
+
|
|
767
|
+
// Each frame: Low applies its rules; High hides only low-marked actors.
|
|
768
|
+
// tiers run in the runtime's update, before the player loads a requested
|
|
769
|
+
// scene and builds its nodes: a low-marked node built in a frame is drawn
|
|
770
|
+
// on High for that one frame (a scene load, or the actor's rebuild).
|
|
771
|
+
// The nodes are looked at every CHECK_EVERY_MS, and at
|
|
344
772
|
// once when the engine swapped or rebuilt them (another scene, nodes parked
|
|
345
|
-
// or put back, actors come or gone
|
|
346
|
-
//
|
|
347
|
-
//
|
|
348
|
-
|
|
773
|
+
// or put back, actors come or gone, the scene loaded again: new scene data
|
|
774
|
+
// may carry other `tier` marks over the same nodes). `actors` false (a game reached through
|
|
775
|
+
// a door: another deck's content) puts scenery back and keeps only the
|
|
776
|
+
// shadow lever, the sky off and the place's own hidden actors.
|
|
777
|
+
const update = (world, scene, now, { actors = true, tier = LOW } = {}) => {
|
|
349
778
|
adopt(world);
|
|
350
|
-
|
|
779
|
+
const isLow = tier === LOW;
|
|
780
|
+
lv.active = isLow;
|
|
781
|
+
// Whatever scene plays, a game reached through a door included. It
|
|
782
|
+
// stays over a scene load, so a keyed scene loaded on Low never draws
|
|
783
|
+
// or uploads its sky, not even for the frame of the load.
|
|
784
|
+
// A scene load asked for this frame runs right after this update, before
|
|
785
|
+
// the draw. Its reset releases a sky made on High by the key it reads, so
|
|
786
|
+
// Low does not start hiding the key in that frame, only from the next.
|
|
787
|
+
const loading = Boolean(scene.requestedScene);
|
|
788
|
+
skyOff(isLow && (lv.skyOff === scene || !loading) ? scene : null);
|
|
789
|
+
if (!isLow) {
|
|
790
|
+
if (loading) {
|
|
791
|
+
// And the load may reuse a node for the next scene's actor of the
|
|
792
|
+
// same id, marked or not: what High took out goes back in first.
|
|
793
|
+
// Only nodes the world still has: one the engine released since
|
|
794
|
+
// (the actor's rebuild) stays out for good.
|
|
795
|
+
for (const [id, entry] of lv.watch) {
|
|
796
|
+
if (world.nodes.get(id) === entry) {
|
|
797
|
+
unhide(entry.node);
|
|
798
|
+
}
|
|
799
|
+
}
|
|
800
|
+
lv.watch = [];
|
|
801
|
+
lv.seen = { path: undefined, nodes: null, size: -1 };
|
|
802
|
+
return;
|
|
803
|
+
}
|
|
804
|
+
if (actors) {
|
|
805
|
+
authoredIds(scene);
|
|
806
|
+
}
|
|
807
|
+
if ((!actors || !lv.low) && !lv.watch.length) {
|
|
808
|
+
return;
|
|
809
|
+
}
|
|
810
|
+
}
|
|
351
811
|
const seen = lv.seen;
|
|
352
|
-
|
|
353
|
-
|
|
812
|
+
// mergeHidden replaces the per-viewer set. clear empties it in place on
|
|
813
|
+
// a session switch, so remember its size too. Either runs this frame.
|
|
814
|
+
const changed =
|
|
815
|
+
world.scenePath !== seen.path ||
|
|
816
|
+
world.nodes !== seen.nodes ||
|
|
817
|
+
world.nodes.size !== seen.size ||
|
|
818
|
+
scene.data !== seen.data ||
|
|
819
|
+
hub.hidden !== seen.hidden ||
|
|
820
|
+
hub.hidden.size !== seen.hiddenSize ||
|
|
821
|
+
watchBroken(world) ||
|
|
822
|
+
tier !== seen.tier;
|
|
823
|
+
// The eye's cell every frame (one or two small outlines; null and done
|
|
824
|
+
// in a scene without cells): a new cell is looked at at once, not at the
|
|
825
|
+
// next look, so what it sees is not missing for half a second.
|
|
826
|
+
const crossed = isLow && lv.cells !== null && actors && eyeKey(world) !== lv.cellKey;
|
|
827
|
+
if (!changed && !crossed && now < lv.nextAt && actors === seen.actors) {
|
|
354
828
|
return;
|
|
355
829
|
}
|
|
356
|
-
lv.seen = {
|
|
830
|
+
lv.seen = {
|
|
831
|
+
path: world.scenePath,
|
|
832
|
+
nodes: world.nodes,
|
|
833
|
+
size: world.nodes.size,
|
|
834
|
+
data: scene.data,
|
|
835
|
+
actors,
|
|
836
|
+
tier,
|
|
837
|
+
hidden: hub.hidden,
|
|
838
|
+
hiddenSize: hub.hidden.size,
|
|
839
|
+
};
|
|
357
840
|
lv.nextAt = now + CHECK_EVERY_MS;
|
|
358
|
-
pass(world, scene, actors);
|
|
841
|
+
pass(world, scene, actors, now, tier);
|
|
842
|
+
return true;
|
|
843
|
+
};
|
|
844
|
+
|
|
845
|
+
lv.apply = (world, scene, now, options) => update(world, scene, now, options);
|
|
846
|
+
lv.high = (world, scene, now, options) => update(world, scene, now, { ...options, tier: 'high' });
|
|
847
|
+
|
|
848
|
+
// The cell rule off or on at runtime (the harness's A/B); the next frame
|
|
849
|
+
// looks at every node again.
|
|
850
|
+
lv.setCells = (on) => {
|
|
851
|
+
lv.cellsOn = Boolean(on);
|
|
852
|
+
lv.nextAt = 0;
|
|
359
853
|
};
|
|
360
854
|
|
|
361
855
|
// Back to the picture as authored: every node taken out of the scene put
|
|
@@ -363,17 +857,25 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
363
857
|
// left to the engine), every shadow on again.
|
|
364
858
|
lv.restore = (world) => {
|
|
365
859
|
adopt(world);
|
|
860
|
+
wakeSleeping();
|
|
861
|
+
skyOff(null);
|
|
366
862
|
for (const entry of world.nodes.values()) {
|
|
367
863
|
if (entry?.node && lv.removed.has(entry.node)) {
|
|
368
864
|
unhide(entry.node);
|
|
369
865
|
}
|
|
370
866
|
}
|
|
371
867
|
lv.removed = new WeakMap();
|
|
868
|
+
lv.visibility = new WeakMap();
|
|
372
869
|
for (const light of lv.lights) {
|
|
373
870
|
light.castShadow = true;
|
|
374
871
|
}
|
|
375
872
|
lv.lights.clear();
|
|
376
873
|
lv.hidden = 0;
|
|
874
|
+
lv.cellHidden = 0;
|
|
875
|
+
lv.cell = null;
|
|
876
|
+
lv.cellKey = null;
|
|
877
|
+
lv.pop = null;
|
|
878
|
+
dropOverlay();
|
|
377
879
|
lv.watch = [];
|
|
378
880
|
lv.active = false;
|
|
379
881
|
lv.seen = { path: undefined, nodes: null, size: -1 };
|
|
@@ -452,11 +954,14 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
|
|
|
452
954
|
}
|
|
453
955
|
if (t.current() === 'low') {
|
|
454
956
|
levers.apply(world, scene, now, { actors: !scene.content });
|
|
455
|
-
} else
|
|
957
|
+
} else {
|
|
456
958
|
// Low to High costs a one-off stall (about 1 s on the phones measured)
|
|
457
959
|
// as three.js recompiles its shader programs for the shadows coming
|
|
458
960
|
// back. Acceptable: auto never moves up, only a player's pick does.
|
|
459
|
-
levers.
|
|
961
|
+
if (levers.active) {
|
|
962
|
+
levers.restore(world);
|
|
963
|
+
}
|
|
964
|
+
levers.high?.(world, scene, now, { actors: !scene.content });
|
|
460
965
|
}
|
|
461
966
|
};
|
|
462
967
|
|
|
@@ -474,6 +979,15 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
|
|
|
474
979
|
get hidden() {
|
|
475
980
|
return levers.hidden;
|
|
476
981
|
},
|
|
982
|
+
// The visibility cells: the eye's cell, how many nodes are out for cells
|
|
983
|
+
// alone, and the rule off or on for an A/B.
|
|
984
|
+
get cell() {
|
|
985
|
+
return levers.cell ?? null;
|
|
986
|
+
},
|
|
987
|
+
get cellHidden() {
|
|
988
|
+
return levers.cellHidden ?? 0;
|
|
989
|
+
},
|
|
990
|
+
cells: (on) => levers.setCells?.(on),
|
|
477
991
|
set: (mode) => t.set(mode),
|
|
478
992
|
};
|
|
479
993
|
return t;
|