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
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
// Generated from ../../behaviors/Joints.jsx; run npm run sync:play-behaviors.
|
|
2
|
+
import { layoutCenter } from '../../engine/layout';
|
|
3
|
+
import { inActorWorldSpace } from '../../engine/physics/controls';
|
|
4
|
+
import '../../engine/physics/joints';
|
|
5
|
+
import { drawJointArt } from '../../engine/physics/jointArt';
|
|
6
|
+
|
|
7
|
+
// Joints: connect this actor to one or more `target` actors with physics links.
|
|
8
|
+
// The component holds a LIST so an actor can carry several links at once (a
|
|
9
|
+
// a body both sprung and roped, a truss node). Each entry picks a TYPE -- spring
|
|
10
|
+
// (elastic), rod (rigid stick, ends rotate; also the hinge -- to a static anchor),
|
|
11
|
+
// weld (fused, no relative rotation), rope (slack, taut at max length). The
|
|
12
|
+
// simulation builds the matter constraints
|
|
13
|
+
// (see physics/joints.js); this behavior owns the authoring UI + editor overlay.
|
|
14
|
+
//
|
|
15
|
+
// Both actors of a link need a Collider (to have a body); the owner is usually a
|
|
16
|
+
// dynamic RigidBody and each target either dynamic or a static anchor. `target`
|
|
17
|
+
// is instance-local -- pick it per instance, since a blueprint-level target would
|
|
18
|
+
// point every instance at the same actor.
|
|
19
|
+
class Joints {
|
|
20
|
+
static behaviorName = 'Joints';
|
|
21
|
+
// A link binds two bodies, so the OWNER needs a Collider to have one. Only the
|
|
22
|
+
// owner: the `target` actor needs one too, but it isn't a sibling -- it's a
|
|
23
|
+
// separate actor the author picks later, and inventing a Collider on it isn't
|
|
24
|
+
// this hook's business.
|
|
25
|
+
static expectedSiblings = ['Collider'];
|
|
26
|
+
static defaultProps = { list: [] };
|
|
27
|
+
// A freshly-added Joints behavior starts with one blank link to fill in.
|
|
28
|
+
static initialProps() {
|
|
29
|
+
return { list: [defaultJoint()] };
|
|
30
|
+
}
|
|
31
|
+
constructor(props) {
|
|
32
|
+
this.props = props;
|
|
33
|
+
}
|
|
34
|
+
// Draw every link. In the EDITOR (options.editPlaceholders) it's an authoring
|
|
35
|
+
// overlay -- always shown so connections are visible, sprite-art previewed
|
|
36
|
+
// WYSIWYG, and even `hidden` joints drawn as a faint line so you don't lose
|
|
37
|
+
// them. In PLAY each joint's `render` decides: `hidden` (nothing), `line` (the
|
|
38
|
+
// schematic) or `sprite` (art along the joint). Drawn in world space so the
|
|
39
|
+
// link doesn't spin with the actor's rotation (see inActorWorldSpace).
|
|
40
|
+
draw(actor, scene, ctx, options) {
|
|
41
|
+
const list = Array.isArray(this.props.list) ? this.props.list : [];
|
|
42
|
+
if (!list.length)
|
|
43
|
+
return;
|
|
44
|
+
const editing = Boolean(options.editPlaceholders);
|
|
45
|
+
const emphasized = options.colliderOverlayIds?.includes(actor.id) ||
|
|
46
|
+
scene.usesBlueprint(actor, options.dimBlueprintPath);
|
|
47
|
+
const a = layoutCenter(actor.components.Layout);
|
|
48
|
+
inActorWorldSpace(ctx, actor.components.Layout, (g) => {
|
|
49
|
+
for (const joint of list) {
|
|
50
|
+
const target = joint?.target && scene.getActor(joint.target);
|
|
51
|
+
if (!target || target.id === actor.id)
|
|
52
|
+
continue;
|
|
53
|
+
const b = layoutCenter(target.components.Layout);
|
|
54
|
+
// hidden shows as a faint line in the editor, nothing in play.
|
|
55
|
+
let render = joint.render ?? 'line';
|
|
56
|
+
if (editing && render === 'hidden')
|
|
57
|
+
render = 'line';
|
|
58
|
+
if (render === 'hidden')
|
|
59
|
+
continue;
|
|
60
|
+
if (render === 'sprite' && drawJointArt(g, scene, joint, a, b))
|
|
61
|
+
continue;
|
|
62
|
+
g.globalAlpha = editing ? (emphasized ? 1 : 0.45) : 0.7;
|
|
63
|
+
g.strokeStyle = '#c9a9ff';
|
|
64
|
+
g.fillStyle = '#c9a9ff';
|
|
65
|
+
g.lineWidth = 2;
|
|
66
|
+
drawLink(g, a, b, joint.type ?? 'spring');
|
|
67
|
+
g.globalAlpha = 1;
|
|
68
|
+
}
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
function defaultJoint() {
|
|
73
|
+
return { type: 'spring', target: '', length: -1, springiness: 0.4, damping: 0.1, render: 'line' };
|
|
74
|
+
}
|
|
75
|
+
// Draw the link between two world points, styled by joint type: spring coils,
|
|
76
|
+
// rope dashes, weld doubles the line, rod is a plain line.
|
|
77
|
+
function drawLink(ctx, a, b, type) {
|
|
78
|
+
if (type === 'spring')
|
|
79
|
+
return drawCoil(ctx, a, b);
|
|
80
|
+
if (type === 'rope') {
|
|
81
|
+
ctx.setLineDash([6, 5]);
|
|
82
|
+
line(ctx, a, b);
|
|
83
|
+
ctx.setLineDash([]);
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
if (type === 'weld')
|
|
87
|
+
return drawDouble(ctx, a, b);
|
|
88
|
+
line(ctx, a, b); // rod (and any fallthrough)
|
|
89
|
+
}
|
|
90
|
+
function line(ctx, a, b) {
|
|
91
|
+
ctx.beginPath();
|
|
92
|
+
ctx.moveTo(a.x, a.y);
|
|
93
|
+
ctx.lineTo(b.x, b.y);
|
|
94
|
+
ctx.stroke();
|
|
95
|
+
}
|
|
96
|
+
// Two parallel lines offset along the perpendicular -- the "fused" read.
|
|
97
|
+
function drawDouble(ctx, a, b) {
|
|
98
|
+
const dx = b.x - a.x;
|
|
99
|
+
const dy = b.y - a.y;
|
|
100
|
+
const len = Math.hypot(dx, dy) || 1;
|
|
101
|
+
const nx = (-dy / len) * 3;
|
|
102
|
+
const ny = (dx / len) * 3;
|
|
103
|
+
line(ctx, { x: a.x + nx, y: a.y + ny }, { x: b.x + nx, y: b.y + ny });
|
|
104
|
+
line(ctx, { x: a.x - nx, y: a.y - ny }, { x: b.x - nx, y: b.y - ny });
|
|
105
|
+
}
|
|
106
|
+
// A zig-zag coil between the endpoints, straight stubs at each end.
|
|
107
|
+
function drawCoil(ctx, a, b) {
|
|
108
|
+
const dx = b.x - a.x;
|
|
109
|
+
const dy = b.y - a.y;
|
|
110
|
+
const len = Math.hypot(dx, dy) || 1;
|
|
111
|
+
const px = -dy / len;
|
|
112
|
+
const py = dx / len;
|
|
113
|
+
const coils = Math.max(3, Math.min(10, Math.round(len / 22)));
|
|
114
|
+
const amp = 6;
|
|
115
|
+
ctx.beginPath();
|
|
116
|
+
ctx.moveTo(a.x, a.y);
|
|
117
|
+
for (let i = 1; i < coils; i++) {
|
|
118
|
+
const t = i / coils;
|
|
119
|
+
const side = i % 2 === 0 ? 1 : -1;
|
|
120
|
+
ctx.lineTo(a.x + dx * t + px * amp * side, a.y + dy * t + py * amp * side);
|
|
121
|
+
}
|
|
122
|
+
ctx.lineTo(b.x, b.y);
|
|
123
|
+
ctx.stroke();
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export { Joints };
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
// Generated from ../../behaviors/Layout.jsx; run npm run sync:play-behaviors.
|
|
2
|
+
import { DEFAULT_ORIGIN_Y, DEFAULT_ORIGIN_X, layoutRect } from '../../engine/layout';
|
|
3
|
+
|
|
4
|
+
class Layout {
|
|
5
|
+
static behaviorName = 'Layout';
|
|
6
|
+
static defaultProps = {
|
|
7
|
+
x: 0,
|
|
8
|
+
y: 0,
|
|
9
|
+
z: 0,
|
|
10
|
+
rotation: 0,
|
|
11
|
+
width: 50,
|
|
12
|
+
height: 50,
|
|
13
|
+
// Which point of the box `x`/`y` names, as a fraction of the box from its
|
|
14
|
+
// own top-left: `0, 0` top-left, `0.5, 0.5` center (the default, and what
|
|
15
|
+
// an absent origin means -- see DEFAULT_ORIGIN_* in engine/layout.js),
|
|
16
|
+
// `1, 1` bottom-right. Not clamped. Rotation still pivots on the box
|
|
17
|
+
// CENTER -- the origin anchors position only.
|
|
18
|
+
originX: DEFAULT_ORIGIN_X,
|
|
19
|
+
originY: DEFAULT_ORIGIN_Y,
|
|
20
|
+
// Show the Layout box (the invisible frame the sprite fills and the collider
|
|
21
|
+
// derives from) as a dashed outline, in editor and play. Per-actor toggle.
|
|
22
|
+
debug: false,
|
|
23
|
+
};
|
|
24
|
+
// Position first: it is what tells two instances of the same blueprint apart,
|
|
25
|
+
// and the first thing you look for when the panel is shut.
|
|
26
|
+
static summary(props) {
|
|
27
|
+
const round = (n) => Math.round(Number(n) || 0);
|
|
28
|
+
return `${round(props.x)}, ${round(props.y)} · ${round(props.width)}×${round(props.height)}`;
|
|
29
|
+
}
|
|
30
|
+
// Position/rotation/z never inherit from a blueprint: they're always written
|
|
31
|
+
// as instance values at placement time (z gets an explicit top-of-stack value
|
|
32
|
+
// on spawn), and a blueprint edit to its own template x/y/z/rotation only
|
|
33
|
+
// affects newly placed instances, never moves ones already placed. Because
|
|
34
|
+
// they're always instance-local, they're also never surfaced as blueprint
|
|
35
|
+
// "overrides" in the inspector. width/height default to inherited (absent),
|
|
36
|
+
// and so does the origin: it describes the KIND of thing (a ball is placed by
|
|
37
|
+
// its center), so it belongs on the blueprint -- with a per-instance override
|
|
38
|
+
// available like any other inherited prop.
|
|
39
|
+
//
|
|
40
|
+
// Size is width/height in card units -- the same space you compose in. A
|
|
41
|
+
// user-facing scaleX/scaleY (relative to the sprite's native pixels) was
|
|
42
|
+
// tried and reverted: it only pays off under pixel-perfect (integer scales),
|
|
43
|
+
// and in today's card-units model it just adds a conversion + couples Layout
|
|
44
|
+
// to the Sprite. Revisit scale fields when pixel-perfect mode lands. See
|
|
45
|
+
// ~/castle/cauldron-rendering-scale-model.md.
|
|
46
|
+
static propertyMeta = {
|
|
47
|
+
x: { inherit: false },
|
|
48
|
+
y: { inherit: false },
|
|
49
|
+
z: { inherit: false },
|
|
50
|
+
rotation: { inherit: false },
|
|
51
|
+
};
|
|
52
|
+
constructor(props) {
|
|
53
|
+
this.props = props;
|
|
54
|
+
}
|
|
55
|
+
// Outline the Layout box when `debug` is on. Drawn in the actor's own rotated
|
|
56
|
+
// frame (so it rotates with the actor), with a distinct dashed lavender style
|
|
57
|
+
// so it reads separately from the solid collider debug and the selection box.
|
|
58
|
+
draw(actor, scene, ctx) {
|
|
59
|
+
if (!this.props.debug)
|
|
60
|
+
return;
|
|
61
|
+
const rect = layoutRect(this.props);
|
|
62
|
+
ctx.save();
|
|
63
|
+
ctx.strokeStyle = 'rgba(190, 178, 255, 0.75)';
|
|
64
|
+
ctx.setLineDash([4, 3]);
|
|
65
|
+
ctx.lineWidth = 1.5;
|
|
66
|
+
ctx.strokeRect(rect.x + 0.5, rect.y + 0.5, rect.width - 1, rect.height - 1);
|
|
67
|
+
ctx.restore();
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export { Layout };
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// Generated from ../../behaviors/RigidBody.jsx; run npm run sync:play-behaviors.
|
|
2
|
+
import { DAMPING } from '../../engine/propertyRanges';
|
|
3
|
+
|
|
4
|
+
// RigidBody makes an actor a physics object. Pair it with a Collider (which
|
|
5
|
+
// gives the shape + material). The simulation reads these props each frame; the
|
|
6
|
+
// behavior itself does no per-frame work -- author code drives motion through
|
|
7
|
+
// `scene.physics` (setVelocity / applyImpulse / applyForce).
|
|
8
|
+
//
|
|
9
|
+
// bodyType 'dynamic' -> simulated: gravity, collisions, forces move it.
|
|
10
|
+
// 'static' -> never moves (a wall); a Collider alone is also this.
|
|
11
|
+
// 'kinematic' -> unpushable, but you move it by writing its Layout.
|
|
12
|
+
// gravityScale -> multiplies world gravity for this body (0 = float).
|
|
13
|
+
// drag -> linear damping (matter frictionAir).
|
|
14
|
+
// angularDrag -> extra spin damping.
|
|
15
|
+
// freezeRotation -> lock rotation (stays upright).
|
|
16
|
+
// velocityX/velocityY -> initial velocity, applied once when play starts.
|
|
17
|
+
class RigidBody {
|
|
18
|
+
static behaviorName = 'RigidBody';
|
|
19
|
+
// No Collider means no body at all (matterBridge's `isPhysicsActor`), so a
|
|
20
|
+
// RigidBody on its own simulates nothing.
|
|
21
|
+
static expectedSiblings = ['Collider'];
|
|
22
|
+
static defaultProps = {
|
|
23
|
+
bodyType: 'dynamic',
|
|
24
|
+
// New bodies float until the author opts into gravity — falling immediately
|
|
25
|
+
// on add is the common surprise when placing a dynamic body to push around.
|
|
26
|
+
gravityScale: 0,
|
|
27
|
+
drag: 0.01,
|
|
28
|
+
angularDrag: 0,
|
|
29
|
+
freezeRotation: false,
|
|
30
|
+
velocityX: 0,
|
|
31
|
+
velocityY: 0,
|
|
32
|
+
// Initial spin, degrees per fixed step (like velocityX/Y are px per step),
|
|
33
|
+
// applied once when play starts.
|
|
34
|
+
angularVelocity: 0,
|
|
35
|
+
};
|
|
36
|
+
// Body type is the whole question about a rigid body: does this thing fall,
|
|
37
|
+
// sit still, or get pushed around by hand.
|
|
38
|
+
static summary(props) {
|
|
39
|
+
return typeof props.bodyType === 'string' ? props.bodyType : '';
|
|
40
|
+
}
|
|
41
|
+
// `drag`/`angularDrag` are matter's air friction, where values above 1 flip
|
|
42
|
+
// the velocity sign and destabilize the body -- so 1 is a real ceiling, not a
|
|
43
|
+
// convenience. `gravityScale` deliberately has none: negative is legitimate
|
|
44
|
+
// (it inverts gravity), as is scaling well past 1. Drag steps at 0.005 so the
|
|
45
|
+
// scrubber lands on the default (0.01) and the finer authored values kits use.
|
|
46
|
+
static propertyMeta = {
|
|
47
|
+
gravityScale: { step: 0.1 },
|
|
48
|
+
drag: { ...DAMPING, step: 0.005 },
|
|
49
|
+
angularDrag: DAMPING,
|
|
50
|
+
angularVelocity: { step: 0.1 },
|
|
51
|
+
};
|
|
52
|
+
constructor(props) {
|
|
53
|
+
this.props = props;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export { RigidBody };
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
// Generated from ../../behaviors/Slingshot.jsx; run npm run sync:play-behaviors.
|
|
2
|
+
import { PIXELS } from '../../engine/propertyRanges';
|
|
3
|
+
import { acquirePress, TARGETED_CLAIM, GREEDY_CLAIM, slingLaunch, slingPull, inActorWorldSpace } from '../../engine/physics/controls';
|
|
4
|
+
|
|
5
|
+
// Slingshot: pull back and release to fling the actor the opposite way
|
|
6
|
+
// (angry-birds style) -- the physics feel of castle-client's Sling. While
|
|
7
|
+
// aiming it draws an arrow showing the launch direction and power. Needs a
|
|
8
|
+
// RigidBody (dynamic) + Collider.
|
|
9
|
+
//
|
|
10
|
+
// speed -> launch velocity per pixel of pull.
|
|
11
|
+
// maxDrag -> pull distance cap (also caps launch power).
|
|
12
|
+
// grabAnywhere -> start the sling from a press ANYWHERE on screen (default,
|
|
13
|
+
// like castle-client); set false to require pressing the actor.
|
|
14
|
+
class Slingshot {
|
|
15
|
+
static behaviorName = 'Slingshot';
|
|
16
|
+
// Launches a body, so it needs one: Collider + dynamic RigidBody.
|
|
17
|
+
static expectedSiblings = ['Collider', 'RigidBody'];
|
|
18
|
+
static defaultProps = {
|
|
19
|
+
speed: 0.08,
|
|
20
|
+
maxDrag: 160,
|
|
21
|
+
grabAnywhere: true,
|
|
22
|
+
};
|
|
23
|
+
// `speed` is a small multiplier (0.08 default), so whole-number steps were
|
|
24
|
+
// useless here. `maxDrag` is pixels of pull.
|
|
25
|
+
static propertyMeta = {
|
|
26
|
+
speed: { min: 0, step: 0.01 },
|
|
27
|
+
maxDrag: PIXELS,
|
|
28
|
+
};
|
|
29
|
+
static initialState = { slinging: false, pointerId: null, anchor: null, aim: null };
|
|
30
|
+
constructor(props) {
|
|
31
|
+
this.props = props;
|
|
32
|
+
}
|
|
33
|
+
update(actor, scene) {
|
|
34
|
+
const state = this.state;
|
|
35
|
+
if (!state.slinging) {
|
|
36
|
+
const grabAnywhere = this.props.grabAnywhere ?? true;
|
|
37
|
+
const press = acquirePress(scene, actor.id, (p) => {
|
|
38
|
+
// Collider-accurate, at the body's live orientation -- the same pick
|
|
39
|
+
// Draggable uses, so the two agree on what "on this actor" means.
|
|
40
|
+
const onSelf = scene.physics.actorAtPoint(p.x, p.y)?.id === actor.id;
|
|
41
|
+
if (!grabAnywhere && !onSelf)
|
|
42
|
+
return null;
|
|
43
|
+
// Pressing the body itself is an unambiguous aim; taking any press
|
|
44
|
+
// anywhere is not, so it yields to a control that was actually targeted.
|
|
45
|
+
return onSelf ? TARGETED_CLAIM : GREEDY_CLAIM;
|
|
46
|
+
});
|
|
47
|
+
if (press) {
|
|
48
|
+
state.pointerId = press.id;
|
|
49
|
+
state.slinging = true;
|
|
50
|
+
// Anchor at the press point (like castle-client): the aim/launch depends
|
|
51
|
+
// on the drag gesture, not where the press landed relative to the actor.
|
|
52
|
+
state.anchor = { x: press.x, y: press.y };
|
|
53
|
+
// A same-frame tap (down already false) is not an aim — cancel before we
|
|
54
|
+
// can launch with a zero pull. A TARGETED control that updates later this
|
|
55
|
+
// frame may still steal a greedy claim; we must not freeze velocity yet.
|
|
56
|
+
if (!press.down) {
|
|
57
|
+
state.slinging = false;
|
|
58
|
+
state.pointerId = null;
|
|
59
|
+
return;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
if (!state.slinging)
|
|
64
|
+
return;
|
|
65
|
+
const p = scene.pointers.get(state.pointerId);
|
|
66
|
+
// Outranked mid-aim, or the contact was cancelled: drop the shot rather than
|
|
67
|
+
// launching from an anchor the player has stopped steering.
|
|
68
|
+
if (!p || !scene.ownsPointer(state.pointerId, actor.id)) {
|
|
69
|
+
state.slinging = false;
|
|
70
|
+
state.pointerId = null;
|
|
71
|
+
state.aim = null;
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
if (p.down) {
|
|
75
|
+
// Hold still while aiming — but not on the press frame. A greedy claim can
|
|
76
|
+
// still lose to a higher claim that hasn't updated yet (e.g. a Draggable
|
|
77
|
+
// on the pressed body); freezing here would hitch a mid-air body for one frame
|
|
78
|
+
// and then drop the shot with no launch. Matches claimPointer's contract
|
|
79
|
+
// that the press frame costs a greedy control nothing visible.
|
|
80
|
+
if (!p.justPressed)
|
|
81
|
+
scene.physics.setVelocity(actor, { x: 0, y: 0 });
|
|
82
|
+
state.aim = { x: p.x, y: p.y };
|
|
83
|
+
}
|
|
84
|
+
else {
|
|
85
|
+
scene.physics.setVelocity(actor, slingLaunch(state.anchor, p, this.props));
|
|
86
|
+
state.slinging = false;
|
|
87
|
+
state.pointerId = null;
|
|
88
|
+
state.aim = null;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
// Aim overlay in the castle-client style: a translucent grab circle plus a
|
|
92
|
+
// line + arrowhead pointing in the launch direction (opposite the pull).
|
|
93
|
+
draw(actor, scene, ctx) {
|
|
94
|
+
const state = this.state;
|
|
95
|
+
if (!state.slinging || !state.aim)
|
|
96
|
+
return;
|
|
97
|
+
const a = state.anchor;
|
|
98
|
+
const pull = slingPull(a, state.aim, this.props.maxDrag ?? 160);
|
|
99
|
+
const len = Math.hypot(pull.x, pull.y);
|
|
100
|
+
if (len < 0.001)
|
|
101
|
+
return;
|
|
102
|
+
const dir = { x: -pull.x / len, y: -pull.y / len }; // launch direction (opposite pull)
|
|
103
|
+
const end = { x: a.x - pull.x * 0.8, y: a.y - pull.y * 0.8 };
|
|
104
|
+
// Aim is drawn in world space because the anchor is on the actor.
|
|
105
|
+
inActorWorldSpace(ctx, actor.components.Layout, (c) => drawSling(c, a, end, dir));
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
// castle-client's sling overlay: a white grab circle (solid outline + faint
|
|
109
|
+
// fill) at `start`, a line to the base of a filled triangle arrowhead at `end`,
|
|
110
|
+
// pointing along `dir`. Sizes mirror sling.cpp (circle 18, arrowhead 25x10).
|
|
111
|
+
function drawSling(ctx, start, end, dir) {
|
|
112
|
+
const radius = 18;
|
|
113
|
+
const triLen = 25;
|
|
114
|
+
const triW = 10;
|
|
115
|
+
const baseX = end.x - dir.x * triLen;
|
|
116
|
+
const baseY = end.y - dir.y * triLen;
|
|
117
|
+
const perpX = -dir.y;
|
|
118
|
+
const perpY = dir.x;
|
|
119
|
+
ctx.lineWidth = 1.5;
|
|
120
|
+
// Grab circle.
|
|
121
|
+
ctx.fillStyle = 'rgba(255, 255, 255, 0.3)';
|
|
122
|
+
ctx.strokeStyle = 'rgba(255, 255, 255, 0.8)';
|
|
123
|
+
ctx.beginPath();
|
|
124
|
+
ctx.arc(start.x, start.y, radius, 0, Math.PI * 2);
|
|
125
|
+
ctx.fill();
|
|
126
|
+
ctx.stroke();
|
|
127
|
+
// Line from the grab circle to the arrowhead base.
|
|
128
|
+
ctx.beginPath();
|
|
129
|
+
ctx.moveTo(start.x, start.y);
|
|
130
|
+
ctx.lineTo(baseX, baseY);
|
|
131
|
+
ctx.stroke();
|
|
132
|
+
// Filled triangle arrowhead.
|
|
133
|
+
ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
|
|
134
|
+
ctx.beginPath();
|
|
135
|
+
ctx.moveTo(end.x, end.y);
|
|
136
|
+
ctx.lineTo(baseX + perpX * triW, baseY + perpY * triW);
|
|
137
|
+
ctx.lineTo(baseX - perpX * triW, baseY - perpY * triW);
|
|
138
|
+
ctx.closePath();
|
|
139
|
+
ctx.fill();
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
export { Slingshot };
|
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
// Generated from ../../behaviors/SoundPlayer.jsx; run npm run sync:play-behaviors.
|
|
2
|
+
import { resolveDeckFile } from 'castle-web-sdk';
|
|
3
|
+
import { mediaElement, setMediaPlaybackRate, setMediaPan, stopMedia, playMedia } from '../../engine/media';
|
|
4
|
+
import { isPreloadedPath, playSound } from '../../engine/sound';
|
|
5
|
+
import { PAN, UNIT } from '../../engine/propertyRanges';
|
|
6
|
+
|
|
7
|
+
// Plays one audio file (.mp3 / .wav / .m4a) from an actor.
|
|
8
|
+
//
|
|
9
|
+
// `stream` picks HOW it plays, which is the only real decision here:
|
|
10
|
+
//
|
|
11
|
+
// stream: false the sound is already decoded in memory, and plays instantly.
|
|
12
|
+
// Copies overlap. This is what a sound effect wants, and it is
|
|
13
|
+
// the default. Preloaded only if the file lives in
|
|
14
|
+
// `assets/sounds/` -- see engine/sound.js.
|
|
15
|
+
// stream: true an <audio> element, decoded as it plays. Nothing is held in
|
|
16
|
+
// memory, so this is what a music track or a long ambience
|
|
17
|
+
// wants -- a minute of audio is ~21MB decoded. One at a time:
|
|
18
|
+
// playing again restarts it rather than overlapping.
|
|
19
|
+
//
|
|
20
|
+
// Set `playOnStart` and it plays when the scene starts. Either way you can
|
|
21
|
+
// trigger it from a behavior:
|
|
22
|
+
//
|
|
23
|
+
// scene.getActor('music').behaviors.SoundPlayer.play();
|
|
24
|
+
// await actor.behaviors.SoundPlayer.play(); // ...and wait for it to end
|
|
25
|
+
// actor.behaviors.SoundPlayer.stop();
|
|
26
|
+
//
|
|
27
|
+
// `actor.runtime.soundPlayer` still holds the handle too (the older spelling,
|
|
28
|
+
// still written every `update`):
|
|
29
|
+
//
|
|
30
|
+
// scene.getActor('music').runtime.soundPlayer.play();
|
|
31
|
+
//
|
|
32
|
+
// To fire a sound effect that no actor owns -- most of them -- don't place one of
|
|
33
|
+
// these at all. `scene.sound.play('hit')` needs no actor and no import.
|
|
34
|
+
//
|
|
35
|
+
// Sound only plays during play, never in the editor: `update` is what wires it
|
|
36
|
+
// up, and the editor doesn't run it. Pressing Stop silences everything, as does
|
|
37
|
+
// `scene.sound.stopAll()` (see systems/media.js).
|
|
38
|
+
//
|
|
39
|
+
// Browsers refuse to play audio until the player has touched the page. A sound
|
|
40
|
+
// that starts before that isn't lost -- it's queued and starts on the first tap
|
|
41
|
+
// or key, which for a game is usually the first input anyway.
|
|
42
|
+
class SoundPlayer {
|
|
43
|
+
static behaviorName = 'SoundPlayer';
|
|
44
|
+
static defaultProps = {
|
|
45
|
+
file: '',
|
|
46
|
+
stream: false,
|
|
47
|
+
volume: 1,
|
|
48
|
+
playbackRate: 1,
|
|
49
|
+
pan: 0,
|
|
50
|
+
loop: false,
|
|
51
|
+
playOnStart: true,
|
|
52
|
+
};
|
|
53
|
+
// Mirrors the clamps `readSettings` already applies at runtime, so the
|
|
54
|
+
// inspector can't author a value the sound would silently ignore -- including
|
|
55
|
+
// playbackRate's 0.01..10, where the classic editor's ceiling lives.
|
|
56
|
+
static propertyMeta = {
|
|
57
|
+
stream: { hint: streamHint },
|
|
58
|
+
volume: UNIT,
|
|
59
|
+
playbackRate: { min: 0.01, max: 10, step: 0.05 },
|
|
60
|
+
pan: PAN,
|
|
61
|
+
};
|
|
62
|
+
static initialState = { handle: null };
|
|
63
|
+
constructor(props) {
|
|
64
|
+
this.props = props;
|
|
65
|
+
}
|
|
66
|
+
update(actor) {
|
|
67
|
+
if (actor.runtime.collected)
|
|
68
|
+
return;
|
|
69
|
+
const file = resolveDeckFile(this.props.file);
|
|
70
|
+
const settings = readSettings(this.props);
|
|
71
|
+
const previous = this.state.handle;
|
|
72
|
+
const handle = settings.stream
|
|
73
|
+
? streamHandleFor(actor.id, file, settings, previous)
|
|
74
|
+
: bufferHandleFor(file, settings, previous);
|
|
75
|
+
this.state.handle = handle;
|
|
76
|
+
// Kept as the older spelling -- `scene.getActor('music').runtime.soundPlayer`
|
|
77
|
+
// still works alongside `.behaviors.SoundPlayer`.
|
|
78
|
+
actor.runtime.soundPlayer = handle;
|
|
79
|
+
// Only a NEW handle starts itself: this runs every frame, and `playOnStart`
|
|
80
|
+
// means the start of the scene, not the start of each one.
|
|
81
|
+
if (handle && handle !== previous && this.props.playOnStart)
|
|
82
|
+
void handle.play();
|
|
83
|
+
}
|
|
84
|
+
// Instance methods so `actor.behaviors.SoundPlayer.play()` works, delegating
|
|
85
|
+
// to whatever handle `update` last built. Before the first `update()` runs
|
|
86
|
+
// (frame 0, before any `update` has ticked -- see engine/scene.js's ordering,
|
|
87
|
+
// taps are processed before per-actor updates) `this.state.handle` is still
|
|
88
|
+
// null, so these are no-ops that frame; a pre-existing race (the old code had
|
|
89
|
+
// the identical gap via `actor.runtime.soundPlayer` being undefined until the
|
|
90
|
+
// first `update`), not a regression.
|
|
91
|
+
play() {
|
|
92
|
+
return this.state.handle?.play();
|
|
93
|
+
}
|
|
94
|
+
stop() {
|
|
95
|
+
this.state.handle?.stop();
|
|
96
|
+
}
|
|
97
|
+
pause() {
|
|
98
|
+
this.state.handle?.pause();
|
|
99
|
+
}
|
|
100
|
+
resume() {
|
|
101
|
+
this.state.handle?.resume();
|
|
102
|
+
}
|
|
103
|
+
get playing() {
|
|
104
|
+
return this.state.handle?.playing ?? false;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
// What `stream` means, in the inspector, for the setting it is actually on --
|
|
108
|
+
// a note describing both halves of the toggle at once would say less than the
|
|
109
|
+
// prop's own name does. The third case is the one that bites: a sound outside
|
|
110
|
+
// assets/sounds/ plays, but not the first time it is asked for, and nothing else
|
|
111
|
+
// in the editor would ever tell you that.
|
|
112
|
+
function streamHint(on, component) {
|
|
113
|
+
if (on)
|
|
114
|
+
return 'Music and long sounds. Streamed, so nothing is held in memory.';
|
|
115
|
+
const file = resolveDeckFile(component?.file ?? '');
|
|
116
|
+
if (file && !isPreloadedPath(file)) {
|
|
117
|
+
return 'Short sfx. Move this file into assets/sounds/ to preload before first play, otherwise first play is silent.';
|
|
118
|
+
}
|
|
119
|
+
return 'Short sfx. Preloaded, so they fire instantly and overlap.';
|
|
120
|
+
}
|
|
121
|
+
function clamp(value, min, max, fallback) {
|
|
122
|
+
return Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
|
|
123
|
+
}
|
|
124
|
+
function readSettings(props) {
|
|
125
|
+
return {
|
|
126
|
+
stream: Boolean(props.stream),
|
|
127
|
+
volume: clamp(props.volume, 0, 1, 1),
|
|
128
|
+
// The same ceiling the classic editor used: past 10x a sound is a click.
|
|
129
|
+
playbackRate: clamp(props.playbackRate, 0.01, 10, 1),
|
|
130
|
+
pan: clamp(props.pan, -1, 1, 0),
|
|
131
|
+
loop: Boolean(props.loop),
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
function applyStreamSettings(element, settings) {
|
|
135
|
+
element.volume = settings.volume;
|
|
136
|
+
// Not a plain assignment: an element time-stretches by default, so this is
|
|
137
|
+
// what makes `playbackRate` mean the same retune on both paths. See
|
|
138
|
+
// engine/media.js.
|
|
139
|
+
setMediaPlaybackRate(element, settings.playbackRate);
|
|
140
|
+
element.loop = settings.loop;
|
|
141
|
+
if (settings.pan !== 0)
|
|
142
|
+
setMediaPan(element, settings.pan);
|
|
143
|
+
}
|
|
144
|
+
const warnedStreamOnly = new Set();
|
|
145
|
+
function streamOnly(method) {
|
|
146
|
+
if (warnedStreamOnly.has(method))
|
|
147
|
+
return;
|
|
148
|
+
warnedStreamOnly.add(method);
|
|
149
|
+
console.warn(`[SoundPlayer] ${method}() needs "stream" on -- a decoded sound has no playhead to hold. Ignored.`);
|
|
150
|
+
}
|
|
151
|
+
// Asking the pool for this actor's element EVERY frame is what keeps it alive:
|
|
152
|
+
// an entry nobody asks for is reaped as a despawned actor's leftovers (see
|
|
153
|
+
// engine/media.js). Skipping the ask on frames where the handle already matched
|
|
154
|
+
// meant a track went on sounding while its entry was reaped out from under the
|
|
155
|
+
// pool, past the reach of `stopAll`.
|
|
156
|
+
//
|
|
157
|
+
// A different file is a different pool entry, so comparing elements is also how
|
|
158
|
+
// a changed `file` prop gets a new handle.
|
|
159
|
+
function streamHandleFor(actorId, file, settings, previous) {
|
|
160
|
+
const element = mediaElement(actorId, 'audio', file);
|
|
161
|
+
if (!element)
|
|
162
|
+
return null;
|
|
163
|
+
// Props are live: turning the volume down or the pitch up in the inspector
|
|
164
|
+
// takes effect on the sound already playing.
|
|
165
|
+
applyStreamSettings(element, settings);
|
|
166
|
+
if (previous && previous.element === element) {
|
|
167
|
+
previous.settings = settings;
|
|
168
|
+
return previous;
|
|
169
|
+
}
|
|
170
|
+
return makeStreamHandle(file, element, settings);
|
|
171
|
+
}
|
|
172
|
+
function bufferHandleFor(file, settings, previous) {
|
|
173
|
+
if (previous && !previous.stream && previous.file === file) {
|
|
174
|
+
previous.settings = settings;
|
|
175
|
+
return previous;
|
|
176
|
+
}
|
|
177
|
+
return makeBufferHandle(file, settings);
|
|
178
|
+
}
|
|
179
|
+
// The <audio> handle: one element, reused. `play()` resolves when the sound ends,
|
|
180
|
+
// so a behavior can `await` one before doing the next thing. A looping sound
|
|
181
|
+
// resolves right away rather than never -- awaiting something that by definition
|
|
182
|
+
// doesn't end would hang the caller forever, and that is never what was meant.
|
|
183
|
+
function makeStreamHandle(file, element, settings) {
|
|
184
|
+
const handle = {
|
|
185
|
+
file,
|
|
186
|
+
stream: true,
|
|
187
|
+
settings,
|
|
188
|
+
element,
|
|
189
|
+
play() {
|
|
190
|
+
applyStreamSettings(element, handle.settings);
|
|
191
|
+
try {
|
|
192
|
+
element.currentTime = 0;
|
|
193
|
+
}
|
|
194
|
+
catch {
|
|
195
|
+
// Not seekable yet (still loading) -- it plays from the start anyway.
|
|
196
|
+
}
|
|
197
|
+
playMedia(element);
|
|
198
|
+
if (handle.settings.loop)
|
|
199
|
+
return Promise.resolve();
|
|
200
|
+
return new Promise((resolve) => {
|
|
201
|
+
const done = () => resolve();
|
|
202
|
+
element.addEventListener('ended', done, { once: true });
|
|
203
|
+
element.addEventListener('error', done, { once: true });
|
|
204
|
+
});
|
|
205
|
+
},
|
|
206
|
+
resume() {
|
|
207
|
+
playMedia(element);
|
|
208
|
+
},
|
|
209
|
+
pause() {
|
|
210
|
+
element.pause();
|
|
211
|
+
},
|
|
212
|
+
stop() {
|
|
213
|
+
stopMedia(element);
|
|
214
|
+
},
|
|
215
|
+
get playing() {
|
|
216
|
+
return !element.paused;
|
|
217
|
+
},
|
|
218
|
+
};
|
|
219
|
+
return handle;
|
|
220
|
+
}
|
|
221
|
+
// The decoded handle: every `play()` is its own voice, so they overlap. `stop()`
|
|
222
|
+
// stops the one most recently started -- the others are already on their way out,
|
|
223
|
+
// and `scene.sound.stopAll()` is the blunt instrument for all of them at once.
|
|
224
|
+
//
|
|
225
|
+
// `play()` resolves immediately when nothing played: an unknown file, or a sound
|
|
226
|
+
// still decoding. Never hanging is the point -- see playSound in engine/sound.js.
|
|
227
|
+
function makeBufferHandle(file, settings) {
|
|
228
|
+
const handle = {
|
|
229
|
+
file,
|
|
230
|
+
stream: false,
|
|
231
|
+
settings,
|
|
232
|
+
element: null,
|
|
233
|
+
voice: null,
|
|
234
|
+
play() {
|
|
235
|
+
const s = handle.settings;
|
|
236
|
+
const voice = playSound(file, { volume: s.volume, pan: s.pan, playbackRate: s.playbackRate });
|
|
237
|
+
handle.voice = voice;
|
|
238
|
+
if (!voice)
|
|
239
|
+
return Promise.resolve();
|
|
240
|
+
void voice.finished.then(() => {
|
|
241
|
+
if (handle.voice === voice)
|
|
242
|
+
handle.voice = null;
|
|
243
|
+
});
|
|
244
|
+
return voice.finished;
|
|
245
|
+
},
|
|
246
|
+
resume() {
|
|
247
|
+
streamOnly('resume');
|
|
248
|
+
},
|
|
249
|
+
pause() {
|
|
250
|
+
streamOnly('pause');
|
|
251
|
+
},
|
|
252
|
+
stop() {
|
|
253
|
+
handle.voice?.stop();
|
|
254
|
+
handle.voice = null;
|
|
255
|
+
},
|
|
256
|
+
get playing() {
|
|
257
|
+
return handle.voice !== null;
|
|
258
|
+
},
|
|
259
|
+
};
|
|
260
|
+
return handle;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
export { SoundPlayer };
|