castle-web-cli 0.4.233 → 0.4.234
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 +260 -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 +50 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +140 -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 +1257 -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 +819 -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,279 @@
|
|
|
1
|
+
# Server analytics — optional contracts v1.93 and v1.111
|
|
2
|
+
|
|
3
|
+
Set `hub.analytics: true` in castle.json to opt the main place into server analytics.
|
|
4
|
+
A place without the key creates no analytics state, browser listeners or new wire
|
|
5
|
+
fields. Its public place description is byte-identical. Player UI is unchanged.
|
|
6
|
+
The town and house opt in; other decks retain their existing behavior.
|
|
7
|
+
|
|
8
|
+
Contract v1.111 adds `hub.analyticsV111: true`, valid only beside
|
|
9
|
+
`hub.analytics: true`. It enables Ghost-owned invite and admission events. The
|
|
10
|
+
flag is stored in the saved server config and immutable session pin, but never
|
|
11
|
+
extends the host's three-key hub spec or any client wire shape. Existing saved
|
|
12
|
+
towns stay off until a named saver explicitly adds it. Kinds 21–25 cannot be
|
|
13
|
+
sent through authored `hub.track` calls.
|
|
14
|
+
|
|
15
|
+
The server context gains `hub.track(playerId, eventName, properties = {})`.
|
|
16
|
+
It returns whether a best-effort delivery was attempted. Delivery failures never
|
|
17
|
+
interrupt gameplay. Older SDKs/hosts silently do nothing. Numeric properties are
|
|
18
|
+
`subject` (0..65535), `value` (0..2147483647), `result` (0..255), and `flags` (0..3).
|
|
19
|
+
Unknown fields, strings, nulls, nonintegers, other identities and unknown players
|
|
20
|
+
are refused. The platform stamps identity and town attribution and owns flags;
|
|
21
|
+
callers cannot label a house guest as its owner. No typed text, furniture or pet
|
|
22
|
+
name, NPC reply, or other player's id is sent.
|
|
23
|
+
|
|
24
|
+
The SDK method is `session.hub.track(playerId, { kind, subject?, value?, result?, flags? })`.
|
|
25
|
+
It uses the existing generic storage platform channel (`hubTrack`), so the runtime
|
|
26
|
+
image and web/app hosts need no change. The cauldron host-agent must support the
|
|
27
|
+
operation; its deployment requires an AMI rollout. Ghost accepts it only for an
|
|
28
|
+
opted-in immutable session pin. The three-key hub spec stays unchanged.
|
|
29
|
+
|
|
30
|
+
ClickHouse writes built-in `event_type_id=9` (Hub Event), with integer properties
|
|
31
|
+
in this order: kind, subject, value, result, flags. `deck_id` is the town's id,
|
|
32
|
+
including house events whose pinned owner door leads from that town. Creator plays
|
|
33
|
+
and anonymous accounts are excluded. Counts use `sum(event_count)`. Flags bit 1
|
|
34
|
+
means own house; bit 0 is set only on the platform-generated first-use marker.
|
|
35
|
+
|
|
36
|
+
| Kind | Event | Meaning |
|
|
37
|
+
| --- | --- | --- |
|
|
38
|
+
| 1 | arrive | Town arrival; result 1 direct/unknown source, 2 door return; reconnect separate |
|
|
39
|
+
| 2 | door_enter | First successful fenced transition commit; result 1 game, 2 owner-house, 3 classic cabinet |
|
|
40
|
+
| 3 | door_exit | Successful back transition; value is trip ms, result 0 means duration unknown |
|
|
41
|
+
| 4 | game_result | Successfully persisted platform result; result 1 win, 2 lose, 3 draw; rounded nonnegative score in value |
|
|
42
|
+
| 5 / 6 | activity_start / activity_end | Accepted interaction span; duration is last minus first interaction |
|
|
43
|
+
| 7 | outcome | Validated activity action; result vocabulary below |
|
|
44
|
+
| 8 | first_play | Platform first use of a door/activity per town/account/subject within 90 days |
|
|
45
|
+
| 9 | pointer_stage | First-visit flow stage: subject 0 home, 1 like, 2 play, 3 stamp, 4 done |
|
|
46
|
+
| 10 | reconnect | Restored connection; never another first arrival |
|
|
47
|
+
| 11 | session_end | Connected segment duration; reason unknown (0) |
|
|
48
|
+
| 12 / 13 | furniture_placed / furniture_moved | Accepted owner layout mutation; count in value |
|
|
49
|
+
| 14 | pet_named | Accepted save name change; only a count, never the name |
|
|
50
|
+
| 15 | guestbook_signed | Confirmed stamp write; no stamp image, name or text |
|
|
51
|
+
| 16 / 17 | house_visit / house_time | Entry and connected segment duration, subject 10; owner flag stamped by platform |
|
|
52
|
+
| 18 | npc_chat_count | Accepted NPC conversation opened; count only |
|
|
53
|
+
| 19 / 20 | token_earned / token_spent | Confirmed positive amount; no raw transaction strings |
|
|
54
|
+
| 21 | invite_sent | An invite row committed and its link was made; subject 0 town or 10 house; value 1, result 0 |
|
|
55
|
+
| 22 | invite_opened | First successful resolution of a token by this invitee; subject is the resolved town/house destination; value 1, result 0 |
|
|
56
|
+
| 23 | invite_joined | First verified arrival completion for the resolved invite; subject is the admitted town/house; value 1, result 0 |
|
|
57
|
+
| 24 | arrival_source | Successful platform admission; subject 0 town or 10 house; value 1; source is in result |
|
|
58
|
+
| 25 | join_failed | Refused/failed public town admission at Ghost's outer resolver boundary; subject 0 town or 10 house; value 0; fixed reason is in result |
|
|
59
|
+
| 27 | load_abandoned | v1.138 `loadTelemetry`: a town connection that never arrived; subject is the load stage, value ms from connect (≤ 120000), result 1 closed, 2 timeout; never an arrival |
|
|
60
|
+
|
|
61
|
+
Arrival-source results: 0 unknown, 1 direct, 2 invite, 3 door return, 4 return
|
|
62
|
+
from an owner house, 5 push, 6 explore. Push is reserved and is not emitted: Ghost has no
|
|
63
|
+
trusted push evidence today, so it never infers push from caller input. Explore is
|
|
64
|
+
a direct town admission that consumes the stamp Ghost's own Explore panel tap
|
|
65
|
+
mutation left for that user in the previous two minutes; an invite outranks it. Direct
|
|
66
|
+
means a successful public root-town admission, not an arbitrary child-deck join.
|
|
67
|
+
Door/house returns emit only after the fenced transition commit. This is a
|
|
68
|
+
platform admission event; kinds 1 and 16 remain the later, actual kit avatar
|
|
69
|
+
arrival.
|
|
70
|
+
|
|
71
|
+
Join-failure results: 0 unknown, 1 cancelled, 2 full, 3 unavailable, 4 not
|
|
72
|
+
found, 5 forbidden, 6 party required, 7 account required, 8 gated, 9 banned,
|
|
73
|
+
10 rate limited, 11 invite invalid, 12 invite expired, 13 invite exhausted,
|
|
74
|
+
14 invite not resolved, 15 invite not in session. The boundary includes Ghost
|
|
75
|
+
gate, ban, rate and invite refusals, and emits once after all internal layer
|
|
76
|
+
probes. It does not claim browser load, network, app launch or client-rendering
|
|
77
|
+
failures that Ghost cannot observe. An unauthenticated refusal has no trusted
|
|
78
|
+
user identity and therefore cannot become a creator event; code 7 is reserved
|
|
79
|
+
for authenticated account-state refusals.
|
|
80
|
+
|
|
81
|
+
Invite retries use the committed arrival row: `invite_opened` and
|
|
82
|
+
`invite_joined` each emit only on its first state transition. Public admission
|
|
83
|
+
source is deduplicated for ten minutes by player, admitted session and source;
|
|
84
|
+
a new register nonce in the same session cannot replay it, while a later invite
|
|
85
|
+
admission remains distinct from an earlier direct admission. Callback and
|
|
86
|
+
ClickHouse delivery failures never alter invite or join responses.
|
|
87
|
+
|
|
88
|
+
Subjects: 0 town; 1 tag (reserved for an overworld tag activity); 2 garden;
|
|
89
|
+
3 boat; 4 fishing; 5 jobs; 6 lanterns; 7 stamps; 8 market; 9 NPC;
|
|
90
|
+
10 house. Door subjects are `100 + cauldron_hub_door_id`, a stable platform row
|
|
91
|
+
identity, not a hash or sorted index. Join that dictionary for display names.
|
|
92
|
+
The existing tag door's wins are game_result/win for that door subject; there is
|
|
93
|
+
no separate overworld tag module in the current town to emit a second outcome.
|
|
94
|
+
Results use the player's committed visit and return ticket, including shared layers
|
|
95
|
+
and rotating game doors. A mismatched/expired trip is omitted. Classic cabinet
|
|
96
|
+
scores are outside this server result path.
|
|
97
|
+
|
|
98
|
+
Outcome results: garden 1 planted / 2 harvested (value yield); boat 1 voyage sent /
|
|
99
|
+
2 returned and claimed; fishing 1 caught; jobs 1 completed; lanterns 1 found;
|
|
100
|
+
stamps 1 awarded; market 1 confirmed purchase (value price). Fishing starts on an accepted cast; jobs start on a confirmed progress save.
|
|
101
|
+
Other spans start with their first accepted outcome. Activity spans end
|
|
102
|
+
after 30s without an accepted interaction or on departure. Their reported duration
|
|
103
|
+
excludes that idle tail. One interaction has zero span duration. NPC count and
|
|
104
|
+
house visits are separate event kinds, not fabricated activity spans.
|
|
105
|
+
|
|
106
|
+
First-arrival cohorts use the earliest town-arrival row with prior_play_count=0
|
|
107
|
+
and exclude pre-existing players from the new-user denominator. Audience history
|
|
108
|
+
is the existing platform's eventual play-history context; it is not a new exact
|
|
109
|
+
first-ever counter. First-use markers use a bounded 90-day Redis key: telemetry
|
|
110
|
+
loss can lose a marker, so analytical first use is derived from start/enter rows.
|
|
111
|
+
ClickHouse itself expires history after three months; dashboards must disclose
|
|
112
|
+
that horizon and the instrumentation launch date.
|
|
113
|
+
|
|
114
|
+
Durations are connected/interaction time, not active foreground time. Shutdown,
|
|
115
|
+
crash and lost telemetry may censor a segment. Reconnects may split it. Do not
|
|
116
|
+
interpret missing end events as zero or claim causal retention lift from observed
|
|
117
|
+
engagement. Early exposure and house-investment windows close before D7 outcomes.
|
|
118
|
+
|
|
119
|
+
Town/house opt-ins ship via the named SAVE 11 saver. This card does not save either
|
|
120
|
+
production deck. Validate QA ingestion only after Ghost and the new host capability
|
|
121
|
+
are live; a silent old host is a compatibility check, not successful ingestion QA.
|
|
122
|
+
|
|
123
|
+
Query templates and read instructions: `experiments/hub-town/analytics/` in the repository.
|
|
124
|
+
|
|
125
|
+
## FPS summaries (optional)
|
|
126
|
+
|
|
127
|
+
The main place may add `hub.fpsTelemetry` beside `analytics: true`:
|
|
128
|
+
|
|
129
|
+
```json
|
|
130
|
+
"fpsTelemetry": {
|
|
131
|
+
"buildSha": "0123456789abcdef0123456789abcdef01234567",
|
|
132
|
+
"scene": "scenes/main.scene"
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
The saver must stamp the exact source commit being assembled and the main scene.
|
|
137
|
+
Ghost pins both strings with the session; clients cannot supply build attribution.
|
|
138
|
+
Absent configuration adds no FPS listeners, messages or measurement state. This is
|
|
139
|
+
independent of `?hubstats`; that query parameter still controls only the local HUD/log.
|
|
140
|
+
Deploy Ghost's kind-26 support and a host-agent AMI whose analytics broker accepts
|
|
141
|
+
kind 26 before enabling this configuration in a saved deck. Older host brokers
|
|
142
|
+
reject it and the SDK returns false without interrupting gameplay.
|
|
143
|
+
|
|
144
|
+
The browser collects at most 60 one-second foreground FPS samples, sends one summary
|
|
145
|
+
per foreground minute (at most 60 samples), and flushes remaining whole-second samples before a kit hub trip,
|
|
146
|
+
on pagehide or disposal. Hidden intervals do not contribute samples. A departure
|
|
147
|
+
with no remaining samples sends nothing. Collection pauses during trips. Each town,
|
|
148
|
+
House or mounted door game must enable its own saved configuration. The current
|
|
149
|
+
server snapshot supplies that opt-in, bound to its multiplayer transport; a town's
|
|
150
|
+
configuration never enables a destination, even if their scene paths match.
|
|
151
|
+
Changing transports starts a fresh timing interval and keeps pending reports on
|
|
152
|
+
the original connection. Closing/crashing or a lost socket may
|
|
153
|
+
lose the final report; delivery is best effort. The kit authenticates the sender,
|
|
154
|
+
requires an arrived player, validates all fields, and accepts at most one periodic
|
|
155
|
+
and one final report per player per 60 seconds. Reports contain no user-supplied text.
|
|
156
|
+
|
|
157
|
+
Kind 26 uses subject for render tier (0 unknown, 1 low, 2 high, 3 weakest), value
|
|
158
|
+
for `medianTenths * 4096 + p10Tenths`, and result for the last visible avatar count
|
|
159
|
+
(including self, clamped to 255). Each percentile is the nearest-rank percentile of
|
|
160
|
+
one-second rates, rounded to tenths and capped at 409.5 FPS. The tier is the render
|
|
161
|
+
profile at the end of the window, including manual graphics choices; it is not a
|
|
162
|
+
hardware model or immutable device classification. Flags retain their existing
|
|
163
|
+
platform meaning. Ghost adds `hub:build_sha` and `hub:scene` in the existing event
|
|
164
|
+
variants map, preserving experiment assignments. Source provenance uses
|
|
165
|
+
`hub:source_deck_id` (the immutable session pin's deck) and `hub:source_kind`
|
|
166
|
+
(`town`, `house`, or `door`). A committed game trip also supplies
|
|
167
|
+
`hub:door_subject`, including rotating/shared doors. No database migration is required.
|
|
168
|
+
|
|
169
|
+
The readout separates exact source decks and town/House/door rows, then groups by
|
|
170
|
+
exact build SHA, render tier and scene, with a separate QA
|
|
171
|
+
mode. Its FPS columns are the median of window medians and median of window p10s,
|
|
172
|
+
weighted by event_count. They are summaries of windows, not reconstructed global
|
|
173
|
+
frame percentiles; short departure windows carry equal weight. Reports, users,
|
|
174
|
+
and average nearby-avatar count expose the sample size and load. Missing rows
|
|
175
|
+
are not zero FPS. See `experiments/hub-town/analytics/fps.sql`.
|
|
176
|
+
|
|
177
|
+
## Door analytics (v1.133)
|
|
178
|
+
|
|
179
|
+
Door sessions send four numeric kinds through `session.hub.track`. Ghost uses the
|
|
180
|
+
player's current committed visit and top return ticket to stamp the town and door
|
|
181
|
+
subject (`100 + row id`); callers leave subject absent. Shared layers and rotating
|
|
182
|
+
doors use that ticket rather than the door's current destination. Classic and house
|
|
183
|
+
tickets are excluded. The originating town must have `hub.analytics: true`. A
|
|
184
|
+
standalone door without a committed trip records nothing. No migration is needed.
|
|
185
|
+
|
|
186
|
+
| Kind | Event | Value | Result |
|
|
187
|
+
| --- | --- | --- | --- |
|
|
188
|
+
| 28 | round_start | Actual admitted group size (1–256) | 0 |
|
|
189
|
+
| 29 | round_end | Rounded connected simulation seconds | 1 finished, 2 quit, 3 disconnect |
|
|
190
|
+
| 30 | door_progress | Positive coin amount or unlock count | 1 coins, 2 unlocks |
|
|
191
|
+
| 31 | door_error | Count (1–60) | 1 visible render stall, 2 client exception |
|
|
192
|
+
|
|
193
|
+
Result places automatically start a per-player round at arrival and finish it at
|
|
194
|
+
the first accepted result or `hub.end`/duration limit. A later end/leave does not
|
|
195
|
+
emit a second end. Leave without an end is disconnect; the kit Back control reports
|
|
196
|
+
quit to its current server before travel. A lost quit message may be censored or
|
|
197
|
+
appear as disconnect. A resumed connection starts a new connected segment; these
|
|
198
|
+
are visit segments, including gathering/countdown time, rather than competitive
|
|
199
|
+
round boundaries. They must not be presented as exact active play time.
|
|
200
|
+
|
|
201
|
+
Server `hub.track` also accepts these names in places without the legacy analytics
|
|
202
|
+
opt-in. Custom round loops call it twice for each participating player:
|
|
203
|
+
|
|
204
|
+
```js
|
|
205
|
+
hub.track(playerId, 'round_start', { value: admittedPlayers.length });
|
|
206
|
+
// On completion (or result 2 quit / 3 disconnect):
|
|
207
|
+
hub.track(playerId, 'round_end', { result: 1 });
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
Start is ignored while a segment is open; end computes duration on the server.
|
|
211
|
+
Set `hub.analyticsRounds: 'authored'` on a custom-loop deck to suppress the
|
|
212
|
+
automatic arrival start and generic result/end completion. The game closes each
|
|
213
|
+
round explicitly; kit Back/disconnect still close interrupted rounds. Nightwatch, Market Sneaks and Color Call opt into this mode
|
|
214
|
+
and call at their own round enrollment and settlement boundaries. Other result
|
|
215
|
+
doors retain the automatic visit segment; continuous non-result places have no
|
|
216
|
+
inferred round. Repeated-round telemetry is not automatically inferred from HUD
|
|
217
|
+
text, timers, or scene changes. Coins use an explicit server call after a confirmed
|
|
218
|
+
award: `hub.track(playerId, 'door_progress', { value: amount, result: 1 })`.
|
|
219
|
+
A new saved `hub.unlock` emits one unlock automatically; retries, existing items,
|
|
220
|
+
guest/session-only unlocks and receipts for a replaced player emit none.
|
|
221
|
+
|
|
222
|
+
The kit reports client `error`/`unhandledrejection` categories and visible render
|
|
223
|
+
gaps of at least two seconds in result places. It never reads or sends error
|
|
224
|
+
messages, stacks, URLs or arbitrary properties. Hidden-tab gaps are ignored.
|
|
225
|
+
Client and server both limit errors to one per ten seconds per connection/player;
|
|
226
|
+
Ghost's existing per-user/session budgets still apply. Client telemetry is a
|
|
227
|
+
reported symptom, not a trusted crash count. Listener disposal follows the current
|
|
228
|
+
place and system lifecycle. Older hosts fail silently and cannot prove ingestion.
|
|
229
|
+
|
|
230
|
+
First-visit v1.134 uses the existing arrive (1) and pointer_stage (9) flags:
|
|
231
|
+
1 home, 2 door, 3 npc, 0 pre-switch/unassigned. These values are local to these
|
|
232
|
+
kinds and do not change door or FPS telemetry. Opted-in arrivals wait for the
|
|
233
|
+
first-visit storage read; stage events describe the five control stages, not
|
|
234
|
+
the door/NPC intro. Assignment is persisted independently of the current live set.
|
|
235
|
+
|
|
236
|
+
## Load abandoned (v1.138)
|
|
237
|
+
|
|
238
|
+
`hub.loadTelemetry: true` on the main place, beside `analytics: true` and
|
|
239
|
+
`analyticsV111: true`, adds kind 27 `load_abandoned`. Ghost already records the
|
|
240
|
+
admission (kind 24) and the kit the arrival (kind 1); kind 27 explains a connection
|
|
241
|
+
in between that never arrived. Houses do not emit it. Ghost accepts it only for a
|
|
242
|
+
root town session whose immutable pin carries v1.111, with the strict shape below,
|
|
243
|
+
and keeps at most one per player and session per minute. It is not in the authored
|
|
244
|
+
`hub.track` vocabulary: the kit server sends it through `session.hub.track` like kind 26.
|
|
245
|
+
|
|
246
|
+
Connections follow the transport's own join and leave callbacks (wired in
|
|
247
|
+
`code/server/index.js`), not roster sampling, so a leave and rejoin of one player id
|
|
248
|
+
between two ticks is two connections. The timeout check runs on every transport tick,
|
|
249
|
+
including before the simulation exists, so a world that never finishes building
|
|
250
|
+
still reports. Each connection emits once: result 1 `closed` when the transport
|
|
251
|
+
reports its leave before it arrived, or result 2 `timeout` when it is still connected
|
|
252
|
+
and not arrived 30 seconds (`LOAD_ABANDON_TIMEOUT_MS`) after it joined. A timeout
|
|
253
|
+
suppresses the later close; an arrival suppresses both; a join for an id whose previous
|
|
254
|
+
connection never reported a leave closes that one first; a place or session switch
|
|
255
|
+
drops pending connections without emitting. Value is milliseconds from join to
|
|
256
|
+
abandonment, clamped to 120000. Flags are 0 (Ghost may still stamp the house-owner bit,
|
|
257
|
+
which a town never has).
|
|
258
|
+
|
|
259
|
+
Stages (subject), the furthest milestone reached:
|
|
260
|
+
|
|
261
|
+
| Stage | Name | Observed by |
|
|
262
|
+
| --- | --- | --- |
|
|
263
|
+
| 1 | connected | Server: the transport joined it, no hello yet (the browser is still booting or loading the world) |
|
|
264
|
+
| 2 | hello | Server: `hub-hello` received (recorded on receipt, before any reconcile) |
|
|
265
|
+
| 3 | body | Server: hello and a body; waiting to place the player (group window or storage reads) |
|
|
266
|
+
| 4 | placed | Browser: its own body is placed and it is waiting for `hub-arrived` |
|
|
267
|
+
|
|
268
|
+
Only stage 4 is browser-reported, as `{ k: 'hub-load', stage: 4 }`, once per transport
|
|
269
|
+
and only when the snapshot carried `hubPlace.loadTelemetry`. The server accepts it only
|
|
270
|
+
from a connection in the roster that has not arrived, only as a raise, at most once per
|
|
271
|
+
second, with no other fields. Server stages never lower a reported stage. Stages 3 and 4
|
|
272
|
+
need not happen in that order; the value is the highest reached, not a sequence.
|
|
273
|
+
|
|
274
|
+
A page that never connected to the game server (app launch, page load, network,
|
|
275
|
+
`MULTIPLAYER_CONNECTION_FAILED`) is invisible to the kit. Ghost's kind 24 admissions
|
|
276
|
+
with neither a kind 27 nor an arrival cover it; `join-not-arrived.sql` splits them.
|
|
277
|
+
Anonymous players and players the host no longer resolves are dropped by the host
|
|
278
|
+
broker, which must also accept kind 27 (and treat result 1 like other terminal kinds,
|
|
279
|
+
after the socket closed) before any row flows. Delivery is best effort.
|