castle-web-cli 0.4.232 → 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/agent-failures.d.ts +8 -0
- package/dist/agent-failures.js +19 -2
- package/dist/agent-prompts.d.ts +1 -1
- package/dist/agent-prompts.js +10 -3
- package/dist/agent.d.ts +64 -3
- package/dist/agent.js +170 -81
- package/dist/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 +18 -2
- package/dist/castle-host/host.js +844 -39
- package/dist/castleJson.d.ts +23 -2
- package/dist/castleJson.js +46 -2
- package/dist/check.d.ts +3 -1
- package/dist/check.js +20 -3
- 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 +50 -2
- 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/importPinMismatch.d.ts +22 -0
- package/dist/importPinMismatch.js +77 -0
- package/dist/importRegression.js +3 -15
- package/dist/imports.d.ts +10 -3
- package/dist/imports.js +88 -20
- package/dist/index.js +11 -4
- package/dist/init.js +1 -1
- package/dist/platformDoc.js +22 -0
- package/dist/routerFences.d.ts +5 -0
- package/dist/routerFences.js +12 -2
- package/dist/save-deck.d.ts +25 -1
- package/dist/save-deck.js +178 -9
- package/dist/serve.js +32 -11
- package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
- package/dist/shell/assets/index-MVLfNYd9.css +1 -0
- package/dist/shell/index.html +2 -2
- package/dist/taskSteer.d.ts +13 -0
- package/dist/taskSteer.js +22 -2
- package/dist/vitePlugins.d.ts +2 -1
- package/dist/vitePlugins.js +13 -0
- package/kits/base/castle.json +1 -1
- package/kits/base/package-lock.json +1 -1
- package/kits/base/sdk/README.md +339 -5
- package/kits/base/sdk/avatar.d.ts +6 -2
- package/kits/base/sdk/avatar.js +12 -4
- package/kits/base/sdk/castle.d.ts +7 -3
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +176 -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 +37 -6
- package/kits/base/sdk/hub.js +63 -4
- package/kits/base/sdk/multiplayer.d.ts +7 -1
- package/kits/base/sdk/multiplayer.js +148 -32
- 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 +81 -7
- package/kits/base/sdk/server/hub.d.ts +117 -0
- package/kits/base/sdk/server/hub.js +119 -2
- package/kits/base/sdk/server/platformHandle.d.ts +43 -1
- package/kits/base/sdk/server/storage.d.ts +17 -0
- package/kits/base/sdk/server/storage.js +65 -3
- package/kits/base/sdk/server/wrapper.d.ts +43 -6
- package/kits/base/sdk/server/wrapper.js +93 -9
- package/kits/base/sdk/social.d.ts +9 -0
- package/kits/base/sdk/social.js +5 -0
- package/kits/hub-game/CLAUDE.md +451 -13
- package/kits/hub-game/README.md +63 -0
- package/kits/hub-game/blueprints/avatar-10.scene +28 -0
- package/kits/hub-game/blueprints/avatar-11.scene +28 -0
- package/kits/hub-game/blueprints/avatar-12.scene +28 -0
- package/kits/hub-game/blueprints/avatar-13.scene +28 -0
- package/kits/hub-game/blueprints/avatar-14.scene +28 -0
- package/kits/hub-game/blueprints/avatar-15.scene +28 -0
- package/kits/hub-game/blueprints/avatar-4.scene +28 -0
- package/kits/hub-game/blueprints/avatar-5.scene +28 -0
- package/kits/hub-game/blueprints/avatar-6.scene +28 -0
- package/kits/hub-game/blueprints/avatar-7.scene +28 -0
- package/kits/hub-game/blueprints/avatar-8.scene +28 -0
- package/kits/hub-game/blueprints/avatar-9.scene +28 -0
- package/kits/hub-game/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/actorBudget.js +47 -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/attention.js +11 -2
- package/kits/hub-game/code/client/avatar.js +311 -35
- package/kits/hub-game/code/client/avatarCap.js +228 -0
- package/kits/hub-game/code/client/avatarColors.js +70 -0
- package/kits/hub-game/code/client/avatarFaces.js +21 -0
- package/kits/hub-game/code/client/avatarShare.js +253 -0
- package/kits/hub-game/code/client/backVisibility.js +13 -0
- package/kits/hub-game/code/client/ballot.js +472 -0
- package/kits/hub-game/code/client/build.js +38 -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 +2144 -160
- package/kits/hub-game/code/client/companion.js +716 -0
- package/kits/hub-game/code/client/companionDress.js +99 -0
- package/kits/hub-game/code/client/crowdNames.js +241 -0
- package/kits/hub-game/code/client/decor.js +515 -0
- 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/earned.js +131 -0
- package/kits/hub-game/code/client/emoteBubble.js +75 -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 +368 -29
- package/kits/hub-game/code/client/hookLayer.js +385 -20
- 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 +177 -24
- package/kits/hub-game/code/client/interestCap.js +81 -0
- 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/keys.js +36 -0
- package/kits/hub-game/code/client/labelsNear.js +234 -0
- 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/menuIcons.js +34 -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/pack.js +6 -2
- package/kits/hub-game/code/client/packFormat.js +3 -3
- 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/rehello.js +167 -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 +146 -0
- 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/sound.js +63 -8
- package/kits/hub-game/code/client/soundscape.js +1151 -0
- package/kits/hub-game/code/client/soundscapeActions.js +99 -0
- package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
- package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
- package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
- package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
- package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
- package/kits/hub-game/code/client/soundscapeCues.js +362 -0
- package/kits/hub-game/code/client/soundscapeMap.js +181 -0
- package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
- package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
- package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
- package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
- package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
- package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
- package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
- package/kits/hub-game/code/client/soundscapeUi.js +211 -0
- package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
- package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
- package/kits/hub-game/code/client/spin.js +101 -0
- package/kits/hub-game/code/client/state.js +162 -1
- package/kits/hub-game/code/client/stuck.js +259 -0
- package/kits/hub-game/code/client/talk.js +714 -59
- package/kits/hub-game/code/client/tiers.js +543 -52
- package/kits/hub-game/code/client/toastBand.js +37 -0
- package/kits/hub-game/code/client/together.js +39 -2
- package/kits/hub-game/code/client/visibility.js +43 -0
- 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/wear.js +461 -170
- package/kits/hub-game/code/client/worldLabels.js +241 -0
- package/kits/hub-game/code/client/yours.js +200 -0
- package/kits/hub-game/code/companionSpec.js +45 -0
- package/kits/hub-game/code/npcDisplayText.js +55 -0
- package/kits/hub-game/code/privateText.js +7 -0
- package/kits/hub-game/code/server/act.js +124 -0
- package/kits/hub-game/code/server/actions.js +138 -0
- package/kits/hub-game/code/server/actors.js +11 -2
- 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/ask.js +155 -0
- package/kits/hub-game/code/server/ballot.js +539 -0
- package/kits/hub-game/code/server/cells.js +100 -0
- package/kits/hub-game/code/server/companion.js +107 -0
- package/kits/hub-game/code/server/cues.js +70 -0
- package/kits/hub-game/code/server/decor.js +269 -0
- package/kits/hub-game/code/server/doorAnalytics.js +52 -0
- package/kits/hub-game/code/server/earned.js +478 -0
- package/kits/hub-game/code/server/frameBatch.js +183 -0
- package/kits/hub-game/code/server/friendBests.js +166 -0
- package/kits/hub-game/code/server/friendsAmong.js +272 -0
- package/kits/hub-game/code/server/history.js +7 -0
- package/kits/hub-game/code/server/hub.js +2510 -95
- package/kits/hub-game/code/server/idle.js +60 -12
- package/kits/hub-game/code/server/index.js +28 -6
- package/kits/hub-game/code/server/invites.js +19 -0
- package/kits/hub-game/code/server/labels.js +36 -2
- package/kits/hub-game/code/server/loadAbandon.js +106 -0
- package/kits/hub-game/code/server/manifest.js +586 -7
- package/kits/hub-game/code/server/menu.js +161 -0
- package/kits/hub-game/code/server/npcs.js +1025 -113
- 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/party.js +2 -2
- package/kits/hub-game/code/server/players.js +30 -0
- 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/shot.js +110 -0
- package/kits/hub-game/code/server/standing.js +123 -0
- package/kits/hub-game/code/server/storageLimit.js +187 -0
- package/kits/hub-game/code/server/vis.js +175 -0
- package/kits/hub-game/code/server/wear.js +12 -0
- package/kits/hub-game/code/server/yours.js +59 -0
- package/kits/hub-game/code/shared/act.js +35 -0
- package/kits/hub-game/code/shared/cues.js +9 -0
- package/kits/hub-game/code/shared/danceIdle.js +28 -0
- package/kits/hub-game/code/shared/decor.js +41 -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 +53 -0
- package/kits/hub-game/code/shared/spin.js +57 -0
- package/kits/hub-game/code/systems/hub.js +1753 -202
- package/kits/hub-game/docs/analytics.md +279 -0
- package/kits/hub-game/docs/content-pack.md +1 -1
- package/kits/hub-game/docs/contract.md +3475 -77
- package/kits/hub-game/docs/home-pieces.md +71 -0
- package/kits/hub-game/docs/observed-progress.md +252 -0
- package/kits/hub-game/main.jsx +2 -0
- package/kits/hub-game/models/avatar-10.pxmodel +28 -0
- package/kits/hub-game/models/avatar-11.pxmodel +28 -0
- package/kits/hub-game/models/avatar-12.pxmodel +27 -0
- package/kits/hub-game/models/avatar-13.pxmodel +24 -0
- package/kits/hub-game/models/avatar-14.pxmodel +29 -0
- package/kits/hub-game/models/avatar-15.pxmodel +24 -0
- package/kits/hub-game/models/avatar-4.pxmodel +29 -0
- package/kits/hub-game/models/avatar-5.pxmodel +27 -0
- package/kits/hub-game/models/avatar-6.pxmodel +26 -0
- package/kits/hub-game/models/avatar-7.pxmodel +25 -0
- package/kits/hub-game/models/avatar-8.pxmodel +24 -0
- package/kits/hub-game/models/avatar-9.pxmodel +30 -0
- package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
- package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
- package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
- package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
- package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
- package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
- package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
- package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
- package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
- package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
- package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
- package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
- package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
- package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
- package/kits/hub-game/models/hats/cap.pxmodel +162 -0
- package/kits/hub-game/models/hats/captain.pxmodel +178 -0
- package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
- package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
- package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
- package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
- package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
- package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
- package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
- package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
- package/kits/hub-game/models/hats/straw.pxmodel +139 -0
- package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
- package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
- package/kits/hub-game/models/hats/witch.pxmodel +147 -0
- package/kits/hub-game/package-lock.json +10 -1
- package/kits/hub-game/package.json +6 -2
- 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 +117 -16
- package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
- package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
- package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
- package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
- package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
- package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
- package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
- package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
- package/kits/hub-game/scripts/gen-earned.mjs +285 -0
- package/kits/hub-game/scripts/gen-hats.mjs +827 -0
- package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
- package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
- package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -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 +853 -0
- package/kits/hub-game/scripts/test-actions.mjs +298 -0
- package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
- package/kits/hub-game/scripts/test-actors.mjs +38 -23
- 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-client.mjs +358 -0
- package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
- package/kits/hub-game/scripts/test-ask.mjs +269 -0
- package/kits/hub-game/scripts/test-attention.mjs +10 -1
- package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
- package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
- package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
- package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
- package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
- package/kits/hub-game/scripts/test-avatar.mjs +584 -7
- package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
- package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
- package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
- package/kits/hub-game/scripts/test-build.mjs +49 -0
- package/kits/hub-game/scripts/test-cells.mjs +71 -0
- package/kits/hub-game/scripts/test-chat.mjs +863 -0
- package/kits/hub-game/scripts/test-classic.mjs +2 -0
- package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
- package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
- package/kits/hub-game/scripts/test-companion.mjs +259 -0
- package/kits/hub-game/scripts/test-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 +344 -0
- package/kits/hub-game/scripts/test-decor.mjs +464 -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-client.mjs +459 -0
- package/kits/hub-game/scripts/test-earned.mjs +1224 -0
- package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
- 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-friend-bests.mjs +435 -0
- package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
- package/kits/hub-game/scripts/test-grab.mjs +7 -0
- package/kits/hub-game/scripts/test-hats.mjs +422 -168
- package/kits/hub-game/scripts/test-high-only.mjs +170 -0
- package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
- package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
- package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
- package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
- 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 +427 -1
- package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
- package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
- package/kits/hub-game/scripts/test-interest-client.mjs +118 -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-keys.mjs +46 -1
- package/kits/hub-game/scripts/test-labels.mjs +664 -0
- 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 +472 -0
- package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
- package/kits/hub-game/scripts/test-menu.mjs +319 -0
- package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
- package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
- package/kits/hub-game/scripts/test-observed.mjs +745 -0
- package/kits/hub-game/scripts/test-pack.mjs +7 -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 +541 -0
- 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 +1733 -0
- package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
- package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
- package/kits/hub-game/scripts/test-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 +901 -0
- package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
- package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
- package/kits/hub-game/scripts/test-spin.mjs +314 -0
- package/kits/hub-game/scripts/test-standing.mjs +449 -0
- package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
- package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
- package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
- package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
- package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
- package/kits/hub-game/scripts/test-tiers.mjs +476 -2
- package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
- package/kits/hub-game/scripts/test-try-on.mjs +22 -22
- package/kits/hub-game/scripts/test-vis.mjs +770 -0
- package/kits/hub-game/scripts/test-visibility.mjs +134 -0
- 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 +210 -0
- package/kits/hub-game/scripts/test-yours.mjs +403 -0
- package/kits/multiplayer-3d/CLAUDE.md +50 -0
- package/kits/multiplayer-3d/castle.json +5 -5
- package/kits/multiplayer-3d/code/client/avatars.js +7 -0
- package/kits/multiplayer-3d/code/client/gait.js +65 -0
- package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
- package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
- package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
- package/kits/multiplayer-3d/code/options.js +5 -0
- package/kits/multiplayer-3d/code/server/ownership.js +10 -2
- package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
- package/kits/multiplayer-3d/code/server/world.js +7 -0
- package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
- package/kits/multiplayer-3d/package-lock.json +8 -1
- package/kits/multiplayer-3d/package.json +3 -1
- package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
- package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
- package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
- package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
- package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
- package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
- package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
- package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
- package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
- package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
- package/kits/physics-2d/CLAUDE.md +19 -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 +337 -3
- package/kits/physics-2d/engine/skyKey.js +129 -0
- package/kits/physics-2d/engine/stillClock.js +106 -0
- package/kits/physics-2d/engine/updateBudget.js +21 -0
- package/kits/physics-2d/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-2d/scripts/test-skip-unchanged.mjs +326 -1
- package/kits/physics-3d/CLAUDE.md +42 -529
- 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 +661 -87
- 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 +9 -1
- package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
- package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
- package/kits/physics-3d/engine3d/actornode.js +87 -0
- package/kits/physics-3d/engine3d/animationBudget.js +23 -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/editorWorld.js +6 -0
- package/kits/physics-3d/engine3d/emptynodes.js +232 -0
- package/kits/physics-3d/engine3d/framecap.js +99 -0
- 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 +126 -0
- package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
- package/kits/physics-3d/engine3d/kithooks.js +47 -0
- package/kits/physics-3d/engine3d/look.js +514 -48
- package/kits/physics-3d/engine3d/lookbake.js +208 -0
- package/kits/physics-3d/engine3d/materialpresets.js +2 -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 +39 -10
- package/kits/physics-3d/engine3d/nearshadows.js +106 -21
- package/kits/physics-3d/engine3d/optimize.js +9 -5
- package/kits/physics-3d/engine3d/orbitinput.js +522 -10
- package/kits/physics-3d/engine3d/orbitlens.js +48 -0
- package/kits/physics-3d/engine3d/ownmodel.js +213 -0
- 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 +42 -11
- 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 +890 -0
- package/kits/physics-3d/engine3d/sky.js +547 -0
- package/kits/physics-3d/engine3d/skylife.js +306 -0
- 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/unchanged.js +11 -0
- package/kits/physics-3d/engine3d/viewrange.js +52 -0
- package/kits/physics-3d/engine3d/world3d.js +1253 -76
- package/kits/physics-3d/eslint.config.js +2 -1
- package/kits/physics-3d/main.jsx +10 -2
- 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/look-baseline.mjs +155 -0
- package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
- package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
- package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
- package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
- package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
- package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
- 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-gait.mjs +387 -0
- package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
- package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
- package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
- package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
- package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
- package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
- package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
- package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
- package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
- package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
- package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
- package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
- package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
- package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
- package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
- package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
- package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
- package/kits/physics-3d/systems/physics3d.js +419 -9
- 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/gameHooks.js +7 -0
- package/kits/real-time/code/server/session.js +102 -22
- package/kits/real-time/package-lock.json +1 -1
- package/package.json +2 -2
- package/dist/shell/assets/index-Cf61cNfT.css +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// `"engine": { "dropEmptyParts": true }` (engine3d/world3d.js, optimize.js
|
|
2
|
-
// `dropEmptyGroups`;
|
|
2
|
+
// `dropEmptyGroups`; docs/engine-skip-work.md has the terms), on the real `syncActors` and
|
|
3
3
|
// real models: the kit's own, and the hub town's and hub-game's when this
|
|
4
4
|
// checkout has them.
|
|
5
5
|
//
|
|
@@ -185,7 +185,7 @@ function materialOf(material) {
|
|
|
185
185
|
|
|
186
186
|
// Everything a frame draws: each actor's meshes and outlines in the order
|
|
187
187
|
// three.js walks them, with what each is drawn from and where.
|
|
188
|
-
function drawn(world) {
|
|
188
|
+
export function drawn(world) {
|
|
189
189
|
const lines = [];
|
|
190
190
|
for (const [id, entry] of world.nodes) {
|
|
191
191
|
entry.node.traverseVisible((object) => {
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
// Opt-in empty hint consumption: exact animation/actor parity, including
|
|
2
|
+
// scene switches, editor worlds, late hints and inherited/undefined fields.
|
|
3
|
+
import assert from 'node:assert/strict';
|
|
4
|
+
import fs from 'node:fs';
|
|
5
|
+
import * as THREE from 'three';
|
|
6
|
+
import { makeWorld } from './test-static-passes.mjs';
|
|
7
|
+
import { drawn } from './test-drop-empty-parts.mjs';
|
|
8
|
+
const { takeWalkSpeedHint, takeWalkSpeedHintIfPresent, setWalkGait } = await import('../engine3d/gait.js');
|
|
9
|
+
const { animateModelParts } = await import('../engine3d/pxmodel.js');
|
|
10
|
+
const { animateMotion } = await import('../engine3d/motion.js');
|
|
11
|
+
const { syncActors, disposeWorld } = await import('../engine3d/world3d.js');
|
|
12
|
+
|
|
13
|
+
export function run() {
|
|
14
|
+
const descriptor = Object.getOwnPropertyDescriptor(globalThis, 'performance');
|
|
15
|
+
let reads = 0;
|
|
16
|
+
Object.defineProperty(globalThis, 'performance', { configurable: true, value: { now: () => { reads++; return 1000; } } });
|
|
17
|
+
let checks = 0;
|
|
18
|
+
const equal = (a, b) => { checks++; assert.deepEqual(a, b); };
|
|
19
|
+
try {
|
|
20
|
+
for (const fields of [{}, { walkSpeedHint: undefined }, { walkTimeHint: 0.1 }, { walkHintAt: 999 },
|
|
21
|
+
{ walkSpeedHint: 4, walkTimeHint: 0.05, walkHintAt: 999 },
|
|
22
|
+
{ walkSpeedHint: -4, walkHintAt: 900 }, { walkSpeedHint: 4, walkHintAt: 899 },
|
|
23
|
+
{ walkSpeedHint: 4, walkHintAt: 1001 }, { walkSpeedHint: NaN, walkHintAt: 999 }]) {
|
|
24
|
+
for (const inherited of [false, true]) {
|
|
25
|
+
const data = () => inherited ? Object.create({ ...fields }) : { ...fields };
|
|
26
|
+
const off = { userData: data() }, on = { userData: data() };
|
|
27
|
+
equal(takeWalkSpeedHintIfPresent(on, 1000), takeWalkSpeedHint(off, 1000));
|
|
28
|
+
equal(Object.getOwnPropertyDescriptors(on.userData), Object.getOwnPropertyDescriptors(off.userData));
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
setWalkGait('model');
|
|
32
|
+
for (const fast of [false, true]) {
|
|
33
|
+
const entry = { node: new THREE.Group() };
|
|
34
|
+
reads = 0;
|
|
35
|
+
animateModelParts(entry, 1 / 60, undefined, fast);
|
|
36
|
+
animateMotion(entry, 1 / 60, null, undefined, fast);
|
|
37
|
+
equal(reads, fast ? 0 : 2);
|
|
38
|
+
equal('walkFrameHint' in entry, false);
|
|
39
|
+
// A hint arriving between animators must still be consumed.
|
|
40
|
+
animateModelParts(entry, 1 / 60, undefined, fast);
|
|
41
|
+
Object.assign(entry.node.userData, { walkSpeedHint: 4, walkTimeHint: 0.05, walkHintAt: 1000 });
|
|
42
|
+
animateMotion(entry, 1 / 60, null, undefined, fast);
|
|
43
|
+
equal(Object.keys(entry.node.userData), []);
|
|
44
|
+
}
|
|
45
|
+
const files = Object.fromEntries(['player.pxmodel', 'templates/quadruped.pxmodel'].map(name =>
|
|
46
|
+
['models/' + name, fs.readFileSync(new URL('../models/' + name, import.meta.url), 'utf8')]));
|
|
47
|
+
function side(fast, skip, editor) {
|
|
48
|
+
const actors = Object.keys(files).map((file, i) => ({ id: 'walker-' + i, runtime: {}, components: {
|
|
49
|
+
Transform: { x: i * 3, y: 0, z: 0, rotationX: 0, rotationY: 0, rotationZ: 0 }, Model: { file, scale: 1 },
|
|
50
|
+
} }));
|
|
51
|
+
actors.push({ id: 'empty', runtime: {}, components: { Transform: { x: 0, y: 0, z: 3 } } });
|
|
52
|
+
return { world: Object.assign(makeWorld(), editor ? { staticActorsOff: true } : {}), runtime: {
|
|
53
|
+
data: { engine: fast ? { skipEmptyGaitHints: true } : {}, ground: { color: '#445566' } },
|
|
54
|
+
skipsUnchangedActors: skip, scenePath: 'scenes/main.scene', files, actors, getActors() { return this.actors; },
|
|
55
|
+
} };
|
|
56
|
+
}
|
|
57
|
+
for (const skip of [false, true]) for (const editor of [false, true]) {
|
|
58
|
+
const off = side(false, skip, editor), on = side(true, skip, editor);
|
|
59
|
+
for (let frame = 0; frame < 24; frame++) {
|
|
60
|
+
for (const s of [off, on]) {
|
|
61
|
+
// Switch scene and toggle the key in both directions without cache state.
|
|
62
|
+
if (frame === 8) { s.runtime.scenePath = 'scenes/next.scene'; s.runtime.data.engine = {}; }
|
|
63
|
+
if (frame === 16) s.runtime.data.engine = s === on ? { skipEmptyGaitHints: true } : {};
|
|
64
|
+
for (const actor of s.runtime.actors) actor.components.Transform.x += 0.05;
|
|
65
|
+
for (const entry of s.world.nodes.values()) if (frame % 3 === 0) Object.assign(entry.node.userData,
|
|
66
|
+
{ walkSpeedHint: 3, walkTimeHint: 0.05, walkHintAt: frame % 6 ? 999 : 800 });
|
|
67
|
+
syncActors(s.world, s.runtime, {}, editor ? 0 : 1 / 60);
|
|
68
|
+
s.world.scene.updateMatrixWorld(true);
|
|
69
|
+
}
|
|
70
|
+
equal(drawn(on.world), drawn(off.world));
|
|
71
|
+
equal(JSON.stringify(on.runtime.actors), JSON.stringify(off.runtime.actors));
|
|
72
|
+
equal([...on.world.nodes].map(([id, e]) => [id, Object.keys(e), Object.keys(e.node.userData)]),
|
|
73
|
+
[...off.world.nodes].map(([id, e]) => [id, Object.keys(e), Object.keys(e.node.userData)]));
|
|
74
|
+
}
|
|
75
|
+
disposeWorld(off.world); disposeWorld(on.world);
|
|
76
|
+
}
|
|
77
|
+
// Even an opted-in editor still takes the original two empty clock reads.
|
|
78
|
+
const editor = side(true, false, true);
|
|
79
|
+
syncActors(editor.world, editor.runtime, {}, 0);
|
|
80
|
+
reads = 0; syncActors(editor.world, editor.runtime, {}, 0);
|
|
81
|
+
assert.ok(reads >= editor.runtime.actors.length * 2);
|
|
82
|
+
disposeWorld(editor.world);
|
|
83
|
+
return `${checks} empty-gait hint and animation parity checks`;
|
|
84
|
+
} finally {
|
|
85
|
+
Object.defineProperty(globalThis, 'performance', descriptor);
|
|
86
|
+
setWalkGait('fixed');
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
if (process.argv[1] && import.meta.url === new URL('file://' + process.argv[1]).href) console.log(run());
|
|
@@ -0,0 +1,438 @@
|
|
|
1
|
+
// The Player's walking bob under the frame cap (`"engine": { "maxFps": 60 }`,
|
|
2
|
+
// engine3d/framecap.js), against the same frames uncapped.
|
|
3
|
+
//
|
|
4
|
+
// The real Player drives the real Physics3DSystem (accumulator, fixed 1/60
|
|
5
|
+
// steps, at most four a frame, interpolated write-back, the follow camera
|
|
6
|
+
// placed last), frame by frame as Scene3DPlayer's tick drives them: the real
|
|
7
|
+
// `nextFrame` decides from made-up requestAnimationFrame timestamps which
|
|
8
|
+
// animation frames run and what dt each is handed (at most 0.033 s uncapped,
|
|
9
|
+
// 3/60 capped). On flat ground the player walks forward without stopping;
|
|
10
|
+
// what is measured is the drawn (interpolated Transform) height, peak to peak
|
|
11
|
+
// and rms, the camera's height and its distance from the player as drawn
|
|
12
|
+
// (peak to peak: how much the player slides about on screen), and the drawn
|
|
13
|
+
// horizontal speed (distance over the dt handed), on each frame that ran.
|
|
14
|
+
//
|
|
15
|
+
// The frames: a steady 60 Hz page; a 120 Hz display, every refresh a frame
|
|
16
|
+
// uncapped and every second one capped at 60; and three slow-phone traces like
|
|
17
|
+
// the TECNO KJ5's (frames 25-55 ms, mean about 32, with a hitch of 60-80 ms
|
|
18
|
+
// now and then), each made from its own seed.
|
|
19
|
+
//
|
|
20
|
+
// What it shows (docs/engine-frame-cap.md has the account): without the
|
|
21
|
+
// cap, a dt clamp of 0.033 s turns every slow-phone frame longer than 33 ms
|
|
22
|
+
// into the same dt, two physics steps less 0.3 ms, so the accumulator's carry
|
|
23
|
+
// barely moves from frame to frame. Under the cap each frame is handed what it
|
|
24
|
+
// took, 25 to 50 ms, and the carry jumps about anywhere in [0, 1/60) every
|
|
25
|
+
// frame. The keyless hover and fall-faster pull are impulses scaled by the
|
|
26
|
+
// frame's dt while gravity acts per fixed step, so each frame the player gains
|
|
27
|
+
// g x (dt - steps / 60), which is g x (the change in the carry): the vertical
|
|
28
|
+
// velocity follows the carry, and the drawn height bobs with it. The
|
|
29
|
+
// `"reverted"` rows play the Player as the reverted cap had it (the loop
|
|
30
|
+
// capped, the Player not told) and must bob at least 1.5 times as much as
|
|
31
|
+
// uncapped on the slow-phone traces (2.5 times on whole 60 Hz refreshes); the capped rows (the Player told, so the
|
|
32
|
+
// hover and pull are forces per step, as under the camera key) must bob no
|
|
33
|
+
// more than uncapped on every trace, nor slide about on screen more (the
|
|
34
|
+
// keyless follow camera is placed at the end of a capped frame and eased
|
|
35
|
+
// exactly, Player.jsx `placeCapped`), stand at the camera key's height, and
|
|
36
|
+
// jump as high as under it, to within a centimetre.
|
|
37
|
+
//
|
|
38
|
+
// With the key absent nothing here differs from main: `scene.maxFps` is 0 and
|
|
39
|
+
// the Player takes the code it always did (test-steady-hover.mjs holds that
|
|
40
|
+
// path to main's calls, call for call).
|
|
41
|
+
//
|
|
42
|
+
// Where `@dimforge/rapier3d-compat` is installed (this kit's node_modules or
|
|
43
|
+
// above, or `CASTLE_RAPIER=<path to rapier.mjs>`) everything is run again on
|
|
44
|
+
// rapier itself, with the orbit camera too; otherwise on a stand-in only.
|
|
45
|
+
// test-static-actors.mjs runs it (`npm run check`).
|
|
46
|
+
// node scripts/test-frame-cap-bob.mjs [--table]
|
|
47
|
+
import assert from 'node:assert/strict';
|
|
48
|
+
import { existsSync } from 'node:fs';
|
|
49
|
+
import { register } from 'node:module';
|
|
50
|
+
import { dirname, join, resolve as resolvePath } from 'node:path';
|
|
51
|
+
import { fileURLToPath, pathToFileURL } from 'node:url';
|
|
52
|
+
import { PerspectiveCamera } from 'three';
|
|
53
|
+
import { makeFrameClock, nextFrame } from '../engine3d/framecap.js';
|
|
54
|
+
|
|
55
|
+
// A stand-in rapier, as test-steady-hover.mjs has it: a step pushes the frame's
|
|
56
|
+
// impulses first, then gravity and forces spread over four sub-steps; flat
|
|
57
|
+
// ground at y 0 under a 1.4 m capsule.
|
|
58
|
+
const fakeRapier = `
|
|
59
|
+
const SUBSTEPS = 4;
|
|
60
|
+
export const init = async () => {};
|
|
61
|
+
export const RigidBodyType = { Dynamic: 0, Fixed: 1, KinematicPositionBased: 2, KinematicVelocityBased: 3 };
|
|
62
|
+
export const ActiveEvents = { COLLISION_EVENTS: 1 };
|
|
63
|
+
export const QueryFilterFlags = { EXCLUDE_SENSORS: 1 };
|
|
64
|
+
class Desc {
|
|
65
|
+
constructor(type) { this.type = type; this.at = { x: 0, y: 0, z: 0 }; this.gravityScale = 1; }
|
|
66
|
+
setTranslation(x, y, z) { this.at = { x, y, z }; return this; }
|
|
67
|
+
setRotation() { return this; }
|
|
68
|
+
setGravityScale(scale) { this.gravityScale = scale; return this; }
|
|
69
|
+
lockRotations() { return this; }
|
|
70
|
+
}
|
|
71
|
+
export const RigidBodyDesc = { dynamic: () => new Desc(0), fixed: () => new Desc(1), kinematicPositionBased: () => new Desc(2) };
|
|
72
|
+
const collider = () => { const d = { setFriction: () => d, setRestitution: () => d, setSensor: () => d, setActiveEvents: () => d }; return d; };
|
|
73
|
+
export const ColliderDesc = { ball: collider, capsule: collider, cylinder: collider, cuboid: collider };
|
|
74
|
+
export class Ray { constructor(origin, dir) { this.origin = origin; this.dir = dir; } }
|
|
75
|
+
export class EventQueue { drainCollisionEvents() {} free() {} }
|
|
76
|
+
class Body {
|
|
77
|
+
constructor(desc) { this.type = desc.type; this.pos = { ...desc.at }; this.vel = { x: 0, y: 0, z: 0 }; this.force = { x: 0, y: 0, z: 0 }; this.gravityScale = desc.gravityScale; }
|
|
78
|
+
bodyType() { return this.type; }
|
|
79
|
+
isDynamic() { return this.type === 0; }
|
|
80
|
+
mass() { return 1.5; }
|
|
81
|
+
translation() { return { ...this.pos }; }
|
|
82
|
+
rotation() { return { x: 0, y: 0, z: 0, w: 1 }; }
|
|
83
|
+
linvel() { return { ...this.vel }; }
|
|
84
|
+
setLinvel(v) { this.vel = { x: v.x, y: v.y, z: v.z }; }
|
|
85
|
+
setTranslation(p) { this.pos = { x: p.x, y: p.y, z: p.z }; }
|
|
86
|
+
setRotation() {}
|
|
87
|
+
setNextKinematicTranslation(p) { this.pos = { x: p.x, y: p.y, z: p.z }; }
|
|
88
|
+
setNextKinematicRotation() {}
|
|
89
|
+
applyImpulse(j) { for (const k of ['x', 'y', 'z']) this.vel[k] += j[k] / this.mass(); }
|
|
90
|
+
addForce(f) { for (const k of ['x', 'y', 'z']) this.force[k] += f[k]; }
|
|
91
|
+
resetForces() { this.force = { x: 0, y: 0, z: 0 }; }
|
|
92
|
+
}
|
|
93
|
+
export class World {
|
|
94
|
+
constructor(gravity) { this.gravity = gravity; this.bodies = new Set(); this.timestep = 1 / 60; this.handles = 0; }
|
|
95
|
+
createRigidBody(desc) { const body = new Body(desc); this.bodies.add(body); return body; }
|
|
96
|
+
createCollider() { return { handle: (this.handles += 1) }; }
|
|
97
|
+
removeRigidBody(body) { this.bodies.delete(body); }
|
|
98
|
+
castRay(ray, max) { const d = ray.origin.y; return d >= 0 && d <= max ? { timeOfImpact: d, collider: { handle: -1 } } : null; }
|
|
99
|
+
step() {
|
|
100
|
+
const h = this.timestep / SUBSTEPS;
|
|
101
|
+
for (const body of this.bodies) {
|
|
102
|
+
if (body.type !== 0) continue;
|
|
103
|
+
for (let i = 0; i < SUBSTEPS; i += 1) {
|
|
104
|
+
for (const k of ['x', 'y', 'z']) {
|
|
105
|
+
body.vel[k] += (this.gravity[k] * body.gravityScale + body.force[k] / body.mass()) * h;
|
|
106
|
+
body.pos[k] += body.vel[k] * h;
|
|
107
|
+
}
|
|
108
|
+
if (body.pos.y < 0.7) { body.pos.y = 0.7; body.vel.y = Math.max(0, body.vel.y); }
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
free() {}
|
|
113
|
+
}
|
|
114
|
+
`;
|
|
115
|
+
|
|
116
|
+
// The nearest installed rapier: CASTLE_RAPIER, else from this kit upwards.
|
|
117
|
+
function findRapier() {
|
|
118
|
+
if (process.env.CASTLE_RAPIER) return pathToFileURL(resolvePath(process.env.CASTLE_RAPIER)).href;
|
|
119
|
+
let dir = dirname(dirname(fileURLToPath(import.meta.url)));
|
|
120
|
+
for (;;) {
|
|
121
|
+
const file = join(dir, 'node_modules', '@dimforge', 'rapier3d-compat', 'rapier.mjs');
|
|
122
|
+
if (existsSync(file)) return pathToFileURL(file).href;
|
|
123
|
+
const up = dirname(dir);
|
|
124
|
+
if (up === dir) return null;
|
|
125
|
+
dir = up;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
const realRapier = findRapier();
|
|
129
|
+
|
|
130
|
+
const hooks = `
|
|
131
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
132
|
+
import { fileURLToPath } from 'node:url';
|
|
133
|
+
const fake = 'data:text/javascript,' + encodeURIComponent(${JSON.stringify(fakeRapier)});
|
|
134
|
+
const real = ${JSON.stringify(realRapier)};
|
|
135
|
+
export async function resolve(specifier, context, next) {
|
|
136
|
+
const isRapier = specifier === '@dimforge/rapier3d-compat' ||
|
|
137
|
+
((specifier.startsWith('.') || specifier.startsWith('file:')) &&
|
|
138
|
+
new URL(specifier, context.parentURL).href.endsWith('/kits/physics-3d/engine3d/rapier.js'));
|
|
139
|
+
const parent = context.parentURL ?? '';
|
|
140
|
+
if (isRapier && parent.endsWith('?bob-fake')) return { url: fake, shortCircuit: true };
|
|
141
|
+
if (isRapier && parent.endsWith('?bob-real')) return { url: real, shortCircuit: true };
|
|
142
|
+
if (/\\?bob-(fake|real)$/.test(specifier)) return { url: new URL(specifier, parent).href, shortCircuit: true };
|
|
143
|
+
if (specifier.startsWith('@imports/castle.physics-2d/')) {
|
|
144
|
+
specifier = parent.replace(/\\/kits\\/.*/, '/kits/physics-2d/') + specifier.slice(27);
|
|
145
|
+
}
|
|
146
|
+
if ((specifier.startsWith('.') || specifier.startsWith('file:')) && parent.includes('/kits/') && !/\\.(m?js|jsx|json)(\\?.*)?$/.test(specifier)) {
|
|
147
|
+
const base = new URL(specifier, parent).href;
|
|
148
|
+
for (const ext of ['.js', '.jsx']) if (existsSync(fileURLToPath(base + ext))) return next(base + ext, context);
|
|
149
|
+
}
|
|
150
|
+
return next(specifier, context);
|
|
151
|
+
}
|
|
152
|
+
export async function load(url, context, next) {
|
|
153
|
+
if (url.endsWith('/behaviors/Player.jsx')) {
|
|
154
|
+
return { format: 'module', source: readFileSync(fileURLToPath(url), 'utf8'), shortCircuit: true };
|
|
155
|
+
}
|
|
156
|
+
return next(url, context);
|
|
157
|
+
}`;
|
|
158
|
+
register(`data:text/javascript,${encodeURIComponent(hooks)}`);
|
|
159
|
+
const { Player } = await import('../behaviors/Player.jsx');
|
|
160
|
+
|
|
161
|
+
//
|
|
162
|
+
// Frames
|
|
163
|
+
//
|
|
164
|
+
|
|
165
|
+
const FIXED = 1 / 60;
|
|
166
|
+
|
|
167
|
+
// A small deterministic generator (mulberry32).
|
|
168
|
+
function generator(seed) {
|
|
169
|
+
let s = seed | 0;
|
|
170
|
+
return () => {
|
|
171
|
+
s = (s + 0x6d2b79f5) | 0;
|
|
172
|
+
let t = Math.imul(s ^ (s >>> 15), 1 | s);
|
|
173
|
+
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
|
|
174
|
+
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// requestAnimationFrame timestamps (ms), `seconds` long, from `start`.
|
|
179
|
+
function stamps(kind, seconds, start = 1000) {
|
|
180
|
+
const out = [];
|
|
181
|
+
let now = start;
|
|
182
|
+
const end = start + seconds * 1000;
|
|
183
|
+
if (kind === 'steady60' || kind === '120Hz') {
|
|
184
|
+
const period = 1000 / (kind === '120Hz' ? 120 : 60);
|
|
185
|
+
for (let i = 1; now < end; i += 1) out.push((now = start + i * period));
|
|
186
|
+
return out;
|
|
187
|
+
}
|
|
188
|
+
// A slow phone whose frames land on its display's vsync (90 or 60 Hz): a
|
|
189
|
+
// whole number of refreshes each, mostly three (90 Hz) or two (60 Hz).
|
|
190
|
+
if (kind === 'tecno90' || kind === 'tecno60') {
|
|
191
|
+
const random = generator(kind === 'tecno90' ? 90 : 60);
|
|
192
|
+
const period = kind === 'tecno90' ? 1000 / 90 : 1000 / 60;
|
|
193
|
+
const counts = kind === 'tecno90' ? [[0.3, 2], [0.85, 3], [0.97, 4], [1, 6]] : [[0.1, 1], [0.8, 2], [0.98, 3], [1, 4]];
|
|
194
|
+
for (let i = 0; now < end; ) {
|
|
195
|
+
const r = random();
|
|
196
|
+
i += counts.find(([p]) => r < p)[1];
|
|
197
|
+
out.push((now = start + i * period));
|
|
198
|
+
}
|
|
199
|
+
return out;
|
|
200
|
+
}
|
|
201
|
+
// A slow phone: most frames 25-35 ms, one in eight 35-55 ms, one in fifty a
|
|
202
|
+
// hitch of 60-80 ms. Mean about 32 ms.
|
|
203
|
+
const random = generator({ tecnoA: 1, tecnoB: 2, tecnoC: 3 }[kind] * 7919);
|
|
204
|
+
while (now < end) {
|
|
205
|
+
const r = random();
|
|
206
|
+
const gap = r < 0.02 ? 60 + 20 * random() : r < 0.145 ? 35 + 20 * random() : 25 + 10 * random();
|
|
207
|
+
out.push((now += gap));
|
|
208
|
+
}
|
|
209
|
+
return out;
|
|
210
|
+
}
|
|
211
|
+
const TRACES = ['steady60', '120Hz', 'tecnoA', 'tecnoB', 'tecnoC', 'tecno90', 'tecno60'];
|
|
212
|
+
const SLOW = ['tecnoA', 'tecnoB', 'tecnoC', 'tecno90', 'tecno60'];
|
|
213
|
+
|
|
214
|
+
//
|
|
215
|
+
// A world of one player on flat ground
|
|
216
|
+
//
|
|
217
|
+
|
|
218
|
+
const newPlayer = () => ({
|
|
219
|
+
id: 'player',
|
|
220
|
+
components: {
|
|
221
|
+
Transform: { x: 0, y: 1, z: 0, rotationX: 0, rotationY: 0, rotationZ: 0, scaleX: 1, scaleY: 1, scaleZ: 1 },
|
|
222
|
+
Shape: { kind: 'capsule', radius: 0.35, height: 1.4 },
|
|
223
|
+
Body: { type: 'dynamic', lockRotations: true, friction: 0, gravityScale: 2 },
|
|
224
|
+
Solid: {},
|
|
225
|
+
Player: { ...Player.defaultProps },
|
|
226
|
+
},
|
|
227
|
+
runtime: {},
|
|
228
|
+
});
|
|
229
|
+
|
|
230
|
+
// `camera` is 'none' (no camera key), 'rigid' or 'orbit'. `told` is the cap
|
|
231
|
+
// the Player reads (`scene.maxFps`); the loop's own cap is the run's.
|
|
232
|
+
async function makeWorld(Physics3DSystem, camera, told) {
|
|
233
|
+
const system = new Physics3DSystem();
|
|
234
|
+
const cam = new PerspectiveCamera(70, 20 / 9, 0.1, 500);
|
|
235
|
+
const scene = {
|
|
236
|
+
time: 0,
|
|
237
|
+
keys: new Set(),
|
|
238
|
+
moveInput: null,
|
|
239
|
+
persistent: {},
|
|
240
|
+
three: { camera: cam },
|
|
241
|
+
cameraFollowsRigidly: camera !== 'none',
|
|
242
|
+
cameraControl: camera === 'orbit' ? 'orbit' : null,
|
|
243
|
+
maxFps: told,
|
|
244
|
+
skipsUnchangedActors: false,
|
|
245
|
+
data: {},
|
|
246
|
+
actors: [newPlayer()],
|
|
247
|
+
actorsWith: () => [],
|
|
248
|
+
getActors: () => scene.actors,
|
|
249
|
+
getActor: (id) => scene.actors.find((a) => a.id === id),
|
|
250
|
+
forEachBehavior: () => {},
|
|
251
|
+
};
|
|
252
|
+
system.attach(scene);
|
|
253
|
+
const player = new Player(scene.actors[0].components.Player);
|
|
254
|
+
const frame = (dt, keys) => {
|
|
255
|
+
scene.time += dt;
|
|
256
|
+
scene.keys = new Set(keys);
|
|
257
|
+
player.update(scene.actors[0], scene, dt);
|
|
258
|
+
system.afterBehaviors(scene, dt);
|
|
259
|
+
};
|
|
260
|
+
for (let i = 0; i < 200 && !scene.physics3d.ready(); i += 1) {
|
|
261
|
+
await new Promise((resolve) => setTimeout(resolve, 5));
|
|
262
|
+
frame(FIXED, []);
|
|
263
|
+
}
|
|
264
|
+
assert.ok(scene.physics3d.ready(), 'physics is ready');
|
|
265
|
+
return { system, scene, cam, frame, t: () => scene.actors[0].components.Transform };
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
const spread = (values) => Math.max(...values) - Math.min(...values);
|
|
269
|
+
const rms = (values) => {
|
|
270
|
+
const mean = values.reduce((a, b) => a + b, 0) / values.length;
|
|
271
|
+
return Math.sqrt(values.reduce((a, b) => a + (b - mean) ** 2, 0) / values.length);
|
|
272
|
+
};
|
|
273
|
+
const mean = (values) => values.reduce((a, b) => a + b, 0) / values.length;
|
|
274
|
+
|
|
275
|
+
// Stand for 3 s, then walk forward for 12 s on `trace`'s frames, the loop
|
|
276
|
+
// capped at `cap` (0 for none) and the Player told `told`. Measured from 2 s
|
|
277
|
+
// into the walk, on every frame that ran.
|
|
278
|
+
async function walk(Physics3DSystem, camera, trace, cap, told) {
|
|
279
|
+
const world = await makeWorld(Physics3DSystem, camera, told);
|
|
280
|
+
const times = stamps(trace, 15);
|
|
281
|
+
const clock = makeFrameClock(1000);
|
|
282
|
+
const drawn = [];
|
|
283
|
+
const camY = [];
|
|
284
|
+
const camDist = [];
|
|
285
|
+
const speed = [];
|
|
286
|
+
const dts = [];
|
|
287
|
+
let rest = null;
|
|
288
|
+
let last = null;
|
|
289
|
+
for (const now of times) {
|
|
290
|
+
const dt = nextFrame(clock, now, cap);
|
|
291
|
+
if (dt === null) continue;
|
|
292
|
+
const walking = now >= 4000;
|
|
293
|
+
if (walking && rest === null) rest = world.t().y;
|
|
294
|
+
world.frame(dt, walking ? ['KeyW'] : []);
|
|
295
|
+
const t = world.t();
|
|
296
|
+
if (now >= 6000) {
|
|
297
|
+
const c = world.cam.position;
|
|
298
|
+
drawn.push(t.y);
|
|
299
|
+
camY.push(c.y);
|
|
300
|
+
// The camera to the player as the frame draws them: a steady walk
|
|
301
|
+
// keeps one distance when the player holds one place on screen.
|
|
302
|
+
camDist.push(Math.hypot(c.x - t.x, c.y - t.y, c.z - t.z));
|
|
303
|
+
dts.push(dt);
|
|
304
|
+
if (last) speed.push(Math.hypot(t.x - last.x, t.z - last.z) / dt);
|
|
305
|
+
}
|
|
306
|
+
last = { x: t.x, z: t.z };
|
|
307
|
+
}
|
|
308
|
+
const v = mean(speed);
|
|
309
|
+
return {
|
|
310
|
+
pp: spread(drawn),
|
|
311
|
+
rms: rms(drawn),
|
|
312
|
+
camPP: spread(camY),
|
|
313
|
+
distPP: spread(camDist),
|
|
314
|
+
rest,
|
|
315
|
+
walkY: mean(drawn),
|
|
316
|
+
speed: v,
|
|
317
|
+
jitter: rms(speed) / v,
|
|
318
|
+
frames: dts.length,
|
|
319
|
+
meanDt: mean(dts),
|
|
320
|
+
};
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
// The highest the drawn player gets from one jump, 1 s into a walk.
|
|
324
|
+
async function jumpApex(Physics3DSystem, camera, trace, cap, told) {
|
|
325
|
+
const world = await makeWorld(Physics3DSystem, camera, told);
|
|
326
|
+
const clock = makeFrameClock(1000);
|
|
327
|
+
let jumped = false;
|
|
328
|
+
let apex = -Infinity;
|
|
329
|
+
for (const now of stamps(trace, 7)) {
|
|
330
|
+
const dt = nextFrame(clock, now, cap);
|
|
331
|
+
if (dt === null) continue;
|
|
332
|
+
const jump = !jumped && now >= 5000;
|
|
333
|
+
jumped ||= jump;
|
|
334
|
+
world.frame(dt, now >= 4000 ? (jump ? ['KeyW', 'Space'] : ['KeyW']) : []);
|
|
335
|
+
if (jumped) apex = Math.max(apex, world.t().y);
|
|
336
|
+
}
|
|
337
|
+
return apex;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
// The configurations: uncapped (the key absent), capped as the reverted cap
|
|
341
|
+
// had it (the Player not told), and capped as it is now.
|
|
342
|
+
const RUNS = [
|
|
343
|
+
{ name: 'uncapped', cap: 0, told: 0 },
|
|
344
|
+
{ name: 'reverted', cap: 60, told: 0 },
|
|
345
|
+
{ name: 'capped', cap: 60, told: 60 },
|
|
346
|
+
];
|
|
347
|
+
|
|
348
|
+
async function runOn(Physics3DSystem, label, cameras) {
|
|
349
|
+
const rows = [];
|
|
350
|
+
for (const camera of cameras) {
|
|
351
|
+
for (const trace of TRACES) {
|
|
352
|
+
const row = { label, camera, trace };
|
|
353
|
+
for (const run of RUNS) row[run.name] = await walk(Physics3DSystem, camera, trace, run.cap, run.told);
|
|
354
|
+
rows.push(row);
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
// A capped jump goes as high as one under the camera key, uncapped.
|
|
358
|
+
const jumps = [];
|
|
359
|
+
for (const trace of ['steady60', '120Hz', 'tecnoA', 'tecno60']) {
|
|
360
|
+
jumps.push({ label, trace, capped: await jumpApex(Physics3DSystem, 'none', trace, 60, 60), keyed: await jumpApex(Physics3DSystem, 'rigid', trace, 0, 0) });
|
|
361
|
+
}
|
|
362
|
+
return { rows, jumps };
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
// What must hold of every row; the number of checks.
|
|
366
|
+
function judge(rows) {
|
|
367
|
+
let checks = 0;
|
|
368
|
+
const keyed = rows.filter((row) => row.camera === 'rigid');
|
|
369
|
+
for (const row of rows) {
|
|
370
|
+
const where = `${row.label} ${row.camera} ${row.trace}`;
|
|
371
|
+
const { uncapped, reverted, capped } = row;
|
|
372
|
+
// Walking at speed throughout (the player did walk).
|
|
373
|
+
for (const run of RUNS) assert.ok(Math.abs(row[run.name].speed - Player.defaultProps.speed) < 0.05, `${where} ${run.name}: walks at its speed (${row[run.name].speed})`);
|
|
374
|
+
// The fix: capped bobs no more than uncapped, on every trace (a tenth of
|
|
375
|
+
// a millimetre of slack for rounding), and the horizontal speed is no
|
|
376
|
+
// less steady.
|
|
377
|
+
assert.ok(capped.pp <= uncapped.pp + 1e-4, `${where}: capped bob ${capped.pp} m against ${uncapped.pp} m uncapped`);
|
|
378
|
+
assert.ok(capped.rms <= uncapped.rms + 1e-4, `${where}: capped rms ${capped.rms} m against ${uncapped.rms} m uncapped`);
|
|
379
|
+
assert.ok(capped.jitter <= uncapped.jitter + 1e-3, `${where}: capped speed jitter ${capped.jitter} against ${uncapped.jitter}`);
|
|
380
|
+
// And the camera holds the player as steady on screen: its height and
|
|
381
|
+
// its distance from the player as drawn move no more than uncapped.
|
|
382
|
+
assert.ok(capped.camPP <= uncapped.camPP + 1e-4, `${where}: capped camera height ${capped.camPP} m against ${uncapped.camPP} m uncapped`);
|
|
383
|
+
assert.ok(capped.distPP <= uncapped.distPP + 1e-4, `${where}: capped camera distance ${capped.distPP} m against ${uncapped.distPP} m uncapped`);
|
|
384
|
+
// The capped player walks within 1 mm of the camera key's height (the
|
|
385
|
+
// steady hover's), whatever the frames.
|
|
386
|
+
const steady = keyed.find((k) => k.label === row.label && k.trace === row.trace).uncapped;
|
|
387
|
+
assert.ok(Math.abs(capped.walkY - steady.walkY) < 1e-3, `${where}: capped walks at ${capped.walkY}, the camera key's height ${steady.walkY}`);
|
|
388
|
+
checks += 7;
|
|
389
|
+
// The reproduction: without the camera key, the reverted cap bobs half
|
|
390
|
+
// as much again as uncapped on a slow phone, and over two and a half
|
|
391
|
+
// times as much where its frames are whole 60 Hz refreshes (the uncapped
|
|
392
|
+
// clamp makes nearly every one of those the same dt).
|
|
393
|
+
if (row.camera === 'none' && SLOW.includes(row.trace)) {
|
|
394
|
+
const more = row.trace === 'tecno60' ? 2.5 : 1.5;
|
|
395
|
+
assert.ok(reverted.pp > more * uncapped.pp, `${where}: the reverted cap bobs ${reverted.pp} m against ${uncapped.pp} m uncapped`);
|
|
396
|
+
checks += 1;
|
|
397
|
+
}
|
|
398
|
+
}
|
|
399
|
+
return checks;
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
export async function run({ table = false } = {}) {
|
|
403
|
+
const results = [];
|
|
404
|
+
const fake = await import('../systems/physics3d.js?bob-fake');
|
|
405
|
+
results.push(['stand-in', await runOn(fake.Physics3DSystem, 'stand-in rapier', ['none', 'rigid'])]);
|
|
406
|
+
if (realRapier) {
|
|
407
|
+
const real = await import('../systems/physics3d.js?bob-real');
|
|
408
|
+
results.push(['rapier', await runOn(real.Physics3DSystem, 'rapier', ['none', 'rigid', 'orbit'])]);
|
|
409
|
+
}
|
|
410
|
+
if (table) {
|
|
411
|
+
const mm = (v) => (v * 1000).toFixed(2).padStart(6);
|
|
412
|
+
const pct = (v) => (v * 100).toFixed(2).padStart(5);
|
|
413
|
+
for (const [name, { rows }] of results) {
|
|
414
|
+
console.log(`${name}: walking; drawn height p-p / rms, camera height p-p and camera-to-player distance p-p in mm, speed jitter in %, walking height in m`);
|
|
415
|
+
console.log(' camera trace | uncapped: pp rms camPP camDist jit height | reverted: pp rms camPP camDist jit height | capped: pp rms camPP camDist jit height | frames dt(ms) unc/cap');
|
|
416
|
+
for (const row of rows) {
|
|
417
|
+
const cell = (r) => `${mm(r.pp)} ${mm(r.rms)} ${mm(r.camPP)} ${mm(r.distPP)} ${pct(r.jitter)} ${r.walkY.toFixed(4)}`;
|
|
418
|
+
console.log(
|
|
419
|
+
` ${row.camera.padEnd(6)} ${row.trace.padEnd(9)} | ${cell(row.uncapped)} | ${cell(row.reverted)} | ${cell(row.capped)} | ${(row.uncapped.meanDt * 1000).toFixed(1)}/${(row.capped.meanDt * 1000).toFixed(1)}`
|
|
420
|
+
);
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
}
|
|
424
|
+
let checks = judge(results.flatMap(([, result]) => result.rows));
|
|
425
|
+
for (const { label, trace, capped, keyed } of results.flatMap(([, result]) => result.jumps)) {
|
|
426
|
+
if (table) console.log(`${label} ${trace}: jump apex ${capped.toFixed(4)} m capped, ${keyed.toFixed(4)} m under the camera key uncapped`);
|
|
427
|
+
assert.ok(capped > 2 && Math.abs(capped - keyed) < 0.01, `${label} ${trace}: a capped jump reaches ${capped} m, ${keyed} m under the camera key`);
|
|
428
|
+
checks += 1;
|
|
429
|
+
}
|
|
430
|
+
return { checks, real: Boolean(realRapier) };
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
export const summary = ({ checks, real }) =>
|
|
434
|
+
`${checks} frame-cap bob checks (${real ? 'on a stand-in rapier and on rapier itself' : 'on a stand-in rapier; rapier itself is not installed here, so that half was skipped'})`;
|
|
435
|
+
|
|
436
|
+
if (import.meta.url === `file://${process.argv[1]}`) {
|
|
437
|
+
console.log(summary(await run({ table: process.argv.includes('--table') })));
|
|
438
|
+
}
|