castle-web-cli 0.4.233 → 0.4.235
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/api.d.ts +11 -0
- package/dist/api.js +43 -0
- package/dist/bundle.d.ts +64 -0
- package/dist/bundle.js +558 -2
- package/dist/castle-host/host.d.ts +17 -2
- package/dist/castle-host/host.js +793 -36
- package/dist/castleJson.d.ts +20 -1
- package/dist/castleJson.js +44 -2
- package/dist/check.js +9 -2
- package/dist/chunkLoader.d.ts +3 -0
- package/dist/chunkLoader.js +111 -0
- package/dist/devParty.d.ts +26 -0
- package/dist/devParty.js +231 -0
- package/dist/devSaveStorage.js +4 -0
- package/dist/devSessionStorage.js +3 -1
- package/dist/devSocial.d.ts +24 -0
- package/dist/devSocial.js +70 -0
- package/dist/ide.d.ts +2 -0
- package/dist/ide.js +119 -15
- package/dist/index.js +8 -2
- package/dist/init.js +1 -1
- package/dist/save-deck.d.ts +20 -1
- package/dist/save-deck.js +141 -5
- package/dist/serve.js +29 -11
- package/dist/shell/assets/{index-BjOxR-lW.js → index-DulbYIJm.js} +97 -97
- package/dist/shell/index.html +1 -1
- package/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +266 -3
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +162 -1
- package/kits/base/sdk/commands.js +3 -0
- package/kits/base/sdk/display.d.ts +3 -0
- package/kits/base/sdk/display.js +9 -3
- package/kits/base/sdk/hub.d.ts +33 -6
- package/kits/base/sdk/hub.js +68 -5
- package/kits/base/sdk/hubRejoin.d.ts +4 -0
- package/kits/base/sdk/hubRejoin.js +15 -0
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +147 -40
- package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
- package/kits/base/sdk/party.d.ts +23 -0
- package/kits/base/sdk/party.js +91 -0
- package/kits/base/sdk/reconnectBudget.d.ts +23 -0
- package/kits/base/sdk/reconnectBudget.js +96 -0
- package/kits/base/sdk/save.d.ts +38 -1
- package/kits/base/sdk/save.js +79 -6
- package/kits/base/sdk/server/hub.d.ts +31 -1
- package/kits/base/sdk/server/hub.js +50 -3
- package/kits/base/sdk/server/platformHandle.d.ts +13 -1
- package/kits/base/sdk/server/storage.d.ts +4 -0
- package/kits/base/sdk/server/storage.js +19 -3
- package/kits/base/sdk/server/wrapper.d.ts +7 -1
- package/kits/base/sdk/server/wrapper.js +10 -1
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +123 -3
- package/kits/hub-game/README.md +63 -0
- package/kits/hub-game/castle.json +5 -5
- package/kits/hub-game/code/client/act.js +312 -0
- package/kits/hub-game/code/client/actionLayout.js +147 -0
- package/kits/hub-game/code/client/actionOverflow.js +556 -0
- package/kits/hub-game/code/client/arrivalCamera.js +50 -0
- package/kits/hub-game/code/client/askSlot.js +117 -0
- package/kits/hub-game/code/client/avatar.js +4 -2
- package/kits/hub-game/code/client/avatarShare.js +2 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +15 -10
- package/kits/hub-game/code/client/build.js +16 -0
- package/kits/hub-game/code/client/chat.js +41 -5
- package/kits/hub-game/code/client/chatModeration.js +5 -0
- package/kits/hub-game/code/client/chrome.js +1148 -258
- package/kits/hub-game/code/client/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +10 -4
- package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
- package/kits/hub-game/code/client/doorErrors.js +39 -0
- package/kits/hub-game/code/client/fall.js +18 -0
- package/kits/hub-game/code/client/farAvatars.js +233 -0
- package/kits/hub-game/code/client/firstJoin.js +9 -2
- package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
- package/kits/hub-game/code/client/frameBatch.js +5 -0
- package/kits/hub-game/code/client/grab.js +31 -11
- package/kits/hub-game/code/client/hookLayer.js +87 -8
- package/kits/hub-game/code/client/hudCopy.js +51 -0
- package/kits/hub-game/code/client/hudRate.js +20 -0
- package/kits/hub-game/code/client/idle.js +14 -2
- package/kits/hub-game/code/client/invites.js +231 -0
- package/kits/hub-game/code/client/joinError.js +9 -0
- package/kits/hub-game/code/client/labelsNear.js +31 -2
- package/kits/hub-game/code/client/landscapeLayout.js +17 -0
- package/kits/hub-game/code/client/layoutCache.js +264 -0
- package/kits/hub-game/code/client/loadTelemetry.js +20 -0
- package/kits/hub-game/code/client/loadingCover.js +148 -0
- package/kits/hub-game/code/client/loadingEntry.js +8 -0
- package/kits/hub-game/code/client/menuRows.js +43 -0
- package/kits/hub-game/code/client/modelReady.js +7 -0
- package/kits/hub-game/code/client/padCueArrival.js +23 -0
- package/kits/hub-game/code/client/padCues.js +112 -0
- package/kits/hub-game/code/client/padOccupancy.js +88 -0
- package/kits/hub-game/code/client/padReadability.js +26 -0
- package/kits/hub-game/code/client/padRings.js +69 -0
- package/kits/hub-game/code/client/pushVisit.js +14 -0
- package/kits/hub-game/code/client/quality.js +205 -0
- package/kits/hub-game/code/client/qualityEntry.js +55 -0
- package/kits/hub-game/code/client/safeLayout.js +338 -0
- package/kits/hub-game/code/client/safeStyle.js +42 -0
- package/kits/hub-game/code/client/say.js +12 -3
- package/kits/hub-game/code/client/shot.js +64 -10
- package/kits/hub-game/code/client/shotFit.js +56 -0
- package/kits/hub-game/code/client/signIn.js +28 -0
- package/kits/hub-game/code/client/state.js +53 -0
- package/kits/hub-game/code/client/talk.js +209 -45
- package/kits/hub-game/code/client/tiers.js +68 -66
- package/kits/hub-game/code/client/together.js +7 -2
- package/kits/hub-game/code/client/weakestLookBake.js +92 -0
- package/kits/hub-game/code/client/weakestTier.js +295 -0
- package/kits/hub-game/code/client/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +10 -9
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +6 -1
- package/kits/hub-game/code/server/actors.js +2 -1
- package/kits/hub-game/code/server/analytics.js +83 -0
- package/kits/hub-game/code/server/anonymousEntry.js +49 -0
- package/kits/hub-game/code/server/arrivalPose.js +36 -0
- package/kits/hub-game/code/server/companion.js +28 -3
- package/kits/hub-game/code/server/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +22 -5
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendsAmong.js +49 -9
- package/kits/hub-game/code/server/history.js +2 -0
- package/kits/hub-game/code/server/hub.js +1306 -95
- package/kits/hub-game/code/server/idle.js +30 -1
- package/kits/hub-game/code/server/index.js +26 -4
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +9 -1
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +211 -3
- package/kits/hub-game/code/server/menu.js +31 -3
- package/kits/hub-game/code/server/npcs.js +226 -64
- package/kits/hub-game/code/server/observe.js +408 -0
- package/kits/hub-game/code/server/padOccupancy.js +85 -0
- package/kits/hub-game/code/server/players.js +9 -1
- package/kits/hub-game/code/server/resumePose.js +152 -0
- package/kits/hub-game/code/server/say.js +1 -1
- package/kits/hub-game/code/server/standing.js +4 -5
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +67 -5
- package/kits/hub-game/code/shared/act.js +35 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -0
- package/kits/hub-game/code/shared/loadStages.js +12 -0
- package/kits/hub-game/code/shared/quality.js +74 -0
- package/kits/hub-game/code/shared/say.js +2 -0
- package/kits/hub-game/code/shared/shot.js +35 -1
- package/kits/hub-game/code/systems/hub.js +970 -169
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/contract.md +1259 -42
- package/kits/hub-game/docs/home-pieces.md +9 -2
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -0
- package/kits/hub-game/package-lock.json +10 -3
- package/kits/hub-game/package.json +6 -3
- package/kits/hub-game/play/player.js +142 -0
- package/kits/hub-game/play/registry.js +47 -0
- package/kits/hub-game/play.jsx +37 -0
- package/kits/hub-game/scripts/check.mjs +39 -5
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -1
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +11 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +5 -5
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +3 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +19 -3
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +3 -3
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -1
- package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
- package/kits/hub-game/scripts/test-act-client.mjs +186 -0
- package/kits/hub-game/scripts/test-act.mjs +171 -0
- package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
- package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
- package/kits/hub-game/scripts/test-actions-client.mjs +367 -2
- package/kits/hub-game/scripts/test-actors.mjs +20 -7
- package/kits/hub-game/scripts/test-analytics.mjs +76 -0
- package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
- package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
- package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
- package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +49 -10
- package/kits/hub-game/scripts/test-avatar.mjs +44 -0
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +11 -4
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +20 -2
- package/kits/hub-game/scripts/test-chat.mjs +206 -5
- package/kits/hub-game/scripts/test-companion-chat.mjs +20 -2
- package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
- package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
- package/kits/hub-game/scripts/test-decor-client.mjs +45 -4
- package/kits/hub-game/scripts/test-decor.mjs +7 -0
- package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
- package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
- package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
- package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
- package/kits/hub-game/scripts/test-earned.mjs +33 -3
- package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
- package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
- package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
- package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +47 -4
- package/kits/hub-game/scripts/test-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +321 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +879 -11
- package/kits/hub-game/scripts/test-hud-clear.mjs +162 -59
- package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
- package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
- package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
- package/kits/hub-game/scripts/test-idle.mjs +66 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +20 -0
- package/kits/hub-game/scripts/test-interest.mjs +15 -0
- package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
- package/kits/hub-game/scripts/test-invites.mjs +109 -0
- package/kits/hub-game/scripts/test-labels.mjs +71 -3
- package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
- package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
- package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
- package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
- package/kits/hub-game/scripts/test-manifest.mjs +265 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +105 -0
- package/kits/hub-game/scripts/test-menu.mjs +23 -0
- package/kits/hub-game/scripts/test-npcs.mjs +917 -10
- package/kits/hub-game/scripts/test-observed.mjs +745 -0
- package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
- package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
- package/kits/hub-game/scripts/test-picker.mjs +234 -7
- package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
- package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
- package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
- package/kits/hub-game/scripts/test-quality.mjs +385 -0
- package/kits/hub-game/scripts/test-rehello.mjs +699 -5
- package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
- package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
- package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
- package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
- package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
- package/kits/hub-game/scripts/test-say.mjs +1 -1
- package/kits/hub-game/scripts/test-shot.mjs +145 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +22 -17
- package/kits/hub-game/scripts/test-standing.mjs +35 -2
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +5 -4
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +86 -13
- package/kits/hub-game/scripts/test-tiers.mjs +7 -8
- package/kits/hub-game/scripts/test-vis.mjs +433 -6
- package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
- package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
- package/kits/hub-game/scripts/test-yours-chrome.mjs +50 -6
- package/kits/hub-game/scripts/test-yours.mjs +39 -8
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +369 -30
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +2 -1
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +10 -1
- package/kits/physics-2d/castle.json +2 -2
- package/kits/physics-2d/engine/frozenActors.js +233 -0
- package/kits/physics-2d/engine/scene.js +87 -5
- package/kits/physics-2d/eslint.config.js +1 -1
- package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
- package/kits/physics-2d/play/behaviors/Camera.js +40 -0
- package/kits/physics-2d/play/behaviors/Collider.js +122 -0
- package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
- package/kits/physics-2d/play/behaviors/Goal.js +46 -0
- package/kits/physics-2d/play/behaviors/Joints.js +126 -0
- package/kits/physics-2d/play/behaviors/Layout.js +71 -0
- package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
- package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
- package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
- package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
- package/kits/physics-2d/play/behaviors/Style.js +209 -0
- package/kits/physics-2d/play/behaviors/Text.js +85 -0
- package/kits/physics-2d/play/behaviors/Video.js +93 -0
- package/kits/physics-3d/CLAUDE.md +25 -1651
- package/kits/physics-3d/behaviors/Body.jsx +3 -0
- package/kits/physics-3d/behaviors/Model.jsx +3 -0
- package/kits/physics-3d/behaviors/Player.jsx +35 -18
- package/kits/physics-3d/behaviors/Shape.jsx +3 -0
- package/kits/physics-3d/behaviors/Solid.jsx +3 -0
- package/kits/physics-3d/behaviors/Transform.jsx +3 -0
- package/kits/physics-3d/castle.json +3 -3
- package/kits/physics-3d/docs/engine-camera.md +542 -0
- package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
- package/kits/physics-3d/docs/engine-load.md +149 -0
- package/kits/physics-3d/docs/engine-look.md +114 -0
- package/kits/physics-3d/docs/engine-shadows.md +372 -0
- package/kits/physics-3d/docs/engine-skip-work.md +187 -0
- package/kits/physics-3d/docs/engine-sky.md +198 -0
- package/kits/physics-3d/docs/engine-static-actors.md +226 -0
- package/kits/physics-3d/docs/engine-view.md +37 -0
- package/kits/physics-3d/docs/pxmodel-format.md +1 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -333
- package/kits/physics-3d/engine3d/actornode.js +1 -0
- package/kits/physics-3d/engine3d/branches.js +3 -13
- package/kits/physics-3d/engine3d/cage.js +2 -7
- package/kits/physics-3d/engine3d/cageops.js +2 -17
- package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
- package/kits/physics-3d/engine3d/framecap.js +4 -1
- package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
- package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
- package/kits/physics-3d/engine3d/gait.js +8 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/look.js +7 -0
- package/kits/physics-3d/engine3d/modelFiles.js +3 -17
- package/kits/physics-3d/engine3d/modelMath.js +49 -0
- package/kits/physics-3d/engine3d/modelready.js +16 -0
- package/kits/physics-3d/engine3d/motion.js +3 -3
- package/kits/physics-3d/engine3d/nearshadows.js +77 -10
- package/kits/physics-3d/engine3d/orbitinput.js +59 -25
- package/kits/physics-3d/engine3d/partgeometry.js +1 -16
- package/kits/physics-3d/engine3d/paths.js +1 -9
- package/kits/physics-3d/engine3d/playTimings.js +50 -0
- package/kits/physics-3d/engine3d/playerRun.js +372 -0
- package/kits/physics-3d/engine3d/pxmodel.js +3 -3
- package/kits/physics-3d/engine3d/rapier.js +27 -0
- package/kits/physics-3d/engine3d/scatter.js +1 -11
- package/kits/physics-3d/engine3d/shadowfade.js +23 -15
- package/kits/physics-3d/engine3d/sky.js +1 -1
- package/kits/physics-3d/engine3d/squarefirst.js +177 -0
- package/kits/physics-3d/engine3d/stillshadows.js +399 -0
- package/kits/physics-3d/engine3d/sweep.js +1 -25
- package/kits/physics-3d/engine3d/world3d.js +468 -18
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +6 -3
- package/kits/physics-3d/package-lock.json +7 -0
- package/kits/physics-3d/package.json +5 -1
- package/kits/physics-3d/play/behaviors/Body.js +31 -0
- package/kits/physics-3d/play/behaviors/Door.js +37 -0
- package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
- package/kits/physics-3d/play/behaviors/Model.js +23 -0
- package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
- package/kits/physics-3d/play/behaviors/Player.js +1204 -0
- package/kits/physics-3d/play/behaviors/Shape.js +47 -0
- package/kits/physics-3d/play/behaviors/Solid.js +16 -0
- package/kits/physics-3d/play/behaviors/Transform.js +29 -0
- package/kits/physics-3d/pnpm-lock.yaml +8 -0
- package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
- package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
- package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +52 -4
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +6 -3
- package/kits/physics-3d/scripts/test-frame-cap.mjs +1 -1
- package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
- package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
- package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1 -1
- package/kits/physics-3d/scripts/test-near-shadows.mjs +2 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +88 -7
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +40 -3
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +75 -1
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
- package/kits/physics-3d/scripts/test-sky.mjs +1 -1
- package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +3 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +5 -2
- package/kits/physics-3d/scripts/test-steady-hover.mjs +5 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/systems/physics3d.js +37 -4
- package/kits/real-time/castle.json +2 -2
- package/kits/real-time/code/client/connection.js +33 -10
- package/kits/real-time/code/client/gameHooks.js +2 -0
- package/kits/real-time/code/client/joinOverlay.js +9 -4
- package/kits/real-time/code/server/session.js +6 -4
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
// Mutation notifications for the opt-in frozen-statics path. Each consumer
|
|
2
|
+
// owns its pending set: physics consuming a write must not hide it from drawing.
|
|
3
|
+
// Only scene-owned plain data can be observed completely. An externally
|
|
4
|
+
// supplied object can still be written through its original reference, so its
|
|
5
|
+
// actor falls back to the ordinary checks for the rest of this load.
|
|
6
|
+
const rawValues = new WeakMap();
|
|
7
|
+
const rawOwners = new WeakMap();
|
|
8
|
+
const ACTS = ['update', 'onEnable', 'onDisable'];
|
|
9
|
+
|
|
10
|
+
export class FrozenActors {
|
|
11
|
+
constructor(scene) {
|
|
12
|
+
this.scene = scene;
|
|
13
|
+
this.records = new Map();
|
|
14
|
+
this.live = new Set();
|
|
15
|
+
this.consumers = new Set();
|
|
16
|
+
this.serial = 0;
|
|
17
|
+
this.writingPhysics = 0;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
add(actor, spawned = false) {
|
|
21
|
+
const record = { actor, order: this.serial++, unsafe: false, proxies: new WeakMap() };
|
|
22
|
+
this.records.set(actor, record);
|
|
23
|
+
const changed = () => this.mark(actor);
|
|
24
|
+
const external = () => this.release(actor);
|
|
25
|
+
const componentExternal = () => { record.componentsUnsafe = true; external(); };
|
|
26
|
+
const observe = value => observeData(value, record, changed, componentExternal);
|
|
27
|
+
// Spawn merges own props shallowly; nested objects may still belong to
|
|
28
|
+
// the caller. They need the ordinary per-frame check for retained aliases.
|
|
29
|
+
if (spawned && Object.values(actor.components).some(props => Object.values(props ?? {}).some(value => value && typeof value === 'object'))) {
|
|
30
|
+
record.unsafe = true;
|
|
31
|
+
}
|
|
32
|
+
for (const [name, props] of Object.entries(actor.components)) {
|
|
33
|
+
const defaults = this.scene.behaviors.get(name)?.defaultProps;
|
|
34
|
+
if (Object.entries(props ?? {}).some(([key, value]) => value && typeof value === 'object' && value === defaults?.[key])) record.unsafe = true;
|
|
35
|
+
}
|
|
36
|
+
observeSlot(actor, 'components', observe, changed, componentExternal);
|
|
37
|
+
record.componentsUnsafe = record.unsafe;
|
|
38
|
+
observeSlot(actor, 'static', value => value, changed, external);
|
|
39
|
+
// Runtime is deliberately not serialized, but physics/network quaternion
|
|
40
|
+
// writes and tier render-sleep changes affect placement just like Transform.
|
|
41
|
+
observeSlot(actor, 'runtime', value => observeRuntime(value, record, changed, external), changed, external);
|
|
42
|
+
this.mark(actor);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
remove(actor) {
|
|
46
|
+
this.records.delete(actor);
|
|
47
|
+
this.live.delete(actor);
|
|
48
|
+
for (const consumer of this.consumers) consumer.dirty.add(actor);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
isStatic(actor, physics = false) {
|
|
52
|
+
const record = this.records.get(actor);
|
|
53
|
+
if (!record || (physics ? record.componentsUnsafe : record.unsafe) || actor.static !== true) return false;
|
|
54
|
+
if (['dynamic', 'kinematic'].includes(actor.components.Body?.type)) return false;
|
|
55
|
+
return !Object.keys(actor.components).some(name => ACTS.some(hook => typeof this.scene.behaviors.get(name)?.prototype?.[hook] === 'function'));
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
mark(actor) {
|
|
59
|
+
if (!this.records.has(actor)) return;
|
|
60
|
+
if (this.isStatic(actor)) this.live.delete(actor);
|
|
61
|
+
else this.live.add(actor);
|
|
62
|
+
for (const consumer of this.consumers) {
|
|
63
|
+
if (consumer.physics && this.writingPhysics > 0) continue;
|
|
64
|
+
consumer.dirty.add(actor);
|
|
65
|
+
consumer.changed?.(actor);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
release(actor) {
|
|
70
|
+
const record = this.records.get(actor);
|
|
71
|
+
if (!record) return;
|
|
72
|
+
record.unsafe = true;
|
|
73
|
+
this.mark(actor);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
markAll() {
|
|
77
|
+
for (const actor of this.records.keys()) this.mark(actor);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
consumer(changed, reset, physics = false) {
|
|
81
|
+
const owner = this;
|
|
82
|
+
const consumer = {
|
|
83
|
+
dirty: new Set(this.records.keys()), changed, reset, physics,
|
|
84
|
+
take(withLive = true) {
|
|
85
|
+
const actors = new Set(this.dirty);
|
|
86
|
+
this.dirty.clear();
|
|
87
|
+
if (withLive) for (const actor of owner.live) actors.add(actor);
|
|
88
|
+
return [...actors].sort((a, b) => (a.components.Layout?.z ?? 0) - (b.components.Layout?.z ?? 0) ||
|
|
89
|
+
(owner.records.get(a)?.order ?? -1) - (owner.records.get(b)?.order ?? -1));
|
|
90
|
+
},
|
|
91
|
+
dispose() { owner.consumers.delete(this); this.dirty.clear(); this.changed = null; this.reset = null; },
|
|
92
|
+
};
|
|
93
|
+
this.consumers.add(consumer);
|
|
94
|
+
return consumer;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
dispose() {
|
|
98
|
+
for (const consumer of [...this.consumers]) { consumer.reset?.(); consumer.dispose(); }
|
|
99
|
+
this.records.clear();
|
|
100
|
+
this.live.clear();
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
function observeRuntime(runtime, record, changed, external) {
|
|
105
|
+
if (!runtime || typeof runtime !== 'object' || ![Object.prototype, null].includes(Object.getPrototypeOf(runtime))) { external(); return runtime; }
|
|
106
|
+
const watched = key => key === 'quat' || key === 'renderSleep';
|
|
107
|
+
return new Proxy(runtime, {
|
|
108
|
+
get(target, key, receiver) {
|
|
109
|
+
const value = Reflect.get(target, key, receiver);
|
|
110
|
+
return key === 'quat' ? observeData(value, record, changed, external) : value;
|
|
111
|
+
},
|
|
112
|
+
set(target, key, value) {
|
|
113
|
+
const previous = target[key];
|
|
114
|
+
const ok = Reflect.set(target, key, value);
|
|
115
|
+
if (ok && watched(key) && !Object.is(previous, value)) {
|
|
116
|
+
if (value && typeof value === 'object') external();
|
|
117
|
+
changed();
|
|
118
|
+
}
|
|
119
|
+
return ok;
|
|
120
|
+
},
|
|
121
|
+
deleteProperty(target, key) {
|
|
122
|
+
const ok = Reflect.deleteProperty(target, key);
|
|
123
|
+
if (ok && watched(key)) changed();
|
|
124
|
+
return ok;
|
|
125
|
+
},
|
|
126
|
+
defineProperty(target, key, descriptor) {
|
|
127
|
+
const ok = Reflect.defineProperty(target, key, descriptor);
|
|
128
|
+
if (ok && watched(key)) { external(); changed(); }
|
|
129
|
+
return ok;
|
|
130
|
+
},
|
|
131
|
+
});
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
function observeSlot(object, key, observe, changed, external) {
|
|
135
|
+
let value = observe(object[key]);
|
|
136
|
+
const enumerable = Object.prototype.propertyIsEnumerable.call(object, key);
|
|
137
|
+
Object.defineProperty(object, key, {
|
|
138
|
+
configurable: true, enumerable,
|
|
139
|
+
get: () => value,
|
|
140
|
+
set(next) {
|
|
141
|
+
if (Object.is(value, next)) return;
|
|
142
|
+
if (next && typeof next === 'object') external();
|
|
143
|
+
value = observe(next);
|
|
144
|
+
changed();
|
|
145
|
+
},
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
function observeData(value, record, changed, external, depth = 0) {
|
|
150
|
+
if (!value || typeof value !== 'object') return value;
|
|
151
|
+
value = rawValues.get(value) ?? value;
|
|
152
|
+
if (record.proxies.has(value)) return record.proxies.get(value);
|
|
153
|
+
const proto = Object.getPrototypeOf(value);
|
|
154
|
+
const descriptors = Object.getOwnPropertyDescriptors(value);
|
|
155
|
+
if (depth >= 32 || (proto !== Object.prototype && proto !== Array.prototype && proto !== null) ||
|
|
156
|
+
'toJSON' in value || Reflect.ownKeys(descriptors).some(key =>
|
|
157
|
+
!('value' in descriptors[key]) || (!descriptors[key].configurable && !(Array.isArray(value) && key === 'length')))) {
|
|
158
|
+
record.unsafe = true;
|
|
159
|
+
return value;
|
|
160
|
+
}
|
|
161
|
+
const previous = rawOwners.get(value);
|
|
162
|
+
if (previous && previous !== external) { previous(); external(); }
|
|
163
|
+
rawOwners.set(value, external);
|
|
164
|
+
const proxy = new Proxy(value, {
|
|
165
|
+
get(target, key, receiver) {
|
|
166
|
+
const descriptor = Reflect.getOwnPropertyDescriptor(target, key);
|
|
167
|
+
if (descriptor && !descriptor.configurable && descriptor.writable === false) return descriptor.value;
|
|
168
|
+
return observeData(Reflect.get(target, key, receiver), record, changed, external, depth + 1);
|
|
169
|
+
},
|
|
170
|
+
getOwnPropertyDescriptor(target, key) {
|
|
171
|
+
const descriptor = Reflect.getOwnPropertyDescriptor(target, key);
|
|
172
|
+
if (descriptor?.configurable && 'value' in descriptor) descriptor.value = observeData(descriptor.value, record, changed, external, depth + 1);
|
|
173
|
+
return descriptor;
|
|
174
|
+
},
|
|
175
|
+
set(target, key, next) {
|
|
176
|
+
if (Object.is(target[key], next)) return true;
|
|
177
|
+
if (next && typeof next === 'object') external();
|
|
178
|
+
const ok = Reflect.set(target, key, rawValues.get(next) ?? next);
|
|
179
|
+
if (ok) changed();
|
|
180
|
+
return ok;
|
|
181
|
+
},
|
|
182
|
+
deleteProperty(target, key) {
|
|
183
|
+
const had = key in target;
|
|
184
|
+
const ok = Reflect.deleteProperty(target, key);
|
|
185
|
+
if (had && ok) changed();
|
|
186
|
+
return ok;
|
|
187
|
+
},
|
|
188
|
+
defineProperty(target, key, descriptor) {
|
|
189
|
+
// Descriptors can install accessors or make future observation illegal.
|
|
190
|
+
external();
|
|
191
|
+
const ok = Reflect.defineProperty(target, key, descriptor);
|
|
192
|
+
if (ok) changed();
|
|
193
|
+
return ok;
|
|
194
|
+
},
|
|
195
|
+
setPrototypeOf(target, next) { external(); return Reflect.setPrototypeOf(target, next); },
|
|
196
|
+
preventExtensions(target) { external(); return Reflect.preventExtensions(target); },
|
|
197
|
+
});
|
|
198
|
+
record.proxies.set(value, proxy);
|
|
199
|
+
rawValues.set(proxy, value);
|
|
200
|
+
// Discover unsupported nested data now, before deciding this actor can freeze.
|
|
201
|
+
for (const key of Object.keys(value)) observeData(value[key], record, changed, external, depth + 1);
|
|
202
|
+
return proxy;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
// structuredClone cannot consume a Proxy. Strip only our wrappers before the
|
|
206
|
+
// usual clone, retaining aliases/cycles and leaving other structured data alone.
|
|
207
|
+
export function cloneFrozenData(value) {
|
|
208
|
+
const seen = new Map();
|
|
209
|
+
function plain(item) {
|
|
210
|
+
item = rawValues.get(item) ?? item;
|
|
211
|
+
if (!item || typeof item !== 'object') return item;
|
|
212
|
+
if (seen.has(item)) return seen.get(item);
|
|
213
|
+
if (item instanceof Map) {
|
|
214
|
+
const copy = new Map();
|
|
215
|
+
seen.set(item, copy);
|
|
216
|
+
for (const [key, value] of item) copy.set(plain(key), plain(value));
|
|
217
|
+
return copy;
|
|
218
|
+
}
|
|
219
|
+
if (item instanceof Set) {
|
|
220
|
+
const copy = new Set();
|
|
221
|
+
seen.set(item, copy);
|
|
222
|
+
for (const value of item) copy.add(plain(value));
|
|
223
|
+
return copy;
|
|
224
|
+
}
|
|
225
|
+
const proto = Object.getPrototypeOf(item);
|
|
226
|
+
if (!Array.isArray(item) && proto !== Object.prototype && proto !== null) return item;
|
|
227
|
+
const copy = Array.isArray(item) ? new Array(item.length) : {};
|
|
228
|
+
seen.set(item, copy);
|
|
229
|
+
for (const key of Object.keys(item)) Object.defineProperty(copy, key, { value: plain(item[key]), enumerable: true, configurable: true, writable: true });
|
|
230
|
+
return copy;
|
|
231
|
+
}
|
|
232
|
+
return structuredClone(plain(value));
|
|
233
|
+
}
|
|
@@ -10,6 +10,7 @@ import { updateTaps } from './tap';
|
|
|
10
10
|
import { nextStillVersion, stillClock, StillKeeper } from './stillClock';
|
|
11
11
|
import { readSkyKey } from './skyKey';
|
|
12
12
|
import { actorUpdateDt } from './updateBudget';
|
|
13
|
+
import { FrozenActors, cloneFrozenData } from './frozenActors';
|
|
13
14
|
|
|
14
15
|
const CARD_WIDTH = 500;
|
|
15
16
|
const CARD_HEIGHT = 700;
|
|
@@ -141,6 +142,13 @@ function sceneKeepsStaticActors(data) {
|
|
|
141
142
|
return data?.engine?.staticActors === true && data?.engine?.skipUnchangedActors === true;
|
|
142
143
|
}
|
|
143
144
|
|
|
145
|
+
function sceneFreezesStatics(data) {
|
|
146
|
+
if (data?.engine?.frozenStatics !== true) return false;
|
|
147
|
+
if (sceneKeepsStaticActors(data)) return true;
|
|
148
|
+
console.warn('frozenStatics requires skipUnchangedActors and staticActors; ignoring frozenStatics');
|
|
149
|
+
return false;
|
|
150
|
+
}
|
|
151
|
+
|
|
144
152
|
// What a behaviour class does on its own, frame by frame or when switched on
|
|
145
153
|
// or off. An actor with a component of such a class is never still.
|
|
146
154
|
const ACTS = ['update', 'onEnable', 'onDisable'];
|
|
@@ -262,6 +270,16 @@ export class SceneRuntime {
|
|
|
262
270
|
return this.#keepsStatic;
|
|
263
271
|
}
|
|
264
272
|
|
|
273
|
+
#frozen = null;
|
|
274
|
+
#frozenUpdates = null;
|
|
275
|
+
|
|
276
|
+
get frozenActors() { return this.#frozen; }
|
|
277
|
+
get freezesStatics() { return this.#frozen !== null; }
|
|
278
|
+
|
|
279
|
+
// Capability, independent of scene keys. Older published runtimes have no
|
|
280
|
+
// fence; kits must check this marker before installing beforeBehavior.
|
|
281
|
+
get callsBeforeBehavior() { return true; }
|
|
282
|
+
|
|
265
283
|
// For a scene that asked: the actors that are still, or null for a scene
|
|
266
284
|
// that did not. An actor is still when its scene file marked it
|
|
267
285
|
// `"static": true`, it has no `Body`, none of its components' classes acts on
|
|
@@ -309,6 +327,11 @@ export class SceneRuntime {
|
|
|
309
327
|
// from the frame of the touch on. Costs nothing for an actor that is not
|
|
310
328
|
// still, and does nothing in a scene that did not ask for `staticActors`.
|
|
311
329
|
touch(actorOrId) {
|
|
330
|
+
if (this.#frozen) {
|
|
331
|
+
const actor = typeof actorOrId === 'string' ? this.actors.get(actorOrId) : actorOrId;
|
|
332
|
+
if (actor) this.#frozen.mark(actor);
|
|
333
|
+
return;
|
|
334
|
+
}
|
|
312
335
|
if (this.#still === null) return;
|
|
313
336
|
const actor = typeof actorOrId === 'string' ? this.actors.get(actorOrId) : actorOrId;
|
|
314
337
|
if (!actor) return;
|
|
@@ -320,6 +343,7 @@ export class SceneRuntime {
|
|
|
320
343
|
// load. For a world that cannot leave actors alone (the 3d kit's scene
|
|
321
344
|
// editor, a world drawing copies of a model together).
|
|
322
345
|
releaseStill() {
|
|
346
|
+
if (this.#frozen) for (const actor of this.actors.values()) this.#frozen.release(actor);
|
|
323
347
|
if (this.#still === null || this.#still.size === 0) return;
|
|
324
348
|
for (const actor of this.#still) this.#touched.add(actor.id);
|
|
325
349
|
this.#noneStill();
|
|
@@ -359,20 +383,22 @@ export class SceneRuntime {
|
|
|
359
383
|
// and returned, with no update entered from inside it and the still set
|
|
360
384
|
// unmoved; a throw anywhere in it, or an update inside it, leaves nothing
|
|
361
385
|
// adopted.
|
|
362
|
-
#updateHoldingStill(dt) {
|
|
386
|
+
#updateHoldingStill(dt, frozenPass) {
|
|
363
387
|
const keeper = this.#keeper;
|
|
364
388
|
const pass = keeper.begin(this.#stillVersion);
|
|
365
389
|
let completed = false;
|
|
366
390
|
try {
|
|
367
391
|
this.time += dt;
|
|
368
392
|
updateTaps(this);
|
|
369
|
-
for (const actor of this.getActors()) {
|
|
393
|
+
for (const actor of frozenPass ? frozenPass.take() : this.getActors()) {
|
|
370
394
|
// A still actor has no component that updates or is told of being
|
|
371
395
|
// switched on or off, and was run with the rest by the update that
|
|
372
396
|
// adopted. Once this update is no longer alone (a behaviour updated
|
|
373
397
|
// the scene from inside it) or the set has changed (one touched an
|
|
374
398
|
// actor, or loaded a scene), the rest of the loop runs every actor.
|
|
375
|
-
if (
|
|
399
|
+
if (frozenPass) {
|
|
400
|
+
if (this.actors.get(actor.id) !== actor || this.isActorSleeping(actor)) continue;
|
|
401
|
+
} else if (pass.settled && keeper.alone(pass, this.#stillVersion) && this.#still.has(actor)) continue;
|
|
376
402
|
const actorDt = actorUpdateDt(actor, dt);
|
|
377
403
|
if (actorDt === null) continue;
|
|
378
404
|
this.#syncEnabled(actor);
|
|
@@ -490,6 +516,7 @@ export class SceneRuntime {
|
|
|
490
516
|
// the difference that matters to a system holding something the browser keeps
|
|
491
517
|
// doing on its own -- a playing sound outlives its scene otherwise.
|
|
492
518
|
dispose() {
|
|
519
|
+
this.#frozen?.dispose();
|
|
493
520
|
for (const system of this.systems) system.dispose?.(this);
|
|
494
521
|
}
|
|
495
522
|
|
|
@@ -527,6 +554,9 @@ export class SceneRuntime {
|
|
|
527
554
|
// (`setBehaviors` doesn't touch the cache directly; a stale entry is simply
|
|
528
555
|
// caught here on next access).
|
|
529
556
|
#instanceFor(actor, name, Behavior, props) {
|
|
557
|
+
// Optional kit fence before constructors or any consumer callback. It
|
|
558
|
+
// also covers collisions, taps, enabled transitions and direct behavior().
|
|
559
|
+
this.beforeBehavior?.(actor, name);
|
|
530
560
|
const cache = (actor.runtime.$behaviors ??= new Map());
|
|
531
561
|
const cached = cache.get(name);
|
|
532
562
|
if (cached && cached.constructor === Behavior) return cached;
|
|
@@ -564,9 +594,44 @@ export class SceneRuntime {
|
|
|
564
594
|
}
|
|
565
595
|
// A class may have gained or lost an `update`.
|
|
566
596
|
if (this.#still !== null) this.#findStill();
|
|
597
|
+
this.#frozen?.markAll();
|
|
567
598
|
}
|
|
568
599
|
|
|
600
|
+
// Lazily allocated by a kit that streams a scene. Sleeping actors retain
|
|
601
|
+
// ID lookup, components, behavior state and serialization; live passes only
|
|
602
|
+
// visit awake actors. Spawns wake their ID and loads discard the sleep set.
|
|
603
|
+
#awakeActors = null;
|
|
604
|
+
#sleepingActors = null;
|
|
605
|
+
|
|
606
|
+
setActorSleeping(actorOrId, sleeping) {
|
|
607
|
+
const actor = typeof actorOrId === 'string' ? this.actors.get(actorOrId) : actorOrId;
|
|
608
|
+
if (!actor || this.actors.get(actor.id) !== actor) return false;
|
|
609
|
+
this.#frozen?.mark(actor);
|
|
610
|
+
if (!sleeping && !this.#awakeActors) return true;
|
|
611
|
+
this.#awakeActors ??= new Map(this.actors);
|
|
612
|
+
this.#sleepingActors ??= new Set();
|
|
613
|
+
if (sleeping) {
|
|
614
|
+
this.touch(actor);
|
|
615
|
+
this.#awakeActors.delete(actor.id);
|
|
616
|
+
this.#sleepingActors.add(actor.id);
|
|
617
|
+
} else {
|
|
618
|
+
this.#sleepingActors.delete(actor.id);
|
|
619
|
+
this.#awakeActors.set(actor.id, actor);
|
|
620
|
+
if (!this.#sleepingActors.size) {
|
|
621
|
+
this.#awakeActors = null;
|
|
622
|
+
this.#sleepingActors = null;
|
|
623
|
+
}
|
|
624
|
+
}
|
|
625
|
+
return true;
|
|
626
|
+
}
|
|
627
|
+
|
|
628
|
+
isActorSleeping(actor) { return this.#sleepingActors?.has(actor.id) === true; }
|
|
629
|
+
|
|
569
630
|
load(sceneData) {
|
|
631
|
+
if (this.#frozen) sceneData = cloneFrozenData(sceneData);
|
|
632
|
+
this.#frozen?.dispose();
|
|
633
|
+
this.#frozen = null;
|
|
634
|
+
this.#frozenUpdates = null;
|
|
570
635
|
// No actor of the scene being left is still from here on, whether or not
|
|
571
636
|
// the load completes.
|
|
572
637
|
if (this.#still !== null) {
|
|
@@ -580,6 +645,8 @@ export class SceneRuntime {
|
|
|
580
645
|
// simulation state (body positions, joints) would carry it across the load.
|
|
581
646
|
// No-op on the constructor's first load, before any system is registered.
|
|
582
647
|
for (const system of this.systems) system.reset?.(this);
|
|
648
|
+
this.#awakeActors = null;
|
|
649
|
+
this.#sleepingActors = null;
|
|
583
650
|
this.data = structuredClone(sceneData);
|
|
584
651
|
this.#skipUnchanged = sceneSkipsUnchangedActors(this.data);
|
|
585
652
|
this.#nearShadowDistance = sceneNearShadowDistance(this.data);
|
|
@@ -617,6 +684,10 @@ export class SceneRuntime {
|
|
|
617
684
|
this.#touched = new Set();
|
|
618
685
|
this.#findStill();
|
|
619
686
|
}
|
|
687
|
+
if (sceneFreezesStatics(this.data)) {
|
|
688
|
+
this.#frozen = new FrozenActors(this);
|
|
689
|
+
for (const actor of this.actors.values()) this.#frozen.add(actor);
|
|
690
|
+
}
|
|
620
691
|
}
|
|
621
692
|
|
|
622
693
|
// Read and parse a scene file by name, returning its scene data. Use this
|
|
@@ -673,6 +744,7 @@ export class SceneRuntime {
|
|
|
673
744
|
}
|
|
674
745
|
|
|
675
746
|
serialize() {
|
|
747
|
+
if (this.#frozen) return cloneFrozenData(this.data);
|
|
676
748
|
return structuredClone(this.data);
|
|
677
749
|
}
|
|
678
750
|
|
|
@@ -689,7 +761,7 @@ export class SceneRuntime {
|
|
|
689
761
|
|
|
690
762
|
getActors() {
|
|
691
763
|
if (this.#skipUnchanged) return this.#actorsSkippingSort();
|
|
692
|
-
return [...this.actors.values()].sort((a, b) => {
|
|
764
|
+
return [...(this.#awakeActors ?? this.actors).values()].sort((a, b) => {
|
|
693
765
|
const az = getLayout(a)?.z ?? 0;
|
|
694
766
|
const bz = getLayout(b)?.z ?? 0;
|
|
695
767
|
return az - bz;
|
|
@@ -699,7 +771,7 @@ export class SceneRuntime {
|
|
|
699
771
|
// `getActors` for a scene that set `skipUnchangedActors`: the same list,
|
|
700
772
|
// sorted only when it is not already in order.
|
|
701
773
|
#actorsSkippingSort() {
|
|
702
|
-
const actors = [...this.actors.values()];
|
|
774
|
+
const actors = [...(this.#awakeActors ?? this.actors).values()];
|
|
703
775
|
if (alreadyInLayoutOrder(actors)) return actors;
|
|
704
776
|
return actors.sort((a, b) => (getLayout(a)?.z ?? 0) - (getLayout(b)?.z ?? 0));
|
|
705
777
|
}
|
|
@@ -763,6 +835,9 @@ export class SceneRuntime {
|
|
|
763
835
|
this.#initActor(next);
|
|
764
836
|
this.data.actors.push(next);
|
|
765
837
|
this.actors.set(id, next);
|
|
838
|
+
this.#sleepingActors?.delete(id);
|
|
839
|
+
this.#awakeActors?.set(id, next);
|
|
840
|
+
this.#frozen?.add(next, true);
|
|
766
841
|
return next;
|
|
767
842
|
}
|
|
768
843
|
|
|
@@ -779,8 +854,11 @@ export class SceneRuntime {
|
|
|
779
854
|
despawnActor(actorId) {
|
|
780
855
|
const actor = this.actors.get(actorId);
|
|
781
856
|
if (!actor) return false;
|
|
857
|
+
this.#frozen?.remove(actor);
|
|
782
858
|
if (this.#still !== null && this.#still.delete(actor)) this.#stillVersion = nextStillVersion();
|
|
783
859
|
this.actors.delete(actorId);
|
|
860
|
+
this.#sleepingActors?.delete(actorId);
|
|
861
|
+
this.#awakeActors?.delete(actorId);
|
|
784
862
|
const idx = this.data.actors.findIndex((a) => a.id === actorId);
|
|
785
863
|
if (idx !== -1) this.data.actors.splice(idx, 1);
|
|
786
864
|
return true;
|
|
@@ -928,6 +1006,10 @@ export class SceneRuntime {
|
|
|
928
1006
|
}
|
|
929
1007
|
|
|
930
1008
|
update(dt) {
|
|
1009
|
+
if (this.#frozen) {
|
|
1010
|
+
this.#updateHoldingStill(dt, this.#frozenUpdates ??= this.#frozen.consumer());
|
|
1011
|
+
return;
|
|
1012
|
+
}
|
|
931
1013
|
// A scene that holds actors still (`"engine": { "staticActors": true }`).
|
|
932
1014
|
if (this.#still !== null) {
|
|
933
1015
|
this.#updateHoldingStill(dt);
|
|
@@ -28,7 +28,7 @@ export default [
|
|
|
28
28
|
},
|
|
29
29
|
},
|
|
30
30
|
{
|
|
31
|
-
files: ['engine/**/*.{js,jsx}', 'editors/**/*.{js,jsx}', 'behaviors/**/*.{js,jsx}', '*.js', '*.jsx'],
|
|
31
|
+
files: ['play/**/*.{js,jsx}', 'engine/**/*.{js,jsx}', 'editors/**/*.{js,jsx}', 'behaviors/**/*.{js,jsx}', '*.js', '*.jsx'],
|
|
32
32
|
languageOptions: {
|
|
33
33
|
ecmaVersion: 'latest',
|
|
34
34
|
sourceType: 'module',
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
// Generated from ../../behaviors/AnalogStick.jsx; run npm run sync:play-behaviors.
|
|
2
|
+
import { acquirePress, GREEDY_CLAIM, length, clampLength } from '../../engine/physics/controls';
|
|
3
|
+
|
|
4
|
+
// AnalogStick: on-screen virtual joystick (press anywhere) that drives the
|
|
5
|
+
// actor with OG-style force mode — ramp in, hard top speed, idle-only brake.
|
|
6
|
+
// Screen-fixed: the ring stays under the thumb while a Camera scrolls, and does
|
|
7
|
+
// not rotate with the actor. Needs a RigidBody (dynamic) + Collider. Never
|
|
8
|
+
// touches an undriven axis.
|
|
9
|
+
//
|
|
10
|
+
// speed -> top speed at full deflection (px per fixed step).
|
|
11
|
+
// rampTime -> seconds from rest to speed at full deflection (0 = instant).
|
|
12
|
+
// slowDown -> deceleration while idle, speed units lost per second (0 = coast).
|
|
13
|
+
// turnBoost -> extra accel when velocity points away from the stick (OG turnFriction).
|
|
14
|
+
// maxRadius -> stick throw radius in pixels.
|
|
15
|
+
// axes -> 'horizontal' / 'vertical' / 'both'.
|
|
16
|
+
//
|
|
17
|
+
// Sibling hooks (fired on this actor only): onAnalogStickBegin / onAnalogStickEnd
|
|
18
|
+
// (actor, scene) — begin on first nonzero deflection, end on release or disable.
|
|
19
|
+
//
|
|
20
|
+
// Force-mode math lives here (only consumer): stickDrive / stickBrake return
|
|
21
|
+
// velocity deltas via applyImpulse — mass-independent, composable, and
|
|
22
|
+
// restricted to driven axes so gravity on an undriven axis is never clamped.
|
|
23
|
+
// Stick displacement from origin, clamped to maxRadius.
|
|
24
|
+
function stickVector(pointer, origin, maxRadius = 60) {
|
|
25
|
+
return clampLength({ x: pointer.x - origin.x, y: pointer.y - origin.y }, maxRadius);
|
|
26
|
+
}
|
|
27
|
+
// Card coords before the camera — for screen-fixed controls reading a pointer.
|
|
28
|
+
function screenPoint(pointer) {
|
|
29
|
+
return { x: pointer.screenX, y: pointer.screenY };
|
|
30
|
+
}
|
|
31
|
+
// Keep only the axes the stick is allowed to drive. An undriven axis (gravity
|
|
32
|
+
// in a platformer) must never be clamped or braked by the stick.
|
|
33
|
+
function drivenAxes(v, axes) {
|
|
34
|
+
return {
|
|
35
|
+
x: axes === 'vertical' ? 0 : v.x,
|
|
36
|
+
y: axes === 'horizontal' ? 0 : v.y,
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
// Smallest signed angle from `from` to `to`, wrapped into [−π, π].
|
|
40
|
+
function angleDelta(from, to) {
|
|
41
|
+
let d = Math.atan2(to.y, to.x) - Math.atan2(from.y, from.x);
|
|
42
|
+
if (d > Math.PI)
|
|
43
|
+
d -= 2 * Math.PI;
|
|
44
|
+
if (d < -Math.PI)
|
|
45
|
+
d += 2 * Math.PI;
|
|
46
|
+
return d;
|
|
47
|
+
}
|
|
48
|
+
// Velocity delta while held: accelerate toward deflection × speed with turn
|
|
49
|
+
// boost on reversals, then clamp driven axes to `speed`. Impulse only.
|
|
50
|
+
function stickDrive(velocity, deflection, props = {}, dt) {
|
|
51
|
+
const speed = props.speed ?? 6;
|
|
52
|
+
const rampTime = props.rampTime ?? 0.2;
|
|
53
|
+
const turnBoost = props.turnBoost ?? 3;
|
|
54
|
+
const axes = props.axes ?? 'both';
|
|
55
|
+
const vDriven = drivenAxes(velocity, axes);
|
|
56
|
+
let boost = 1;
|
|
57
|
+
if (turnBoost > 0 && length(velocity) > 0 && length(deflection) > 0) {
|
|
58
|
+
boost = 1 + turnBoost * (Math.abs(angleDelta(velocity, deflection)) / Math.PI);
|
|
59
|
+
}
|
|
60
|
+
let delta;
|
|
61
|
+
if (rampTime <= 0) {
|
|
62
|
+
const target = drivenAxes({ x: deflection.x * speed, y: deflection.y * speed }, axes);
|
|
63
|
+
delta = { x: target.x - vDriven.x, y: target.y - vDriven.y };
|
|
64
|
+
}
|
|
65
|
+
else {
|
|
66
|
+
const accel = speed / rampTime;
|
|
67
|
+
delta = drivenAxes({ x: deflection.x * accel * boost * dt, y: deflection.y * accel * boost * dt }, axes);
|
|
68
|
+
const capped = clampLength({ x: vDriven.x + delta.x, y: vDriven.y + delta.y }, speed);
|
|
69
|
+
delta = { x: capped.x - vDriven.x, y: capped.y - vDriven.y };
|
|
70
|
+
}
|
|
71
|
+
return delta;
|
|
72
|
+
}
|
|
73
|
+
// Velocity delta while idle: Coulomb brake on driven axes only.
|
|
74
|
+
// `slowDown` is speed units lost per second (px/step per second). 0 = coast.
|
|
75
|
+
function stickBrake(velocity, props = {}, dt) {
|
|
76
|
+
const slowDown = props.slowDown ?? 20;
|
|
77
|
+
if (slowDown <= 0)
|
|
78
|
+
return { x: 0, y: 0 };
|
|
79
|
+
const axes = props.axes ?? 'both';
|
|
80
|
+
const vDriven = drivenAxes(velocity, axes);
|
|
81
|
+
const len = length(vDriven);
|
|
82
|
+
if (len === 0)
|
|
83
|
+
return { x: 0, y: 0 };
|
|
84
|
+
const reduce = Math.min(len, slowDown * dt);
|
|
85
|
+
const s = -reduce / len;
|
|
86
|
+
return { x: vDriven.x * s, y: vDriven.y * s };
|
|
87
|
+
}
|
|
88
|
+
function fireStickHook(actor, scene, hook) {
|
|
89
|
+
scene.forEachBehavior(actor, (inst) => inst[hook]?.(actor, scene));
|
|
90
|
+
}
|
|
91
|
+
function resetStick(state) {
|
|
92
|
+
state.began = false;
|
|
93
|
+
state.pointerId = null;
|
|
94
|
+
state.origin = null;
|
|
95
|
+
state.knob = null;
|
|
96
|
+
}
|
|
97
|
+
class AnalogStick {
|
|
98
|
+
static behaviorName = 'AnalogStick';
|
|
99
|
+
// Drives a body, so it needs one: Collider + dynamic RigidBody.
|
|
100
|
+
static expectedSiblings = ['Collider', 'RigidBody'];
|
|
101
|
+
static defaultProps = {
|
|
102
|
+
speed: 6,
|
|
103
|
+
rampTime: 0.2,
|
|
104
|
+
slowDown: 20,
|
|
105
|
+
turnBoost: 3,
|
|
106
|
+
maxRadius: 60,
|
|
107
|
+
axes: 'both',
|
|
108
|
+
};
|
|
109
|
+
// `maxRadius` is the stick's travel in px; below ~10 the knob has no usable
|
|
110
|
+
// throw and the control reads as broken. slowDown humanizes to "Slow Down".
|
|
111
|
+
static propertyMeta = {
|
|
112
|
+
speed: { min: 0, step: 0.5 },
|
|
113
|
+
rampTime: { min: 0, step: 0.05 },
|
|
114
|
+
slowDown: { min: 0, step: 1 },
|
|
115
|
+
turnBoost: { min: 0, step: 0.5 },
|
|
116
|
+
maxRadius: { min: 10, step: 5 },
|
|
117
|
+
};
|
|
118
|
+
static initialState = { began: false, pointerId: null, origin: null, knob: null };
|
|
119
|
+
constructor(props) {
|
|
120
|
+
this.props = props;
|
|
121
|
+
}
|
|
122
|
+
// The finger this stick is following, placing it on a fresh press if it isn't
|
|
123
|
+
// following one yet. The stick stays with the finger that placed it, so a
|
|
124
|
+
// second finger elsewhere (another stick, a drag) never yanks it -- and it
|
|
125
|
+
// gives the pointer up if a targeted control outranks its claim.
|
|
126
|
+
trackedPointer(actor, scene) {
|
|
127
|
+
const state = this.state;
|
|
128
|
+
if (state.pointerId != null && scene.ownsPointer(state.pointerId, actor.id)) {
|
|
129
|
+
const held = scene.pointers.get(state.pointerId);
|
|
130
|
+
if (held?.down)
|
|
131
|
+
return held;
|
|
132
|
+
}
|
|
133
|
+
state.pointerId = null;
|
|
134
|
+
// Any fresh press will do -- the stick is placed wherever you touch -- but
|
|
135
|
+
// only one nobody more specific wants.
|
|
136
|
+
const press = acquirePress(scene, actor.id, () => GREEDY_CLAIM);
|
|
137
|
+
if (!press)
|
|
138
|
+
return null;
|
|
139
|
+
state.pointerId = press.id;
|
|
140
|
+
state.origin = { x: press.screenX, y: press.screenY };
|
|
141
|
+
return press;
|
|
142
|
+
}
|
|
143
|
+
update(actor, scene, dt) {
|
|
144
|
+
const state = this.state;
|
|
145
|
+
const p = this.trackedPointer(actor, scene);
|
|
146
|
+
if (p?.down && state.origin) {
|
|
147
|
+
const maxRadius = this.props.maxRadius ?? 60;
|
|
148
|
+
const sp = screenPoint(p);
|
|
149
|
+
const knob = stickVector(sp, state.origin, maxRadius);
|
|
150
|
+
state.knob = knob;
|
|
151
|
+
const deflection = { x: knob.x / maxRadius, y: knob.y / maxRadius };
|
|
152
|
+
const vel = scene.physics.getVelocity(actor);
|
|
153
|
+
scene.physics.applyImpulse(actor, stickDrive(vel, deflection, this.props, dt));
|
|
154
|
+
// OG fires on first movement, not on a still press.
|
|
155
|
+
if (!state.began && length(deflection) > 0) {
|
|
156
|
+
state.began = true;
|
|
157
|
+
fireStickHook(actor, scene, 'onAnalogStickBegin');
|
|
158
|
+
}
|
|
159
|
+
return;
|
|
160
|
+
}
|
|
161
|
+
if (state.began) {
|
|
162
|
+
fireStickHook(actor, scene, 'onAnalogStickEnd');
|
|
163
|
+
}
|
|
164
|
+
resetStick(state);
|
|
165
|
+
// Idle every frame: brake on driven axes only (gravity/momentum elsewhere stay).
|
|
166
|
+
const vel = scene.physics.getVelocity(actor);
|
|
167
|
+
scene.physics.applyImpulse(actor, stickBrake(vel, this.props, dt));
|
|
168
|
+
}
|
|
169
|
+
// Switched off mid-hold: fire end and drop runtime state. `update` stops
|
|
170
|
+
// running once disabled, so this is the only chance to release the gesture.
|
|
171
|
+
onDisable(actor, scene) {
|
|
172
|
+
const state = this.state;
|
|
173
|
+
if (state.began)
|
|
174
|
+
fireStickHook(actor, scene, 'onAnalogStickEnd');
|
|
175
|
+
resetStick(state);
|
|
176
|
+
}
|
|
177
|
+
// Drawn in screen space (drawUi) so the ring stays under the thumb while the
|
|
178
|
+
// camera scrolls, and doesn't rotate with the actor.
|
|
179
|
+
drawUi(actor, scene, ctx) {
|
|
180
|
+
const state = this.state;
|
|
181
|
+
if (!state.origin)
|
|
182
|
+
return;
|
|
183
|
+
const o = state.origin;
|
|
184
|
+
const k = state.knob ?? { x: 0, y: 0 };
|
|
185
|
+
const radius = this.props.maxRadius ?? 60;
|
|
186
|
+
ctx.strokeStyle = 'rgba(255, 255, 255, 0.5)';
|
|
187
|
+
ctx.lineWidth = 3;
|
|
188
|
+
ctx.beginPath();
|
|
189
|
+
ctx.arc(o.x, o.y, radius, 0, Math.PI * 2);
|
|
190
|
+
ctx.stroke();
|
|
191
|
+
ctx.fillStyle = 'rgba(255, 255, 255, 0.85)';
|
|
192
|
+
ctx.beginPath();
|
|
193
|
+
ctx.arc(o.x + k.x, o.y + k.y, 20, 0, Math.PI * 2);
|
|
194
|
+
ctx.fill();
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
export { AnalogStick };
|