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,183 @@
|
|
|
1
|
+
// Opt-in transport: capture packets when sent, then deliver each player's
|
|
2
|
+
// ordered packets together after the simulation tick. The unbatched handlers
|
|
3
|
+
// and session are returned unchanged when the deck does not opt in.
|
|
4
|
+
const PAYLOAD_BYTES = 60000;
|
|
5
|
+
const encoder = new TextEncoder();
|
|
6
|
+
// Host teardown precedes onShutdown. Commands that end/change a visit cannot
|
|
7
|
+
// sit behind replay. Controls use a reserved, paced lane ahead of snapshots.
|
|
8
|
+
const IMMEDIATE = new Set(['hub-frame-offer', 'hub-go', 'hub-end', 'hub-result', 'hub-home-unlock', 'hub-leaving', 'replaced', 'x']);
|
|
9
|
+
|
|
10
|
+
export function batchFrames(callbacks, enabled) {
|
|
11
|
+
if (!enabled) { return callbacks; }
|
|
12
|
+
const queues = new Map();
|
|
13
|
+
const controls = new Map();
|
|
14
|
+
// Reserve 192 KiB/s of the host's 1 MiB/s budget for storage/hub requests.
|
|
15
|
+
const normalBudget = { rate: 768 * 1024, tokens: 65500, at: Date.now() };
|
|
16
|
+
const controlBudget = { rate: 64 * 1024, tokens: 65500, at: Date.now() };
|
|
17
|
+
// Both lanes share a frame bucket, leaving host headroom for RPCs.
|
|
18
|
+
const frameBudget = { tokens: 20, at: Date.now() };
|
|
19
|
+
const sessions = new WeakMap();
|
|
20
|
+
const ready = new Set();
|
|
21
|
+
const offers = new Map();
|
|
22
|
+
let stopping = false;
|
|
23
|
+
|
|
24
|
+
function enqueue(session, id, data) {
|
|
25
|
+
if (stopping) { return; }
|
|
26
|
+
if (!session.players.some((p) => p.playerId === id)) { return; }
|
|
27
|
+
const json = JSON.stringify(data);
|
|
28
|
+
// Capture before another hook mutates the same object, as session.send does.
|
|
29
|
+
const packet = json === undefined ? 'null' : json;
|
|
30
|
+
// Reject a source packet that cannot fit a legal runtime frame; never
|
|
31
|
+
// bypass pacing or leave an undeliverable packet at the FIFO head.
|
|
32
|
+
if (encoder.encode(packet).length + 160 > 65500) { throw new RangeError('hub.frameBatch packet exceeds the runtime frame limit'); }
|
|
33
|
+
const lane = IMMEDIATE.has(data?.k) ? controls : queues;
|
|
34
|
+
const queue = lane.get(id) ?? [];
|
|
35
|
+
queue.push({ packet, bytes: encoder.encode(packet).length });
|
|
36
|
+
lane.set(id, queue);
|
|
37
|
+
if (lane === controls) { flushLane(session, controls, controlBudget, id); }
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function wrapped(session) {
|
|
41
|
+
let proxy = sessions.get(session);
|
|
42
|
+
if (!proxy) {
|
|
43
|
+
proxy = new Proxy(session, {
|
|
44
|
+
get(target, key) {
|
|
45
|
+
if (key === 'send') { return (id, data) => enqueue(target, id, data); }
|
|
46
|
+
if (key === 'broadcast') {
|
|
47
|
+
return (data, options) => {
|
|
48
|
+
if (stopping) { return; }
|
|
49
|
+
// Serialize once even when this broadcast has many recipients.
|
|
50
|
+
const value = JSON.parse(JSON.stringify(data) ?? 'null');
|
|
51
|
+
for (const p of target.players) {
|
|
52
|
+
if (p.playerId !== options?.except) { enqueue(target, p.playerId, value); }
|
|
53
|
+
}
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
const value = Reflect.get(target, key, target);
|
|
57
|
+
return typeof value === 'function' ? value.bind(target) : value;
|
|
58
|
+
},
|
|
59
|
+
});
|
|
60
|
+
sessions.set(session, proxy);
|
|
61
|
+
}
|
|
62
|
+
return proxy;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
function refill(budget) {
|
|
66
|
+
const now = Date.now();
|
|
67
|
+
budget.tokens = Math.min(65500, budget.tokens + Math.max(0, now - budget.at) * budget.rate / 1000);
|
|
68
|
+
budget.at = now;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function packetFor(queue, allowance) {
|
|
72
|
+
const packets = [];
|
|
73
|
+
let bytes = 160; // Envelope plus platform protocol/recipient overhead.
|
|
74
|
+
for (const row of queue) {
|
|
75
|
+
if (bytes + row.bytes + 1 > Math.min(PAYLOAD_BYTES, allowance)) { break; }
|
|
76
|
+
bytes += row.bytes + 1;
|
|
77
|
+
packets.push(row.packet);
|
|
78
|
+
}
|
|
79
|
+
if (!packets.length) {
|
|
80
|
+
// A valid large single packet gets its own paced envelope.
|
|
81
|
+
const row = queue[0];
|
|
82
|
+
if (row && row.bytes + 160 <= allowance) {
|
|
83
|
+
return { count: 1, bytes: row.bytes + 160, text: `{"k":"hub-frame","packets":[${row.packet}]}` };
|
|
84
|
+
}
|
|
85
|
+
return null;
|
|
86
|
+
}
|
|
87
|
+
return { count: packets.length, bytes,
|
|
88
|
+
text: `{"k":"hub-frame","packets":[${packets.join(',')}]}` };
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function flushLane(session, lane, budget, only) {
|
|
92
|
+
refill(budget);
|
|
93
|
+
const players = new Set(session.players.map((p) => p.playerId));
|
|
94
|
+
const now = Date.now();
|
|
95
|
+
frameBudget.tokens = Math.min(20, frameBudget.tokens + Math.max(0, now - frameBudget.at) * 30 * players.size / 1000);
|
|
96
|
+
frameBudget.at = now;
|
|
97
|
+
for (const id of lane.keys()) { if (!players.has(id)) { lane.delete(id); } }
|
|
98
|
+
function delivered(id, count) {
|
|
99
|
+
const queue = lane.get(id);
|
|
100
|
+
queue.splice(0, count);
|
|
101
|
+
lane.delete(id);
|
|
102
|
+
if (queue.length) { lane.set(id, queue); } // Round-robin across ticks.
|
|
103
|
+
}
|
|
104
|
+
const shared = only === undefined && lane.size === players.size
|
|
105
|
+
? [...lane].map(([id, queue]) => ({ id, row: packetFor(queue, budget.tokens) })) : [];
|
|
106
|
+
if (frameBudget.tokens >= 1 && shared.length && shared.every(({ row }) => row && row.text === shared[0].row.text)) {
|
|
107
|
+
frameBudget.tokens -= 1;
|
|
108
|
+
budget.tokens -= shared[0].row.bytes;
|
|
109
|
+
session.broadcast(JSON.parse(shared[0].row.text));
|
|
110
|
+
for (const { id, row } of shared) { delivered(id, row.count); }
|
|
111
|
+
return;
|
|
112
|
+
}
|
|
113
|
+
for (const [id, queue] of [...lane]) {
|
|
114
|
+
if (frameBudget.tokens < 1) { break; }
|
|
115
|
+
if (only !== undefined && id !== only) { continue; }
|
|
116
|
+
const row = packetFor(queue, budget.tokens);
|
|
117
|
+
if (!row) { continue; }
|
|
118
|
+
frameBudget.tokens -= 1;
|
|
119
|
+
budget.tokens -= row.bytes;
|
|
120
|
+
session.send(id, JSON.parse(row.text));
|
|
121
|
+
delivered(id, row.count);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function flush(session) {
|
|
126
|
+
flushLane(session, controls, controlBudget);
|
|
127
|
+
const held = new Map();
|
|
128
|
+
for (const id of controls.keys()) {
|
|
129
|
+
if (queues.has(id)) { held.set(id, queues.get(id)); queues.delete(id); }
|
|
130
|
+
}
|
|
131
|
+
flushLane(session, queues, normalBudget);
|
|
132
|
+
for (const [id, queue] of held) { queues.set(id, queue); }
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
const out = { ...callbacks };
|
|
136
|
+
for (const name of ['onStart']) {
|
|
137
|
+
if (callbacks[name]) { out[name] = (session, ...args) => callbacks[name](wrapped(session), ...args); }
|
|
138
|
+
}
|
|
139
|
+
out.onPlayerJoin = (session, player, ...args) => {
|
|
140
|
+
const id = player.playerId;
|
|
141
|
+
ready.delete(id); queues.delete(id); controls.delete(id);
|
|
142
|
+
offers.set(id, Date.now());
|
|
143
|
+
enqueue(session, id, { k: 'hub-frame-offer' });
|
|
144
|
+
return callbacks.onPlayerJoin?.(wrapped(session), player, ...args);
|
|
145
|
+
};
|
|
146
|
+
out.onPlayerLeave = (session, player, ...args) => {
|
|
147
|
+
ready.delete(player.playerId); offers.delete(player.playerId); queues.delete(player.playerId); controls.delete(player.playerId);
|
|
148
|
+
return callbacks.onPlayerLeave?.(wrapped(session), player, ...args);
|
|
149
|
+
};
|
|
150
|
+
out.onMessage = (session, player, data, ...args) => {
|
|
151
|
+
if (data?.k === 'hub-frame-ready') {
|
|
152
|
+
if (offers.has(player.playerId) && session.players.some((p) => p.playerId === player.playerId)) { ready.add(player.playerId); }
|
|
153
|
+
return;
|
|
154
|
+
}
|
|
155
|
+
return callbacks.onMessage?.(wrapped(session), player, data, ...args);
|
|
156
|
+
};
|
|
157
|
+
out.onTick = (session) => {
|
|
158
|
+
// ACK affects offer retries, never eligibility for the paced FIFO.
|
|
159
|
+
const now = Date.now();
|
|
160
|
+
const players = new Set(session.players.map((p) => p.playerId));
|
|
161
|
+
for (const id of ready) { if (!players.has(id)) { ready.delete(id); } }
|
|
162
|
+
for (const id of offers.keys()) { if (!players.has(id)) { offers.delete(id); } }
|
|
163
|
+
for (const id of players) {
|
|
164
|
+
if (!ready.has(id) && now - (offers.get(id) ?? -Infinity) >= 1000) {
|
|
165
|
+
offers.set(id, now);
|
|
166
|
+
enqueue(session, id, { k: 'hub-frame-offer' });
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
try { return callbacks.onTick?.(wrapped(session)); }
|
|
170
|
+
finally { flush(session); }
|
|
171
|
+
};
|
|
172
|
+
if (callbacks.onReplaced) {
|
|
173
|
+
out.onReplaced = (session) => {
|
|
174
|
+
callbacks.onReplaced(wrapped(session));
|
|
175
|
+
flush(session);
|
|
176
|
+
};
|
|
177
|
+
}
|
|
178
|
+
out.onShutdown = async (...args) => {
|
|
179
|
+
stopping = true; controls.clear(); queues.clear(); ready.clear(); offers.clear();
|
|
180
|
+
return callbacks.onShutdown?.(...args);
|
|
181
|
+
};
|
|
182
|
+
return out;
|
|
183
|
+
}
|
|
@@ -13,6 +13,7 @@ const FRIEND_MS = 10 * 60000;
|
|
|
13
13
|
const MIN_READ_GAP_MS = 31000;
|
|
14
14
|
const ARRIVAL_MS = 60000;
|
|
15
15
|
const CHECK_MS = 5000;
|
|
16
|
+
const FRESH_READ_MS = 900;
|
|
16
17
|
const diagnostics = new WeakMap();
|
|
17
18
|
// The refusals a host or ghost answers with, by name; anything else is 'other'.
|
|
18
19
|
const REFUSAL_CODES = new Set([
|
|
@@ -69,7 +70,14 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
|
|
|
69
70
|
}
|
|
70
71
|
}
|
|
71
72
|
let entry = cache.get(playerId);
|
|
72
|
-
|
|
73
|
+
const freshUser = h.place?.freshFriends === true ? userIdOf(h, playerId) : null;
|
|
74
|
+
if (freshUser && entry && entry.userId !== freshUser) {
|
|
75
|
+
if (entry.pending || now - entry.at < MIN_READ_GAP_MS) {
|
|
76
|
+
return [];
|
|
77
|
+
}
|
|
78
|
+
entry = null;
|
|
79
|
+
}
|
|
80
|
+
if (h.cells || h.place?.freshFriends === true) {
|
|
73
81
|
if (entry) {
|
|
74
82
|
entry.deckIds = ids;
|
|
75
83
|
}
|
|
@@ -85,7 +93,7 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
|
|
|
85
93
|
const placeIds = placeUsers(h, playerId, userIdOf);
|
|
86
94
|
if (!entry || (!entry.pending && readAt - entry.at >= MIN_READ_GAP_MS &&
|
|
87
95
|
(stale(entry, readAt, placeIds) || (hasNew(entry, ids) && !(entry.refused && readAt - entry.at < entry.ttl))))) {
|
|
88
|
-
entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt);
|
|
96
|
+
entry = startRead(h, playerId, [...new Set([...ids, ...placeIds])].slice(0, 100), readAt, freshUser);
|
|
89
97
|
}
|
|
90
98
|
entry.deckIds = ids;
|
|
91
99
|
} else if (!entry || (!entry.pending && now - entry.at >= entry.ttl)) {
|
|
@@ -93,6 +101,10 @@ export async function friendsAmong(h, playerId, userIds, userIdOf) {
|
|
|
93
101
|
entry = startRead(h, playerId, ids, now);
|
|
94
102
|
}
|
|
95
103
|
await entry.pending;
|
|
104
|
+
if (h.place?.freshFriends === true &&
|
|
105
|
+
(!h.sim?.players.has(playerId) || userIdOf(h, playerId) !== entry.userId || Date.now() - entry.at >= entry.ttl)) {
|
|
106
|
+
return [];
|
|
107
|
+
}
|
|
96
108
|
return ids.filter((id) => entry.ids.includes(id));
|
|
97
109
|
} catch {
|
|
98
110
|
return [];
|
|
@@ -116,23 +128,41 @@ function stale(entry, now, placeIds) {
|
|
|
116
128
|
return age >= entry.ttl || (age >= ARRIVAL_MS && hasNew(entry, placeIds));
|
|
117
129
|
}
|
|
118
130
|
|
|
119
|
-
function startRead(h, playerId, ids, now) {
|
|
131
|
+
function startRead(h, playerId, ids, now, userId = null) {
|
|
132
|
+
const fresh = h.place?.freshFriends === true;
|
|
120
133
|
const entry = {
|
|
121
|
-
|
|
134
|
+
...(fresh ? { userId } : {}),
|
|
135
|
+
at: now, ttl: fresh ? MIN_READ_GAP_MS : EMPTY_MS, ids: [], follows: [], followedBy: [], asked: ids, pending: null,
|
|
122
136
|
};
|
|
123
137
|
(h.friendsCache ??= new Map()).set(playerId, entry);
|
|
124
138
|
// Latch before awaiting: deck asks and background primes share this read.
|
|
125
|
-
entry.pending = read(h, playerId, ids).then((answer) => {
|
|
139
|
+
entry.pending = (fresh ? freshRead(h, playerId, ids) : read(h, playerId, ids)).then((answer) => {
|
|
126
140
|
entry.ids = answer.friends;
|
|
127
141
|
entry.follows = answer.follows;
|
|
128
142
|
entry.followedBy = answer.followedBy;
|
|
129
|
-
entry.ttl = answer.friends.length ? FRIEND_MS : EMPTY_MS;
|
|
143
|
+
entry.ttl = fresh ? MIN_READ_GAP_MS : answer.friends.length ? FRIEND_MS : EMPTY_MS;
|
|
130
144
|
entry.refused = answer.refused === true;
|
|
131
145
|
entry.pending = null;
|
|
132
146
|
});
|
|
133
147
|
return entry;
|
|
134
148
|
}
|
|
135
149
|
|
|
150
|
+
// A timeout clears permission rather than retaining a stale yes. Late platform
|
|
151
|
+
// replies cannot populate this entry; the shared latch and rate timestamp survive.
|
|
152
|
+
async function freshRead(h, playerId, ids) {
|
|
153
|
+
let timer;
|
|
154
|
+
try {
|
|
155
|
+
return await Promise.race([
|
|
156
|
+
read(h, playerId, ids),
|
|
157
|
+
new Promise((resolve) => {
|
|
158
|
+
timer = setTimeout(() => resolve({ friends: [], follows: [], followedBy: [], refused: true }), FRESH_READ_MS);
|
|
159
|
+
}),
|
|
160
|
+
]);
|
|
161
|
+
} finally {
|
|
162
|
+
clearTimeout(timer);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
|
|
136
166
|
// Called after hello, and from the throttled tick check for early hellos/arrivals.
|
|
137
167
|
export function prime(h, playerId, userIdOf, placeIds) {
|
|
138
168
|
if (!h.cells || !h.players.get(playerId)?.hello || !h.sim?.players.has(playerId) ||
|
|
@@ -152,7 +182,7 @@ export function prime(h, playerId, userIdOf, placeIds) {
|
|
|
152
182
|
}
|
|
153
183
|
const ids = [...new Set([...(entry?.deckIds ?? []), ...placeIds])].slice(0, 100);
|
|
154
184
|
if (ids.length) {
|
|
155
|
-
const fresh = startRead(h, playerId, ids, now);
|
|
185
|
+
const fresh = startRead(h, playerId, ids, now, userIdOf(h, playerId));
|
|
156
186
|
fresh.deckIds = entry?.deckIds ?? [];
|
|
157
187
|
}
|
|
158
188
|
}
|
|
@@ -190,8 +220,15 @@ async function read(h, playerId, ids) {
|
|
|
190
220
|
? { ...empty, friends: ids }
|
|
191
221
|
: empty;
|
|
192
222
|
}
|
|
193
|
-
|
|
194
|
-
|
|
223
|
+
const fresh = h.place?.freshFriends === true;
|
|
224
|
+
if ((h.cells || fresh) && typeof h.session.hub.relationsAmong === 'function') {
|
|
225
|
+
const answer = fresh
|
|
226
|
+
? await h.session.hub.relationsAmong(playerId, ids, { strict: true })
|
|
227
|
+
: await h.session.hub.relationsAmong(playerId, ids);
|
|
228
|
+
if (fresh && (answer?.validated !== true || ['friends', 'follows', 'followedBy'].some((key) =>
|
|
229
|
+
!Array.isArray(answer[key]) || answer[key].some((id) => typeof id !== 'string' || !USER_ID.test(id))))) {
|
|
230
|
+
return { ...empty, refused: true };
|
|
231
|
+
}
|
|
195
232
|
const list = (value) => Array.isArray(value) ? ids.filter((id) => value.includes(id)) : [];
|
|
196
233
|
const relations = {
|
|
197
234
|
friends: list(answer?.friends),
|
|
@@ -203,6 +240,9 @@ async function read(h, playerId, ids) {
|
|
|
203
240
|
}
|
|
204
241
|
return relations;
|
|
205
242
|
}
|
|
243
|
+
if (fresh) {
|
|
244
|
+
return { ...empty, refused: true };
|
|
245
|
+
}
|
|
206
246
|
const answer = await h.session.hub.friendsAmong?.(playerId, ids);
|
|
207
247
|
const friends = Array.isArray(answer) ? ids.filter((id) => answer.includes(id)) : [];
|
|
208
248
|
if (Array.isArray(answer)) {
|
|
@@ -81,9 +81,11 @@ export function refresh(h, hub, membersOf, refused) {
|
|
|
81
81
|
const ids = [...users.keys()].slice(0, MAX_USERS);
|
|
82
82
|
h.historyReading = true;
|
|
83
83
|
const startedAt = now;
|
|
84
|
+
const epoch = h.historyEpoch ?? 0;
|
|
84
85
|
hub
|
|
85
86
|
.readResults({ userIds: ids })
|
|
86
87
|
.then((read) => {
|
|
88
|
+
if ((h.historyEpoch ?? 0) !== epoch) { return; }
|
|
87
89
|
for (const userId of ids) {
|
|
88
90
|
take(h, users.get(userId), read?.players?.[userId], startedAt);
|
|
89
91
|
}
|