castle-web-cli 0.4.232 → 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/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 +329 -11
- 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 +309 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +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/chrome.js +1144 -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 +339 -20
- package/kits/hub-game/code/client/hookLayer.js +299 -13
- 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 +109 -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 +516 -27
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +32 -0
- package/kits/hub-game/code/client/visibility.js +43 -0
- package/kits/hub-game/code/client/wear.js +461 -170
- 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 +9 -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/history.js +5 -0
- package/kits/hub-game/code/server/hub.js +1254 -50
- 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 +378 -7
- 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 +2 -2
- package/kits/hub-game/code/server/players.js +22 -0
- 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 +12 -0
- 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 +845 -95
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +2244 -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 +662 -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-orbit.mjs +918 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-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 +716 -2
- package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
- 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 +207 -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-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-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 +477 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +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 +253 -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 +326 -1
- package/kits/physics-3d/CLAUDE.md +1169 -30
- package/kits/physics-3d/behaviors/Player.jsx +629 -72
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/pxmodel-format.md +8 -0
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
- 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 +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +487 -9
- 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 +796 -69
- package/kits/physics-3d/main.jsx +5 -0
- package/kits/physics-3d/package.json +1 -1
- package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
- 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 +8 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +383 -6
- 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
|
@@ -18,7 +18,19 @@
|
|
|
18
18
|
// A deck may mark an actor in its scene file `"tier": "keep"` (beside `id`,
|
|
19
19
|
// not a component): it is drawn on every tier, whatever it would be called
|
|
20
20
|
// here -- a place's ground is often plain Transform/Shape/Model, and a place
|
|
21
|
-
// drawn without it stands on nothing.
|
|
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.
|
|
22
34
|
//
|
|
23
35
|
// Where a device starts: low if it was found slow here in the last week
|
|
24
36
|
// (remembered in localStorage), or its GPU or memory says it is a weak phone;
|
|
@@ -27,6 +39,7 @@
|
|
|
27
39
|
// over all of it.
|
|
28
40
|
|
|
29
41
|
import { Box3, Sphere } from 'three';
|
|
42
|
+
import { hub, deck } from './state.js';
|
|
30
43
|
|
|
31
44
|
export const TIERS = ['low', 'high'];
|
|
32
45
|
export const MODES = ['auto', 'low', 'high'];
|
|
@@ -175,8 +188,12 @@ const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
|
|
|
175
188
|
|
|
176
189
|
// The mark a scene file puts on an actor (`"tier": "keep"`, a field of the
|
|
177
190
|
// actor beside `id`) to have it drawn on every tier whatever `classify` says
|
|
178
|
-
// of it.
|
|
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.
|
|
179
194
|
export const KEEP = 'keep';
|
|
195
|
+
export const NEAR = 'near';
|
|
196
|
+
export const LOW = 'low';
|
|
180
197
|
|
|
181
198
|
export function classify(components) {
|
|
182
199
|
const names = Object.keys(components ?? {});
|
|
@@ -196,6 +213,154 @@ export function classify(components) {
|
|
|
196
213
|
return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
|
|
197
214
|
}
|
|
198
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
|
+
|
|
199
364
|
// A node's bounds once, as its middle's offset from the node's position and a
|
|
200
365
|
// radius: scenery does not change shape, and the offset follows a node the
|
|
201
366
|
// place moves (a hidden actor waits far below the ground).
|
|
@@ -222,16 +387,41 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
222
387
|
lights: new Set(),
|
|
223
388
|
// node -> the parent it was taken out of.
|
|
224
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(),
|
|
225
395
|
hidden: 0,
|
|
226
396
|
bounds: new WeakMap(),
|
|
227
397
|
// The authored actors of the scene playing: only these are ever hidden
|
|
228
|
-
// (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.
|
|
229
400
|
authored: null,
|
|
401
|
+
distances: null,
|
|
230
402
|
authoredFor: null,
|
|
231
|
-
// Of those, the ids
|
|
403
|
+
// Of those, the ids marked `"tier": "keep"`: exempt from distance/decor.
|
|
232
404
|
// null when the file marks none.
|
|
233
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,
|
|
234
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,
|
|
235
425
|
// The entries taken out on the last look, [actor id, entry]: the engine
|
|
236
426
|
// replaces an entry in the same map when an actor's look changes
|
|
237
427
|
// (world3d.js `ensureActorNode`), and the new node is drawn, so these are
|
|
@@ -240,15 +430,30 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
240
430
|
nextAt: 0,
|
|
241
431
|
};
|
|
242
432
|
|
|
433
|
+
const sleeping = new Set();
|
|
434
|
+
const wakeSleeping = () => {
|
|
435
|
+
for (const actor of sleeping) {delete actor.runtime.renderSleep;}
|
|
436
|
+
sleeping.clear();
|
|
437
|
+
};
|
|
243
438
|
const adopt = (world) => {
|
|
244
439
|
if (lv.world !== world) {
|
|
440
|
+
wakeSleeping();
|
|
245
441
|
// A new world: nothing changed on the old one is put back there.
|
|
246
442
|
lv.world = world;
|
|
247
443
|
lv.lights = new Set();
|
|
248
444
|
lv.removed = new WeakMap();
|
|
445
|
+
lv.visibility = new WeakMap();
|
|
249
446
|
lv.authored = null;
|
|
250
447
|
lv.authoredFor = null;
|
|
251
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;
|
|
252
457
|
lv.seen = { path: undefined, nodes: null, size: -1 };
|
|
253
458
|
lv.watch = [];
|
|
254
459
|
lv.nextAt = 0;
|
|
@@ -271,28 +476,66 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
271
476
|
if (lv.authoredFor === scene.data && lv.authored) {
|
|
272
477
|
return lv.authored;
|
|
273
478
|
}
|
|
479
|
+
wakeSleeping();
|
|
274
480
|
lv.authoredFor = scene.data;
|
|
275
481
|
const ids = new Set();
|
|
276
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();
|
|
277
488
|
try {
|
|
278
489
|
const file = scene.readFromFile(scene.scenePath);
|
|
490
|
+
cells = file?.cells === undefined ? null : readCells(file.cells);
|
|
279
491
|
for (const a of file?.actors ?? []) {
|
|
280
492
|
ids.add(a.id);
|
|
493
|
+
if (Number.isFinite(a.lowDrawDistance) && a.lowDrawDistance > 0) {
|
|
494
|
+
distances.set(a.id, a.lowDrawDistance);
|
|
495
|
+
}
|
|
281
496
|
if (a.tier === KEEP) {
|
|
282
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);
|
|
283
506
|
}
|
|
284
507
|
}
|
|
285
508
|
} catch {
|
|
286
509
|
// A scene that cannot be read has no authored actors: nothing is hidden.
|
|
287
510
|
ids.clear();
|
|
511
|
+
distances.clear();
|
|
288
512
|
kept = null;
|
|
513
|
+
near = null;
|
|
514
|
+
low = null;
|
|
515
|
+
cells = null;
|
|
516
|
+
tagged = null;
|
|
289
517
|
}
|
|
290
518
|
lv.authored = ids;
|
|
519
|
+
lv.distances = distances;
|
|
291
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;
|
|
526
|
+
}
|
|
527
|
+
lv.cells = cells;
|
|
528
|
+
lv.actorCells = tagged;
|
|
292
529
|
return lv.authored;
|
|
293
530
|
};
|
|
294
531
|
|
|
295
|
-
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
|
+
}
|
|
296
539
|
if (node.parent) {
|
|
297
540
|
lv.removed.set(node, node.parent);
|
|
298
541
|
node.parent.remove(node);
|
|
@@ -300,6 +543,10 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
300
543
|
};
|
|
301
544
|
|
|
302
545
|
const unhide = (node) => {
|
|
546
|
+
if (lv.visibility.has(node)) {
|
|
547
|
+
node.visible = lv.visibility.get(node);
|
|
548
|
+
lv.visibility.delete(node);
|
|
549
|
+
}
|
|
303
550
|
const parent = lv.removed.get(node);
|
|
304
551
|
if (parent && !node.parent) {
|
|
305
552
|
parent.add(node);
|
|
@@ -307,8 +554,8 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
307
554
|
lv.removed.delete(node);
|
|
308
555
|
};
|
|
309
556
|
|
|
310
|
-
const far = (node, near, cam, sized) => {
|
|
311
|
-
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;
|
|
312
559
|
let b = { dx: 0, dy: 0, dz: 0, r: 0 };
|
|
313
560
|
if (sized) {
|
|
314
561
|
b = lv.bounds.get(node);
|
|
@@ -321,66 +568,288 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
321
568
|
return d > near;
|
|
322
569
|
};
|
|
323
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
|
+
|
|
324
639
|
// One look at every node: what should not be drawn is taken out, what should
|
|
325
640
|
// be is put back.
|
|
326
|
-
const pass = (world, scene, actors) => {
|
|
327
|
-
|
|
641
|
+
const pass = (world, scene, actors, now = 0, tier = LOW) => {
|
|
642
|
+
const isLow = tier === LOW;
|
|
643
|
+
wakeSleeping();
|
|
644
|
+
if (isLow) {
|
|
645
|
+
lightsOff(world);
|
|
646
|
+
}
|
|
328
647
|
const authored = actors ? authoredIds(scene) : null;
|
|
329
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() ?? []);
|
|
330
655
|
const watch = [];
|
|
656
|
+
let cellHidden = 0;
|
|
657
|
+
let back = 0;
|
|
658
|
+
let out = 0;
|
|
331
659
|
for (const [id, entry] of world.nodes) {
|
|
332
660
|
const node = entry?.node;
|
|
333
|
-
if (!node
|
|
661
|
+
if (!node) {
|
|
334
662
|
continue;
|
|
335
663
|
}
|
|
336
664
|
let want = false;
|
|
337
|
-
|
|
338
|
-
|
|
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
|
+
}
|
|
339
690
|
want =
|
|
340
691
|
kind === 'decor' ||
|
|
341
|
-
(kind === 'static' && far(node, SCENERY_NEAR_M, cam, true)) ||
|
|
342
|
-
(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
|
+
}
|
|
343
707
|
}
|
|
344
708
|
if (want) {
|
|
345
|
-
|
|
709
|
+
if (node.parent) {
|
|
710
|
+
out += 1;
|
|
711
|
+
}
|
|
712
|
+
hide(node, entry.instancedRig && (!isLow || lv.low?.has(id)));
|
|
346
713
|
if (!node.parent) {
|
|
347
714
|
watch.push([id, entry]);
|
|
715
|
+
cellHidden += cellOut ? 1 : 0;
|
|
348
716
|
}
|
|
349
717
|
} else if (lv.removed.has(node)) {
|
|
718
|
+
back += node.parent ? 0 : 1;
|
|
350
719
|
unhide(node);
|
|
351
720
|
}
|
|
352
721
|
}
|
|
353
722
|
lv.watch = watch;
|
|
354
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
|
+
}
|
|
355
732
|
};
|
|
356
733
|
|
|
357
734
|
// Whether a node taken out was replaced (a rebuild) or put back since.
|
|
358
735
|
const watchBroken = (world) => {
|
|
359
736
|
for (const [id, entry] of lv.watch) {
|
|
360
|
-
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)) {
|
|
361
738
|
return true;
|
|
362
739
|
}
|
|
363
740
|
}
|
|
364
741
|
return false;
|
|
365
742
|
};
|
|
366
743
|
|
|
367
|
-
//
|
|
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
|
|
368
772
|
// once when the engine swapped or rebuilt them (another scene, nodes parked
|
|
369
773
|
// or put back, actors come or gone, the scene loaded again: new scene data
|
|
370
774
|
// may carry other `tier` marks over the same nodes). `actors` false (a game reached through
|
|
371
|
-
// a door: another deck's content) puts
|
|
372
|
-
// shadow lever.
|
|
373
|
-
|
|
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 } = {}) => {
|
|
374
778
|
adopt(world);
|
|
375
|
-
|
|
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
|
+
}
|
|
376
811
|
const seen = lv.seen;
|
|
377
|
-
|
|
378
|
-
|
|
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) {
|
|
379
828
|
return;
|
|
380
829
|
}
|
|
381
|
-
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
|
+
};
|
|
382
840
|
lv.nextAt = now + CHECK_EVERY_MS;
|
|
383
|
-
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;
|
|
384
853
|
};
|
|
385
854
|
|
|
386
855
|
// Back to the picture as authored: every node taken out of the scene put
|
|
@@ -388,17 +857,25 @@ export function makeLevers({ boundsOf = nodeBounds } = {}) {
|
|
|
388
857
|
// left to the engine), every shadow on again.
|
|
389
858
|
lv.restore = (world) => {
|
|
390
859
|
adopt(world);
|
|
860
|
+
wakeSleeping();
|
|
861
|
+
skyOff(null);
|
|
391
862
|
for (const entry of world.nodes.values()) {
|
|
392
863
|
if (entry?.node && lv.removed.has(entry.node)) {
|
|
393
864
|
unhide(entry.node);
|
|
394
865
|
}
|
|
395
866
|
}
|
|
396
867
|
lv.removed = new WeakMap();
|
|
868
|
+
lv.visibility = new WeakMap();
|
|
397
869
|
for (const light of lv.lights) {
|
|
398
870
|
light.castShadow = true;
|
|
399
871
|
}
|
|
400
872
|
lv.lights.clear();
|
|
401
873
|
lv.hidden = 0;
|
|
874
|
+
lv.cellHidden = 0;
|
|
875
|
+
lv.cell = null;
|
|
876
|
+
lv.cellKey = null;
|
|
877
|
+
lv.pop = null;
|
|
878
|
+
dropOverlay();
|
|
402
879
|
lv.watch = [];
|
|
403
880
|
lv.active = false;
|
|
404
881
|
lv.seen = { path: undefined, nodes: null, size: -1 };
|
|
@@ -477,11 +954,14 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
|
|
|
477
954
|
}
|
|
478
955
|
if (t.current() === 'low') {
|
|
479
956
|
levers.apply(world, scene, now, { actors: !scene.content });
|
|
480
|
-
} else
|
|
957
|
+
} else {
|
|
481
958
|
// Low to High costs a one-off stall (about 1 s on the phones measured)
|
|
482
959
|
// as three.js recompiles its shader programs for the shadows coming
|
|
483
960
|
// back. Acceptable: auto never moves up, only a player's pick does.
|
|
484
|
-
levers.
|
|
961
|
+
if (levers.active) {
|
|
962
|
+
levers.restore(world);
|
|
963
|
+
}
|
|
964
|
+
levers.high?.(world, scene, now, { actors: !scene.content });
|
|
485
965
|
}
|
|
486
966
|
};
|
|
487
967
|
|
|
@@ -499,6 +979,15 @@ export function makeTiers({ storage = pageStorage(), clock = () => Date.now(), d
|
|
|
499
979
|
get hidden() {
|
|
500
980
|
return levers.hidden;
|
|
501
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),
|
|
502
991
|
set: (mode) => t.set(mode),
|
|
503
992
|
};
|
|
504
993
|
return t;
|