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
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
// The kit's default heights may only come down to a clear standing spot
|
|
2
|
-
// (v1.48).
|
|
3
|
-
// clearance rules. Read each solid body's current pose without querying or
|
|
2
|
+
// (v1.48). Read each solid body's current pose without querying or
|
|
4
3
|
// stepping physics; authored Transforms are only for actors without bodies.
|
|
5
4
|
export function standingY(h, at) {
|
|
6
5
|
const size = bodySize(h);
|
|
@@ -54,9 +53,9 @@ export function standingY(h, at) {
|
|
|
54
53
|
return y;
|
|
55
54
|
}
|
|
56
55
|
|
|
57
|
-
//
|
|
58
|
-
//
|
|
59
|
-
function bodySize(h) {
|
|
56
|
+
// Trusted scene template bounds, also used by opted-in friend placement on
|
|
57
|
+
// authored floors. Legacy friend placement keeps its larger envelope.
|
|
58
|
+
export function bodySize(h) {
|
|
60
59
|
const shape = h?.sim?.template?.shape ?? { kind: 'capsule', radius: 0.35, height: 1.4 };
|
|
61
60
|
const halfHeight = shape.kind === 'sphere' ? shape.radius : shape.height / 2;
|
|
62
61
|
const radius = shape.kind === 'box' ? Math.hypot(shape.width, shape.depth) / 2 : shape.radius;
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
// v1.144: the host broker answers at most 8 storage and hub requests in flight
|
|
2
|
+
// per session and refuses the rest with CAULDRON_STORAGE_RATE_LIMITED before
|
|
3
|
+
// forwarding them. A Town arrival alone sends a dozen in one tick, so every
|
|
4
|
+
// handle the kit, real-time and a place reach through the session goes through
|
|
5
|
+
// one queue here, and a refusal that still gets through (a burst from outside
|
|
6
|
+
// the kit's handles) is sent again after a short wait -- but only for a call
|
|
7
|
+
// that is one request, since the refusal says only that its own frame was not
|
|
8
|
+
// forwarded.
|
|
9
|
+
|
|
10
|
+
export const MAX_IN_FLIGHT = 6;
|
|
11
|
+
export const RETRY_MS = [100, 250, 500, 1000, 2000];
|
|
12
|
+
const RATE_LIMITED = 'CAULDRON_STORAGE_RATE_LIMITED';
|
|
13
|
+
// The handles that send storage, hub and character requests. `world.characters`
|
|
14
|
+
// is the same object as `characters` on a world session, and stays one handle.
|
|
15
|
+
const LIMITED = new Set(['storage', 'hub', 'characters', 'world']);
|
|
16
|
+
// Passed through unqueued: the broker gives analytics (`track`) a pool of its
|
|
17
|
+
// own, and `catchUp` awaits the author's `apply` between its requests, so a slot
|
|
18
|
+
// held across it could wait on the queue it is holding.
|
|
19
|
+
const PASS = new Set(['track', 'catchUp']);
|
|
20
|
+
// A save bucket's verbs are plain functions returning the save API's promise.
|
|
21
|
+
const SAVE_VERBS = new Set(['snapshot', 'transaction', 'claim', 'initialize', 'operation']);
|
|
22
|
+
// The SDK splits writes into requests sent one after another past 32 keys or a
|
|
23
|
+
// 316 KiB frame; a retry replays only a write that fits one request (a read may
|
|
24
|
+
// always be read again).
|
|
25
|
+
const CHUNKED = new Set(['set', 'remove']);
|
|
26
|
+
const MAX_KEYS_PER_CALL = 32;
|
|
27
|
+
const MAX_ONE_REQUEST_BYTES = 256 * 1024;
|
|
28
|
+
|
|
29
|
+
const sessions = new WeakMap();
|
|
30
|
+
const encoder = new TextEncoder();
|
|
31
|
+
|
|
32
|
+
function gate(max) {
|
|
33
|
+
let active = 0;
|
|
34
|
+
const waiting = [];
|
|
35
|
+
return {
|
|
36
|
+
acquire() {
|
|
37
|
+
if (active < max) {
|
|
38
|
+
active += 1;
|
|
39
|
+
return Promise.resolve();
|
|
40
|
+
}
|
|
41
|
+
return new Promise((resolve) => waiting.push(resolve));
|
|
42
|
+
},
|
|
43
|
+
release() {
|
|
44
|
+
const next = waiting.shift();
|
|
45
|
+
if (next) {
|
|
46
|
+
next();
|
|
47
|
+
} else {
|
|
48
|
+
active -= 1;
|
|
49
|
+
}
|
|
50
|
+
},
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
|
|
55
|
+
|
|
56
|
+
function oneRequest(key, args) {
|
|
57
|
+
if (!CHUNKED.has(key)) {
|
|
58
|
+
return true;
|
|
59
|
+
}
|
|
60
|
+
const [arg] = args;
|
|
61
|
+
if (Array.isArray(arg)) {
|
|
62
|
+
return arg.length <= MAX_KEYS_PER_CALL;
|
|
63
|
+
}
|
|
64
|
+
if (!arg || typeof arg !== 'object' || Object.keys(arg).length > MAX_KEYS_PER_CALL) {
|
|
65
|
+
return false;
|
|
66
|
+
}
|
|
67
|
+
try {
|
|
68
|
+
// Measured as the SDK sends it: each value JSON-encoded, then the entries
|
|
69
|
+
// encoded again in the request, which escapes every quote a second time.
|
|
70
|
+
const entries = Object.entries(arg).map(([key, value]) => ({ key, value: JSON.stringify(value) }));
|
|
71
|
+
return encoder.encode(JSON.stringify(entries)).length <= MAX_ONE_REQUEST_BYTES;
|
|
72
|
+
} catch {
|
|
73
|
+
return false;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
async function run(limit, key, fn, self, args) {
|
|
78
|
+
const retry = oneRequest(key, args);
|
|
79
|
+
for (let attempt = 0; ; attempt += 1) {
|
|
80
|
+
await limit.gate.acquire();
|
|
81
|
+
try {
|
|
82
|
+
return await fn.apply(self, args);
|
|
83
|
+
} catch (error) {
|
|
84
|
+
if (!retry || error?.code !== RATE_LIMITED || attempt >= RETRY_MS.length) {
|
|
85
|
+
throw error;
|
|
86
|
+
}
|
|
87
|
+
} finally {
|
|
88
|
+
limit.gate.release();
|
|
89
|
+
}
|
|
90
|
+
if (!limit.warned) {
|
|
91
|
+
limit.warned = true;
|
|
92
|
+
console.warn(`[hub] storage busy (${RATE_LIMITED}); retrying`);
|
|
93
|
+
}
|
|
94
|
+
await wait(RETRY_MS[attempt] * (0.75 + Math.random() / 2));
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
// An object with methods of its own, or (one level down) a namespace of handles
|
|
99
|
+
// such as `{ deck }`; data (and a promise) passes through as is.
|
|
100
|
+
function isHandle(value, depth = 1) {
|
|
101
|
+
if (!value || typeof value !== 'object' || Array.isArray(value) || typeof value.then === 'function') {
|
|
102
|
+
return false;
|
|
103
|
+
}
|
|
104
|
+
return Reflect.ownKeys(value).some((key) => {
|
|
105
|
+
const v = Object.getOwnPropertyDescriptor(value, key).value;
|
|
106
|
+
return typeof v === 'function' || (depth > 0 && isHandle(v, depth - 1));
|
|
107
|
+
});
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function wrapFn(limit, key, fn, self) {
|
|
111
|
+
if (PASS.has(key)) {
|
|
112
|
+
return (...args) => fn.apply(self, args);
|
|
113
|
+
}
|
|
114
|
+
// An async method or a save verb is a request; any other plain method builds
|
|
115
|
+
// a handle locally (`user`, `town`, `board`, `target`) or reads a value.
|
|
116
|
+
if (fn.constructor?.name === 'AsyncFunction' || SAVE_VERBS.has(key)) {
|
|
117
|
+
return (...args) => run(limit, key, fn, self, args).then((result) => wrap(limit, result));
|
|
118
|
+
}
|
|
119
|
+
return (...args) => wrap(limit, fn.apply(self, args));
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
// A copy of the handle whose requests queue, memoized so code comparing or
|
|
123
|
+
// keying on a handle (`storage.js`, `npcMemory.js`) sees one object.
|
|
124
|
+
function wrap(limit, value) {
|
|
125
|
+
if (!isHandle(value)) {
|
|
126
|
+
return value;
|
|
127
|
+
}
|
|
128
|
+
const known = limit.handles.get(value);
|
|
129
|
+
if (known) {
|
|
130
|
+
return known;
|
|
131
|
+
}
|
|
132
|
+
const out = Object.create(Object.getPrototypeOf(value));
|
|
133
|
+
limit.handles.set(value, out);
|
|
134
|
+
for (const key of Reflect.ownKeys(value)) {
|
|
135
|
+
const desc = Object.getOwnPropertyDescriptor(value, key);
|
|
136
|
+
if ('value' in desc) {
|
|
137
|
+
const v = desc.value;
|
|
138
|
+
desc.value = typeof v === 'function' ? wrapFn(limit, key, v, value) : wrap(limit, v);
|
|
139
|
+
} else {
|
|
140
|
+
const { get, set } = desc;
|
|
141
|
+
desc.get = get && (() => wrap(limit, get.call(value)));
|
|
142
|
+
desc.set = set && ((v) => set.call(value, v));
|
|
143
|
+
}
|
|
144
|
+
Object.defineProperty(out, key, desc);
|
|
145
|
+
}
|
|
146
|
+
if (Object.isFrozen(value)) {
|
|
147
|
+
Object.freeze(out);
|
|
148
|
+
}
|
|
149
|
+
return out;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// The session every callback is handed, with its request handles queued. One per
|
|
153
|
+
// session, so every callback and every module that keeps it shares one queue.
|
|
154
|
+
export function limitSession(session, max = MAX_IN_FLIGHT) {
|
|
155
|
+
if (!session || typeof session !== 'object') {
|
|
156
|
+
return session;
|
|
157
|
+
}
|
|
158
|
+
let limited = sessions.get(session);
|
|
159
|
+
if (limited) {
|
|
160
|
+
return limited;
|
|
161
|
+
}
|
|
162
|
+
const limit = { gate: gate(max), handles: new WeakMap(), warned: false };
|
|
163
|
+
limited = new Proxy(session, {
|
|
164
|
+
get(target, key) {
|
|
165
|
+
const value = Reflect.get(target, key, target);
|
|
166
|
+
return LIMITED.has(key) ? wrap(limit, value) : value;
|
|
167
|
+
},
|
|
168
|
+
});
|
|
169
|
+
sessions.set(session, limited);
|
|
170
|
+
sessions.set(limited, limited);
|
|
171
|
+
return limited;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
const isSession = (arg) => Boolean(arg && typeof arg === 'object' && 'storage' in arg && 'sessionId' in arg);
|
|
175
|
+
|
|
176
|
+
// Every session callback, with the session argument (first, or second for
|
|
177
|
+
// `onWorldCharacterTool`) replaced by its limited one.
|
|
178
|
+
export function limitCallbacks(callbacks) {
|
|
179
|
+
const out = {};
|
|
180
|
+
for (const [name, fn] of Object.entries(callbacks)) {
|
|
181
|
+
out[name] =
|
|
182
|
+
typeof fn === 'function'
|
|
183
|
+
? (...args) => fn(...args.map((arg) => (isSession(arg) ? limitSession(arg) : arg)))
|
|
184
|
+
: fn;
|
|
185
|
+
}
|
|
186
|
+
return out;
|
|
187
|
+
}
|
|
@@ -5,6 +5,30 @@ import { isActor, warnOnce } from './actors.js';
|
|
|
5
5
|
const MAX_OVERRIDES = 256;
|
|
6
6
|
const connected = (h, id) => h.session?.players.some((p) => p.playerId === id) === true;
|
|
7
7
|
|
|
8
|
+
// A resumeVisibility place may keep an authenticated viewer's overrides only
|
|
9
|
+
// while resumeKeep is holding that visit through an observed absence. The
|
|
10
|
+
// trusted identity is captured with the retained visit in hub.js; a guest or
|
|
11
|
+
// an entry without one is deliberately handled like an ordinary departure.
|
|
12
|
+
function retainedAway(h, playerId) {
|
|
13
|
+
const kept = h.resumeKept?.get(playerId);
|
|
14
|
+
return h.place?.resumeVisibility === true && kept?.awayAt !== undefined &&
|
|
15
|
+
typeof kept.identityUserId === 'string';
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
// v1.145: a resumePose place (the Town) has no resume preparation, so its
|
|
19
|
+
// arrival masks would otherwise go with the dropped socket and never return:
|
|
20
|
+
// the arrive hook does not run again for a retained visit. While the retained
|
|
21
|
+
// visit is held for an authenticated viewer, their overrides stay, calls made
|
|
22
|
+
// meanwhile still land, and the same identity's return replays the whole map.
|
|
23
|
+
// Expiry and a real leave forget them through hub.js `forget`.
|
|
24
|
+
export function heldAway(h, playerId) {
|
|
25
|
+
const kept = h.resumeKept?.get(playerId);
|
|
26
|
+
return h.place?.resumePose === true && h.place.resumeVisibility !== true &&
|
|
27
|
+
kept !== undefined && typeof kept.identityUserId === 'string' &&
|
|
28
|
+
h.players?.get(playerId)?.arrived === true && !connected(h, playerId);
|
|
29
|
+
}
|
|
30
|
+
const holds = (h, id) => connected(h, id) || retainedAway(h, id) || heldAway(h, id);
|
|
31
|
+
|
|
8
32
|
export function set(h, actorId, options, hidden) {
|
|
9
33
|
const op = hidden ? 'hide' : 'show';
|
|
10
34
|
if (!isActor(h, actorId)) {
|
|
@@ -25,7 +49,7 @@ export function set(h, actorId, options, hidden) {
|
|
|
25
49
|
if (ids.some((id) => typeof id !== 'string')) {
|
|
26
50
|
throw Error('invalid targets');
|
|
27
51
|
}
|
|
28
|
-
targets = [...new Set(ids)].filter((id) => connected(h, id));
|
|
52
|
+
targets = [...new Set(ids)].filter((id) => connected(h, id) || heldAway(h, id));
|
|
29
53
|
clear = drop === true;
|
|
30
54
|
} catch {
|
|
31
55
|
warnOnce(h, `vis:${op}:options`, `hub.${op}: visibility options need { to: [playerIds], clear?: boolean }`);
|
|
@@ -86,19 +110,57 @@ export function send(h) {
|
|
|
86
110
|
}
|
|
87
111
|
for (const id of new Set([...(h.visMe?.keys() ?? []), ...(h.sentVisMe?.keys() ?? [])])) {
|
|
88
112
|
if (connected(h, id)) {
|
|
89
|
-
|
|
90
|
-
|
|
113
|
+
if (h.resumeKept?.get(id)?.visibilityResumePending !== true) {
|
|
114
|
+
sendOne(h, id);
|
|
115
|
+
}
|
|
116
|
+
} else if (!retainedAway(h, id) && !heldAway(h, id)) {
|
|
91
117
|
forget(h, id);
|
|
92
118
|
}
|
|
93
119
|
}
|
|
94
120
|
}
|
|
95
121
|
|
|
96
|
-
export function joinedAfresh(h, playerId) {
|
|
122
|
+
export function joinedAfresh(h, playerId, identityUserId = null) {
|
|
123
|
+
// A retained player id is not an identity. Refuse to replay its cache unless
|
|
124
|
+
// the connected roster still names the authenticated account that owned the
|
|
125
|
+
// retained visit. Deleting here also prevents a later switch back from
|
|
126
|
+
// recovering another identity's overrides.
|
|
127
|
+
const kept = h.resumeKept?.get(playerId);
|
|
128
|
+
if (h.place?.resumeVisibility === true && kept &&
|
|
129
|
+
(typeof kept.identityUserId !== 'string' || kept.identityUserId !== identityUserId)) {
|
|
130
|
+
clearRetained(h, playerId);
|
|
131
|
+
return;
|
|
132
|
+
}
|
|
133
|
+
// v1.145: a held map is only ever replayed to the account that owned it.
|
|
134
|
+
if (h.place?.resumePose === true && typeof kept?.identityUserId === 'string' &&
|
|
135
|
+
kept.identityUserId !== identityUserId) {
|
|
136
|
+
clearRetained(h, playerId);
|
|
137
|
+
return;
|
|
138
|
+
}
|
|
139
|
+
// The opted-in retained return first lets the authored resume hook
|
|
140
|
+
// synchronously recompute CURRENT masks. Vis.send emits the resulting whole
|
|
141
|
+
// map later in that step; replaying the old cache here would expose an
|
|
142
|
+
// actor that became private while this viewer was away.
|
|
143
|
+
if (kept?.visibilityResumePending === true) {
|
|
144
|
+
// This hello names a client that must receive a complete map after
|
|
145
|
+
// preparation even when the rebuilt map equals the retained one.
|
|
146
|
+
h.sentVisMe?.delete(playerId);
|
|
147
|
+
return;
|
|
148
|
+
}
|
|
97
149
|
if (h.visMe?.has(playerId) && connected(h, playerId)) {
|
|
98
150
|
sendOne(h, playerId, true);
|
|
99
151
|
}
|
|
100
152
|
}
|
|
101
153
|
|
|
154
|
+
// The returning client may still hold the prior identity's merged view. Drop
|
|
155
|
+
// the server cache and clear that client without naming any actor from it.
|
|
156
|
+
export function clearRetained(h, playerId) {
|
|
157
|
+
const hadOverride = h.visMe?.has(playerId) || h.sentVisMe?.has(playerId);
|
|
158
|
+
forget(h, playerId);
|
|
159
|
+
if (hadOverride && connected(h, playerId)) {
|
|
160
|
+
h.session.send(playerId, { k: 'hub-vis', hide: [], show: [] });
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
102
164
|
export function forget(h, playerId) {
|
|
103
165
|
h.visMe?.delete(playerId);
|
|
104
166
|
h.sentVisMe?.delete(playerId);
|
|
@@ -106,7 +168,7 @@ export function forget(h, playerId) {
|
|
|
106
168
|
|
|
107
169
|
export function prune(h) {
|
|
108
170
|
for (const id of h.visMe?.keys() ?? []) {
|
|
109
|
-
if (!
|
|
171
|
+
if (!holds(h, id)) {
|
|
110
172
|
forget(h, id);
|
|
111
173
|
}
|
|
112
174
|
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
// The authored v1.127 interaction shape, shared by publishing and runtime.
|
|
2
|
+
import { REFUSED_TEXT } from '../privateText.js';
|
|
3
|
+
export function actProblem(value) {
|
|
4
|
+
if (!value || typeof value !== 'object' || Array.isArray(value) ||
|
|
5
|
+
Object.keys(value).some(key => !['verb', 'reach', 'hold', 'id'].includes(key))) {
|
|
6
|
+
return 'HubAct must be { verb, reach, hold, id }';
|
|
7
|
+
}
|
|
8
|
+
if (typeof value.verb !== 'string' || !value.verb.trim() || Array.from(value.verb).length > 16 || REFUSED_TEXT.test(value.verb)) {
|
|
9
|
+
return 'HubAct.verb must be 1..16 characters without control or direction characters';
|
|
10
|
+
}
|
|
11
|
+
if (!Number.isFinite(value.reach) || value.reach < 0.8 || value.reach > 4) {
|
|
12
|
+
return 'HubAct.reach must be 0.8..4 metres';
|
|
13
|
+
}
|
|
14
|
+
if (typeof value.hold !== 'boolean') {return 'HubAct.hold must be boolean';}
|
|
15
|
+
if (typeof value.id !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(value.id)) {
|
|
16
|
+
return 'HubAct.id must be a bounded identifier';
|
|
17
|
+
}
|
|
18
|
+
return null;
|
|
19
|
+
}
|
|
20
|
+
export function interaction(actor, place, spawned = false) {
|
|
21
|
+
const c = actor.components ?? {};
|
|
22
|
+
if (Object.hasOwn(c, 'HubAct')) {
|
|
23
|
+
return actProblem(c.HubAct) ? null : { ...c.HubAct, ...(spawned ? { id: actor.id } : {}), actor: actor.id, op: 'custom' };
|
|
24
|
+
}
|
|
25
|
+
if (c.HubSeat) {return { id: actor.id, actor: actor.id, verb: 'Sit', reach: 1.6, hold: false, op: 'sit' };}
|
|
26
|
+
if (c.HubNpc) {
|
|
27
|
+
const name = typeof c.HubNpc.name === 'string' && c.HubNpc.name ? c.HubNpc.name.slice(0, 40) : actor.id;
|
|
28
|
+
const reach = c.HubNpc.talkRange > 0 ? Math.min(c.HubNpc.talkRange, 8) : 3.5;
|
|
29
|
+
return { id: actor.id, actor: actor.id, verb: `Talk to ${name}`, reach, hold: false, op: 'talk' };
|
|
30
|
+
}
|
|
31
|
+
if (place.grab && c.Body?.type === 'dynamic' && !c.Player) {
|
|
32
|
+
return { id: actor.id, actor: actor.id, verb: 'Grab', reach: 1.2, hold: false, op: 'grab' };
|
|
33
|
+
}
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
// v1.109: a song clock and axis-aligned floor footprints. This state never
|
|
2
|
+
// starts an emote or changes a player's simulation pose or answer cooldown.
|
|
3
|
+
export function danceFloors(floors) {
|
|
4
|
+
if (!Array.isArray(floors) || !floors.length || floors.length > 16) {return null;}
|
|
5
|
+
if (!floors.every((f) => f && [f.x, f.z, f.halfX, f.halfZ].every(Number.isFinite)
|
|
6
|
+
&& Math.abs(f.x) <= 1e6 && Math.abs(f.z) <= 1e6
|
|
7
|
+
&& f.halfX > 0 && f.halfX <= 100 && f.halfZ > 0 && f.halfZ <= 100)) {return null;}
|
|
8
|
+
return floors.map(({ x, z, halfX, halfZ }) => ({ x, z, halfX, halfZ }));
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export function readDanceIdle(spec) {
|
|
12
|
+
const floors = danceFloors(spec?.floors);
|
|
13
|
+
return floors && typeof spec.actor === 'string' && typeof spec.file === 'string'
|
|
14
|
+
&& Number.isFinite(spec.bpm) && spec.bpm >= 30 && spec.bpm <= 300
|
|
15
|
+
&& Number.isFinite(spec.beatAt) && spec.beatAt >= 0
|
|
16
|
+
? { actor: spec.actor, file: spec.file, bpm: spec.bpm, beatAt: spec.beatAt, floors } : null;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export function danceIdlePose(spec, sounds, at, now) {
|
|
20
|
+
const song = sounds?.[spec?.actor];
|
|
21
|
+
if (!spec || !at || !Number.isFinite(now) || now < spec.beatAt
|
|
22
|
+
|| song?.file !== spec.file || song.since !== spec.beatAt
|
|
23
|
+
|| !spec.floors.some((f) => Math.abs(at.x - f.x) <= f.halfX && Math.abs(at.z - f.z) <= f.halfZ)) {return null;}
|
|
24
|
+
const beat = (now - spec.beatAt) * spec.bpm / 60000;
|
|
25
|
+
// One hop each beat, alternating sway over two beats, turn over four.
|
|
26
|
+
return { y: (1 - Math.cos(beat * Math.PI * 2)) * 0.12,
|
|
27
|
+
rx: 0, ry: Math.sin(beat * Math.PI / 2) * 0.8, rz: Math.sin(beat * Math.PI) * 0.22 };
|
|
28
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
// v1.138 load-abandoned telemetry vocabulary, shared by the browser and the server.
|
|
2
|
+
// Stage is the furthest milestone a connection reached before it was abandoned;
|
|
3
|
+
// it travels as kind 27's subject. Reasons travel as its result.
|
|
4
|
+
export const LOAD_STAGES = Object.freeze({
|
|
5
|
+
connected: 1, // the server saw the connection; no hello yet
|
|
6
|
+
hello: 2, // the server received hub-hello
|
|
7
|
+
body: 3, // the server has the player's body and is waiting to place them
|
|
8
|
+
placed: 4, // the browser reported its own body placed, still waiting for hub-arrived
|
|
9
|
+
});
|
|
10
|
+
// The only stages a browser may claim. Everything else is the server's observation.
|
|
11
|
+
export const CLIENT_LOAD_STAGES = Object.freeze([LOAD_STAGES.placed]);
|
|
12
|
+
export const LOAD_REASONS = Object.freeze({ closed: 1, timeout: 2 });
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
// Shared by the build filter and the publish check. No browser dependencies.
|
|
2
|
+
const GAMEPLAY = /^Hub|^Town|^Body$|^Ball$|^Player$/;
|
|
3
|
+
const DECOR = new Set(['Transform', 'Shape', 'Model']);
|
|
4
|
+
const SCENERY = new Set(['Transform', 'Shape', 'Model', 'Solid', 'Lookable']);
|
|
5
|
+
|
|
6
|
+
export function classify(components) {
|
|
7
|
+
const names = Object.keys(components ?? {});
|
|
8
|
+
// physics-3d makes an actor's collider block when it has `Solid` or its
|
|
9
|
+
// Shape says `solid` (physics3d.js `isSolid`); either way it is scenery that
|
|
10
|
+
// stops a player, never decor.
|
|
11
|
+
const solid = names.includes('Solid') || Boolean(components?.Shape?.solid);
|
|
12
|
+
if (names.includes('HubNpc')) {
|
|
13
|
+
return 'npc';
|
|
14
|
+
}
|
|
15
|
+
if (names.some((name) => GAMEPLAY.test(name))) {
|
|
16
|
+
return 'game';
|
|
17
|
+
}
|
|
18
|
+
if (!solid && names.every((name) => DECOR.has(name))) {
|
|
19
|
+
return 'decor';
|
|
20
|
+
}
|
|
21
|
+
return names.every((name) => SCENERY.has(name)) ? 'static' : 'game';
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
export function skippableDecor(actor, components = actor.components) {
|
|
26
|
+
return !['keep', 'near', 'low'].includes(actor.tier) && actor.decor !== true &&
|
|
27
|
+
actor.spawnTemplate !== true && actor.scriptedTarget !== true && classify(components) === 'decor';
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export const QUALITY_DEFAULTS = Object.freeze({ decor: 'skip', players: 8, labels: 8, spawned: 8, farMindsHz: 4 });
|
|
31
|
+
export const QUALITY_RANGES = Object.freeze({ players: [1, 30], labels: [0, 30], spawned: [0, 64], farMindsHz: [1, 60], physicsHz: [10, 60] });
|
|
32
|
+
|
|
33
|
+
export function readQuality(value, tiers, errors) {
|
|
34
|
+
if (value === undefined) {return null;}
|
|
35
|
+
if (tiers !== true) {errors.push('hub.quality requires hub.tiers: true.');}
|
|
36
|
+
const object = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
|
|
37
|
+
if (!object(value)) { errors.push('hub.quality must be an object.'); return null; }
|
|
38
|
+
for (const key of Object.keys(value)) {
|
|
39
|
+
if (key !== 'low') {errors.push(`hub.quality.${key} is unknown; allowed key: low.`);}
|
|
40
|
+
}
|
|
41
|
+
if (value.low !== undefined && !object(value.low)) { errors.push('hub.quality.low must be an object.'); return null; }
|
|
42
|
+
const low = value.low ?? {};
|
|
43
|
+
for (const key of Object.keys(low)) {
|
|
44
|
+
if (key !== 'decor' && !Object.hasOwn(QUALITY_RANGES, key)) {errors.push(`hub.quality.low.${key} is unknown.`);}
|
|
45
|
+
}
|
|
46
|
+
if (low.decor !== undefined && !['skip', 'hide'].includes(low.decor)) {errors.push('hub.quality.low.decor must be "skip" or "hide".');}
|
|
47
|
+
for (const [key, [min, max]] of Object.entries(QUALITY_RANGES)) {
|
|
48
|
+
if (low[key] !== undefined && (!Number.isInteger(low[key]) || low[key] < min || low[key] > max)) {
|
|
49
|
+
errors.push(`hub.quality.low.${key} must be a whole number from ${min} to ${max}.`);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
return { low: { ...QUALITY_DEFAULTS, ...low } };
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
// Literal ids in known actor APIs are cheaply checkable. Computed ids and
|
|
56
|
+
// arbitrary deck functions are deliberately outside this static check.
|
|
57
|
+
export function actorReferences(sources) {
|
|
58
|
+
const ids = new Set();
|
|
59
|
+
const templates = new Set();
|
|
60
|
+
const calls = new Set(['spawn', 'hide', 'show', 'move', 'tint', 'label', 'reset', 'pose', 'sound', 'danceIdle', 'keepFor', 'despawn', 'npc', 'actor', 'getActor', 'despawnActor']);
|
|
61
|
+
for (const source of sources) {
|
|
62
|
+
// Tokenizing strings/comments avoids mistaking prose or a commented-out
|
|
63
|
+
// example for an actor API call. Computed arguments stay unclassified.
|
|
64
|
+
const tokens = (source.match(/\/\*[\s\S]*?\*\/|\/\/[^\n]*|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`|[A-Za-z_$][\w$]*|[^\s]/g) ?? [])
|
|
65
|
+
.filter((token) => !token.startsWith('//') && !token.startsWith('/*'));
|
|
66
|
+
for (let i = 0; i < tokens.length - 3; i++) {
|
|
67
|
+
if (tokens[i] !== '.' || !calls.has(tokens[i + 1]) || tokens[i + 2] !== '(') {continue;}
|
|
68
|
+
const literal = tokens[i + 3];
|
|
69
|
+
if (!['"', "'", '`'].includes(literal[0]) || literal.includes('\\') || literal.includes('${')) {continue;}
|
|
70
|
+
(tokens[i + 1] === 'spawn' ? templates : ids).add(literal.slice(1, -1));
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return { ids, templates };
|
|
74
|
+
}
|
|
@@ -12,7 +12,41 @@ export function shotValue(shot) {
|
|
|
12
12
|
if (![x, y, z, distance, pitch, yaw].every(Number.isFinite) || distance <= 0) {
|
|
13
13
|
return null;
|
|
14
14
|
}
|
|
15
|
-
|
|
15
|
+
const fit = shot.fit;
|
|
16
|
+
let bounded;
|
|
17
|
+
if (fit !== undefined) {
|
|
18
|
+
const min = fit?.min,
|
|
19
|
+
max = fit?.max,
|
|
20
|
+
minDistance = fit?.minDistance;
|
|
21
|
+
if (
|
|
22
|
+
!Number.isFinite(minDistance) ||
|
|
23
|
+
minDistance <= 0 ||
|
|
24
|
+
minDistance > 1000 ||
|
|
25
|
+
!['x', 'y', 'z'].every(
|
|
26
|
+
(k) =>
|
|
27
|
+
Number.isFinite(min?.[k]) &&
|
|
28
|
+
Number.isFinite(max?.[k]) &&
|
|
29
|
+
Math.abs(min[k]) <= 10000 &&
|
|
30
|
+
Math.abs(max[k]) <= 10000 &&
|
|
31
|
+
min[k] <= max[k] &&
|
|
32
|
+
max[k] - min[k] <= 1000,
|
|
33
|
+
)
|
|
34
|
+
) {
|
|
35
|
+
return null;
|
|
36
|
+
}
|
|
37
|
+
bounded = {
|
|
38
|
+
min: { x: min.x, y: min.y, z: min.z },
|
|
39
|
+
max: { x: max.x, y: max.y, z: max.z },
|
|
40
|
+
minDistance,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
return {
|
|
44
|
+
...(bounded ? { fit: bounded } : {}),
|
|
45
|
+
look: { x, y, z },
|
|
46
|
+
distance,
|
|
47
|
+
pitch: Math.max(-89, Math.min(89, pitch)),
|
|
48
|
+
yaw,
|
|
49
|
+
};
|
|
16
50
|
} catch {
|
|
17
51
|
return null;
|
|
18
52
|
}
|