@nice2dev/game-engine 1.3.15 → 1.3.16
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/CHANGELOG.md +9 -0
- package/dist/cjs/accessibility/Accessibility.js +152 -165
- package/dist/cjs/ai/AI.js +292 -294
- package/dist/cjs/ai/BehaviorTree.js +1029 -1113
- package/dist/cjs/ai/StateMachine.js +694 -756
- package/dist/cjs/animation/Animation.js +232 -241
- package/dist/cjs/audio/AudioAdvanced.js +221 -236
- package/dist/cjs/audio/AudioBridge.js +441 -435
- package/dist/cjs/audio/AudioManager.js +242 -259
- package/dist/cjs/build-cloud/BuildOrchestration.js +1059 -1098
- package/dist/cjs/build-cloud/GodotBuildCloud.js +641 -670
- package/dist/cjs/build-cloud/UnityBuildCloud.js +563 -610
- package/dist/cjs/build-cloud/UnrealBuildCloud.js +610 -635
- package/dist/cjs/core/EventBus.js +51 -56
- package/dist/cjs/core/GameClock.js +62 -66
- package/dist/cjs/core/GameConfig.js +72 -79
- package/dist/cjs/core/GameLoop.js +80 -89
- package/dist/cjs/core/ServiceLocator.js +61 -65
- package/dist/cjs/core/Validation.js +72 -82
- package/dist/cjs/core/math.js +108 -112
- package/dist/cjs/devtools/DevTools.js +542 -563
- package/dist/cjs/devtools/DeveloperExperience.js +521 -559
- package/dist/cjs/devtools/GameplayAnalytics.js +636 -646
- package/dist/cjs/dialogue/DialogueSystem.js +984 -986
- package/dist/cjs/docs/DocGenerator.js +339 -364
- package/dist/cjs/ecs/World.js +355 -371
- package/dist/cjs/editor/AchievementEditor.js +580 -636
- package/dist/cjs/editor/AdvancedEditor.js +184 -191
- package/dist/cjs/editor/AnimationRetargeting.js +696 -741
- package/dist/cjs/editor/AssetBrowser.js +1072 -1160
- package/dist/cjs/editor/AssetManager.js +187 -192
- package/dist/cjs/editor/ConsolePro.js +971 -1061
- package/dist/cjs/editor/CraftingEditor.js +680 -730
- package/dist/cjs/editor/DebugTools.js +187 -185
- package/dist/cjs/editor/DialogueSystem.js +844 -901
- package/dist/cjs/editor/LeaderboardSystem.js +429 -483
- package/dist/cjs/editor/NiceGameEditor.js +1903 -1201
- package/dist/cjs/editor/PrefabSystem.js +772 -838
- package/dist/cjs/editor/ProfilerPanel.js +649 -700
- package/dist/cjs/editor/QuestEditor.js +792 -839
- package/dist/cjs/editor/ReplaySystem.js +585 -634
- package/dist/cjs/editor/SceneEditor.js +176 -200
- package/dist/cjs/editor/ScreenshotMode.js +621 -688
- package/dist/cjs/editor/ShaderGraph.js +1556 -1582
- package/dist/cjs/editor/TimelineEditor.js +715 -778
- package/dist/cjs/editor/UndoRedoPro.js +830 -904
- package/dist/cjs/editor/VRARMode.js +582 -645
- package/dist/cjs/engine/NiceGameEngine.js +141 -164
- package/dist/cjs/engine/SaveSystem.js +441 -495
- package/dist/cjs/enterprise/Enterprise.js +254 -261
- package/dist/cjs/export/BevyExporter.js +927 -967
- package/dist/cjs/export/CocosExporter.js +644 -673
- package/dist/cjs/export/Construct3Exporter.js +783 -794
- package/dist/cjs/export/DefoldExporter.js +1028 -1069
- package/dist/cjs/export/GDevelopExporter.js +674 -708
- package/dist/cjs/export/GameMakerExporter.js +791 -805
- package/dist/cjs/export/GodotExporter.js +1003 -1045
- package/dist/cjs/export/MinecraftBedrockExporter.js +573 -578
- package/dist/cjs/export/MonoGameExporter.js +1265 -1293
- package/dist/cjs/export/Pico8Exporter.js +766 -812
- package/dist/cjs/export/PlatformExporter.js +188 -206
- package/dist/cjs/export/RPGMakerExporter.js +860 -879
- package/dist/cjs/export/RobloxExporter.js +883 -919
- package/dist/cjs/export/Solar2DExporter.js +1218 -1256
- package/dist/cjs/export/ThreeJSExporter.js +1006 -1073
- package/dist/cjs/export/Tic80Exporter.js +1210 -1267
- package/dist/cjs/export/UnityExporter.js +1116 -1131
- package/dist/cjs/export/UnrealExporter.js +889 -919
- package/dist/cjs/export/WebExporter.js +931 -970
- package/dist/cjs/export/index.js +42 -65
- package/dist/cjs/godot-integration/GodotAssetLibrary.js +659 -692
- package/dist/cjs/godot-integration/GodotImport.js +929 -1027
- package/dist/cjs/godot-integration/GodotLiveLink.js +915 -945
- package/dist/cjs/godot-integration/components/GodotProjectBrowser.js +911 -611
- package/dist/cjs/i18n/I18n.js +860 -900
- package/dist/cjs/i18n/useTranslation.js +84 -89
- package/dist/cjs/import/AsepriteImporter.js +658 -716
- package/dist/cjs/import/DragonBonesImporter.js +437 -461
- package/dist/cjs/import/GameMakerImporter.js +511 -521
- package/dist/cjs/import/GodotSceneImporter.js +788 -822
- package/dist/cjs/import/LDtkImporter.js +436 -454
- package/dist/cjs/import/Live2DImporter.js +497 -518
- package/dist/cjs/import/NdgFormat.js +424 -457
- package/dist/cjs/import/OgmoImporter.js +466 -493
- package/dist/cjs/import/RPGMakerImporter.js +451 -477
- package/dist/cjs/import/SceneImporter.js +378 -423
- package/dist/cjs/import/SpineImporter.js +511 -546
- package/dist/cjs/import/SpriterImporter.js +590 -613
- package/dist/cjs/import/TiledMapImporter.js +811 -846
- package/dist/cjs/import/UnitySceneImporter.js +687 -703
- package/dist/cjs/import/index.js +206 -251
- package/dist/cjs/index.js +275 -278
- package/dist/cjs/input/GamepadNavigation.js +185 -205
- package/dist/cjs/input/InputManager.js +397 -421
- package/dist/cjs/input/useGamepads.js +70 -81
- package/dist/cjs/integration/IconSprite.js +129 -256
- package/dist/cjs/inventory/InventorySystem.js +920 -995
- package/dist/cjs/kids/KidMode.js +997 -1022
- package/dist/cjs/kids/KidTools.js +570 -594
- package/dist/cjs/monetization/Monetization.js +170 -177
- package/dist/cjs/multiplayer/LocalMultiplayer.js +287 -287
- package/dist/cjs/multiplayer/MiniGameTypes.js +49 -59
- package/dist/cjs/native-engine/AnimationSystem.js +731 -806
- package/dist/cjs/native-engine/AssetPipeline.js +454 -515
- package/dist/cjs/native-engine/AudioEngine.js +763 -804
- package/dist/cjs/native-engine/InputSystem.js +1075 -1145
- package/dist/cjs/native-engine/NetworkingSystem.js +733 -793
- package/dist/cjs/native-engine/PhysicsEngine.js +583 -607
- package/dist/cjs/native-engine/RenderingEngine.js +302 -350
- package/dist/cjs/native-engine/SceneGraph.js +769 -808
- package/dist/cjs/network/MultiplayerTransport.js +97 -132
- package/dist/cjs/network/Networking.js +549 -564
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/AbortController.js +21 -29
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/AccessTokenHttpClient.js +40 -48
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/DefaultHttpClient.js +35 -43
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/DefaultReconnectPolicy.js +10 -15
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/Errors.js +103 -135
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/FetchHttpClient.js +131 -158
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/HandshakeProtocol.js +39 -53
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/HeaderNames.js +5 -8
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/HttpClient.js +40 -48
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/HttpConnection.js +494 -572
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/HubConnection.js +826 -953
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/HubConnectionBuilder.js +125 -146
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/IHubProtocol.js +13 -23
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/ILogger.js +11 -25
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/ITransport.js +13 -24
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/JsonHubProtocol.js +108 -121
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/Loggers.js +10 -14
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/LongPollingTransport.js +150 -185
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/MessageBuffer.js +158 -196
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/ServerSentEventsTransport.js +90 -105
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/Subject.js +30 -35
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/TextMessageFormat.js +16 -21
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/Utils.js +215 -248
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/WebSocketTransport.js +135 -157
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/XhrHttpClient.js +76 -85
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/index.js +24 -27
- package/dist/cjs/node_modules/@microsoft/signalr/dist/esm/pkg-version.js +3 -4
- package/dist/cjs/pathfinding/Pathfinding.js +245 -263
- package/dist/cjs/performance/AssetStreaming.js +561 -635
- package/dist/cjs/performance/BenchmarkSuite.js +283 -311
- package/dist/cjs/performance/DeltaCompression.js +467 -526
- package/dist/cjs/performance/DeterministicPhysics.js +450 -498
- package/dist/cjs/performance/ECSOptimization.js +644 -695
- package/dist/cjs/performance/GameSaveSystem.js +509 -556
- package/dist/cjs/performance/HotReload.js +447 -500
- package/dist/cjs/performance/InputRecording.js +511 -561
- package/dist/cjs/performance/InterestManagement.js +453 -500
- package/dist/cjs/performance/LocalizationRuntime.js +376 -423
- package/dist/cjs/performance/MemoryManagement.js +410 -470
- package/dist/cjs/performance/ModSupport.js +445 -496
- package/dist/cjs/performance/MultiThreadedPhysics.js +400 -443
- package/dist/cjs/performance/NetworkPrediction.js +424 -482
- package/dist/cjs/performance/ObjectPooling.js +569 -617
- package/dist/cjs/performance/Performance.js +174 -190
- package/dist/cjs/performance/PerformanceAdvanced.js +614 -637
- package/dist/cjs/performance/WebGPURenderer.js +656 -683
- package/dist/cjs/physics/PhysicsAdvanced.js +345 -379
- package/dist/cjs/physics/PhysicsEngine2D.js +391 -427
- package/dist/cjs/plugins/PluginSDK.js +432 -466
- package/dist/cjs/plugins/PluginTestKit.js +307 -330
- package/dist/cjs/procedural/Procedural.js +243 -254
- package/dist/cjs/procedural/WorldBuilding.js +297 -314
- package/dist/cjs/quest/QuestSystem.js +975 -932
- package/dist/cjs/release/MobileExport.js +157 -163
- package/dist/cjs/release/Release.js +225 -238
- package/dist/cjs/rendering/Camera2D.js +121 -124
- package/dist/cjs/rendering/Renderer2D.js +321 -335
- package/dist/cjs/rendering/WebGPURenderPipeline.js +632 -651
- package/dist/cjs/runtime3d/Runtime3D.js +359 -378
- package/dist/cjs/runtime3d/SceneEditor3D.js +252 -263
- package/dist/cjs/scene/SceneManager.js +177 -193
- package/dist/cjs/scripting/GraphToAST.js +574 -547
- package/dist/cjs/scripting/LanguageExporter.js +254 -279
- package/dist/cjs/scripting/NodeGraph.js +546 -570
- package/dist/cjs/scripting/ScriptAST.js +31 -39
- package/dist/cjs/scripting/VisualScripting2.js +1016 -1065
- package/dist/cjs/scripting/exporters/CSharpExporter.js +464 -496
- package/dist/cjs/scripting/exporters/GDScriptExporter.js +390 -442
- package/dist/cjs/scripting/exporters/LuaExporter.js +406 -447
- package/dist/cjs/scripting/exporters/PythonExporter.js +484 -549
- package/dist/cjs/scripting/exporters/RustExporter.js +459 -512
- package/dist/cjs/scripting/exporters/TypeScriptExporter.js +505 -556
- package/dist/cjs/social/Social.js +72 -80
- package/dist/cjs/systems/LightingSystem.js +844 -931
- package/dist/cjs/systems/ParticleSystem2.js +1447 -1451
- package/dist/cjs/systems/PhysicsDebugSystem.js +1070 -1141
- package/dist/cjs/systems/TerrainSystem.js +985 -1098
- package/dist/cjs/templates/ActionTemplates.js +296 -309
- package/dist/cjs/templates/FightingTemplate.js +417 -463
- package/dist/cjs/templates/MetroidvaniaTemplate.js +353 -405
- package/dist/cjs/templates/PartyTemplates.js +190 -202
- package/dist/cjs/templates/PuzzleTemplates.js +245 -261
- package/dist/cjs/templates/RPGTemplates.js +160 -178
- package/dist/cjs/templates/SportsTemplates.js +237 -250
- package/dist/cjs/templates/StrategyTemplates.js +143 -153
- package/dist/cjs/templates/SurvivalTemplate.js +336 -380
- package/dist/cjs/templates/WaveDefense.js +499 -526
- package/dist/cjs/tilemap/Tilemap.js +207 -214
- package/dist/cjs/tutorials/TutorialBranching.js +396 -417
- package/dist/cjs/tutorials/TutorialEngine.js +888 -931
- package/dist/cjs/tutorials/TutorialOverlay.js +602 -640
- package/dist/cjs/tutorials/content/Tutorials_T05_T08.js +787 -809
- package/dist/cjs/tutorials/content/Tutorials_T09_T11.js +736 -756
- package/dist/cjs/tutorials/content/Tutorials_T12_T15.js +754 -778
- package/dist/cjs/ui/GameUI.js +295 -312
- package/dist/cjs/unity-integration/UnityAssetStore.js +700 -741
- package/dist/cjs/unity-integration/UnityImport.js +1066 -1176
- package/dist/cjs/unity-integration/UnityLiveLink.js +934 -981
- package/dist/cjs/unity-integration/components/UnityAssetStoreBrowser.js +1233 -757
- package/dist/cjs/unity-integration/components/UnityProjectBrowser.js +1240 -768
- package/dist/cjs/unreal-integration/UnrealImport.js +391 -412
- package/dist/cjs/unreal-integration/UnrealLiveLink.js +1102 -1137
- package/dist/cjs/unreal-integration/UnrealMarketplace.js +436 -473
- package/dist/cjs/unreal-integration/components/UnrealProjectBrowser.js +1150 -767
- package/dist/cjs/xr/ARVR.js +167 -175
- package/dist/esm/accessibility/Accessibility.js +160 -164
- package/dist/esm/ai/AI.js +310 -293
- package/dist/esm/ai/BehaviorTree.js +1057 -1112
- package/dist/esm/ai/StateMachine.js +709 -755
- package/dist/esm/animation/Animation.js +237 -240
- package/dist/esm/audio/AudioAdvanced.js +239 -235
- package/dist/esm/audio/AudioBridge.js +448 -434
- package/dist/esm/audio/AudioManager.js +243 -258
- package/dist/esm/build-cloud/BuildOrchestration.js +1071 -1097
- package/dist/esm/build-cloud/GodotBuildCloud.js +647 -669
- package/dist/esm/build-cloud/UnityBuildCloud.js +571 -609
- package/dist/esm/build-cloud/UnrealBuildCloud.js +615 -634
- package/dist/esm/core/EventBus.js +52 -55
- package/dist/esm/core/GameClock.js +63 -65
- package/dist/esm/core/GameConfig.js +77 -78
- package/dist/esm/core/GameLoop.js +81 -88
- package/dist/esm/core/ServiceLocator.js +63 -64
- package/dist/esm/core/Validation.js +82 -81
- package/dist/esm/core/math.js +109 -111
- package/dist/esm/devtools/DevTools.js +546 -562
- package/dist/esm/devtools/DeveloperExperience.js +535 -558
- package/dist/esm/devtools/GameplayAnalytics.js +647 -645
- package/dist/esm/dialogue/DialogueSystem.js +998 -985
- package/dist/esm/docs/DocGenerator.js +342 -363
- package/dist/esm/ecs/World.js +358 -370
- package/dist/esm/editor/AchievementEditor.js +584 -635
- package/dist/esm/editor/AdvancedEditor.js +191 -190
- package/dist/esm/editor/AnimationRetargeting.js +700 -740
- package/dist/esm/editor/AssetBrowser.js +1078 -1159
- package/dist/esm/editor/AssetManager.js +188 -191
- package/dist/esm/editor/ConsolePro.js +977 -1060
- package/dist/esm/editor/CraftingEditor.js +684 -729
- package/dist/esm/editor/DebugTools.js +194 -184
- package/dist/esm/editor/DialogueSystem.js +849 -900
- package/dist/esm/editor/LeaderboardSystem.js +433 -482
- package/dist/esm/editor/NiceGameEditor.js +1908 -1200
- package/dist/esm/editor/PrefabSystem.js +777 -837
- package/dist/esm/editor/ProfilerPanel.js +654 -699
- package/dist/esm/editor/QuestEditor.js +795 -838
- package/dist/esm/editor/ReplaySystem.js +591 -633
- package/dist/esm/editor/SceneEditor.js +189 -199
- package/dist/esm/editor/ScreenshotMode.js +628 -687
- package/dist/esm/editor/ShaderGraph.js +1565 -1581
- package/dist/esm/editor/TimelineEditor.js +733 -777
- package/dist/esm/editor/UndoRedoPro.js +835 -903
- package/dist/esm/editor/VRARMode.js +586 -644
- package/dist/esm/engine/NiceGameEngine.js +142 -163
- package/dist/esm/engine/SaveSystem.js +447 -494
- package/dist/esm/enterprise/Enterprise.js +265 -260
- package/dist/esm/export/BevyExporter.js +929 -966
- package/dist/esm/export/CocosExporter.js +646 -672
- package/dist/esm/export/Construct3Exporter.js +785 -793
- package/dist/esm/export/DefoldExporter.js +1030 -1068
- package/dist/esm/export/GDevelopExporter.js +676 -707
- package/dist/esm/export/GameMakerExporter.js +793 -804
- package/dist/esm/export/GodotExporter.js +1004 -1044
- package/dist/esm/export/MinecraftBedrockExporter.js +575 -577
- package/dist/esm/export/MonoGameExporter.js +1267 -1292
- package/dist/esm/export/Pico8Exporter.js +768 -811
- package/dist/esm/export/PlatformExporter.js +193 -205
- package/dist/esm/export/RPGMakerExporter.js +862 -878
- package/dist/esm/export/RobloxExporter.js +885 -918
- package/dist/esm/export/Solar2DExporter.js +1220 -1255
- package/dist/esm/export/ThreeJSExporter.js +1007 -1072
- package/dist/esm/export/Tic80Exporter.js +1212 -1266
- package/dist/esm/export/UnityExporter.js +1117 -1130
- package/dist/esm/export/UnrealExporter.js +891 -918
- package/dist/esm/export/WebExporter.js +933 -969
- package/dist/esm/export/index.js +86 -71
- package/dist/esm/godot-integration/GodotAssetLibrary.js +663 -691
- package/dist/esm/godot-integration/GodotImport.js +935 -1026
- package/dist/esm/godot-integration/GodotLiveLink.js +918 -944
- package/dist/esm/godot-integration/components/GodotProjectBrowser.js +912 -610
- package/dist/esm/i18n/I18n.js +871 -899
- package/dist/esm/i18n/useTranslation.js +88 -88
- package/dist/esm/import/AsepriteImporter.js +637 -715
- package/dist/esm/import/DragonBonesImporter.js +417 -460
- package/dist/esm/import/GameMakerImporter.js +491 -520
- package/dist/esm/import/GodotSceneImporter.js +767 -821
- package/dist/esm/import/LDtkImporter.js +415 -453
- package/dist/esm/import/Live2DImporter.js +477 -517
- package/dist/esm/import/NdgFormat.js +410 -456
- package/dist/esm/import/OgmoImporter.js +446 -492
- package/dist/esm/import/RPGMakerImporter.js +431 -476
- package/dist/esm/import/SceneImporter.js +385 -422
- package/dist/esm/import/SpineImporter.js +491 -545
- package/dist/esm/import/SpriterImporter.js +570 -612
- package/dist/esm/import/TiledMapImporter.js +790 -845
- package/dist/esm/import/UnitySceneImporter.js +666 -702
- package/dist/esm/import/index.js +247 -258
- package/dist/esm/index.js +1332 -188
- package/dist/esm/input/GamepadNavigation.js +187 -204
- package/dist/esm/input/InputManager.js +401 -420
- package/dist/esm/input/useGamepads.js +72 -80
- package/dist/esm/integration/IconSprite.js +143 -255
- package/dist/esm/inventory/InventorySystem.js +925 -994
- package/dist/esm/kids/KidMode.js +1003 -1021
- package/dist/esm/kids/KidTools.js +573 -593
- package/dist/esm/monetization/Monetization.js +180 -176
- package/dist/esm/multiplayer/LocalMultiplayer.js +290 -286
- package/dist/esm/multiplayer/MiniGameTypes.js +58 -58
- package/dist/esm/native-engine/AnimationSystem.js +735 -805
- package/dist/esm/native-engine/AssetPipeline.js +456 -514
- package/dist/esm/native-engine/AudioEngine.js +765 -803
- package/dist/esm/native-engine/InputSystem.js +1079 -1144
- package/dist/esm/native-engine/NetworkingSystem.js +740 -792
- package/dist/esm/native-engine/PhysicsEngine.js +585 -606
- package/dist/esm/native-engine/RenderingEngine.js +304 -349
- package/dist/esm/native-engine/SceneGraph.js +773 -807
- package/dist/esm/network/MultiplayerTransport.js +99 -131
- package/dist/esm/network/Networking.js +556 -563
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/AbortController.js +22 -28
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/AccessTokenHttpClient.js +41 -47
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/DefaultHttpClient.js +36 -42
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/DefaultReconnectPolicy.js +11 -14
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/Errors.js +111 -134
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/FetchHttpClient.js +132 -157
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/HandshakeProtocol.js +40 -52
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/HeaderNames.js +6 -7
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/HttpClient.js +42 -47
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/HttpConnection.js +496 -571
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/HubConnection.js +828 -952
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/HubConnectionBuilder.js +126 -145
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/IHubProtocol.js +14 -23
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/ILogger.js +12 -25
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/ITransport.js +15 -24
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/JsonHubProtocol.js +109 -120
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/Loggers.js +11 -13
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/LongPollingTransport.js +151 -184
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/MessageBuffer.js +159 -195
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/ServerSentEventsTransport.js +91 -104
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/Subject.js +31 -34
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/TextMessageFormat.js +17 -20
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/Utils.js +230 -248
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/WebSocketTransport.js +136 -156
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/XhrHttpClient.js +77 -84
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/index.js +31 -12
- package/dist/esm/node_modules/@microsoft/signalr/dist/esm/pkg-version.js +4 -3
- package/dist/esm/pathfinding/Pathfinding.js +249 -262
- package/dist/esm/performance/AssetStreaming.js +567 -634
- package/dist/esm/performance/BenchmarkSuite.js +285 -310
- package/dist/esm/performance/DeltaCompression.js +478 -525
- package/dist/esm/performance/DeterministicPhysics.js +479 -497
- package/dist/esm/performance/ECSOptimization.js +653 -694
- package/dist/esm/performance/GameSaveSystem.js +515 -555
- package/dist/esm/performance/HotReload.js +454 -499
- package/dist/esm/performance/InputRecording.js +520 -560
- package/dist/esm/performance/InterestManagement.js +460 -499
- package/dist/esm/performance/LocalizationRuntime.js +382 -422
- package/dist/esm/performance/MemoryManagement.js +415 -469
- package/dist/esm/performance/ModSupport.js +455 -495
- package/dist/esm/performance/MultiThreadedPhysics.js +408 -442
- package/dist/esm/performance/NetworkPrediction.js +436 -481
- package/dist/esm/performance/ObjectPooling.js +582 -616
- package/dist/esm/performance/Performance.js +182 -189
- package/dist/esm/performance/PerformanceAdvanced.js +621 -636
- package/dist/esm/performance/WebGPURenderer.js +660 -682
- package/dist/esm/physics/PhysicsAdvanced.js +359 -378
- package/dist/esm/physics/PhysicsEngine2D.js +393 -426
- package/dist/esm/plugins/PluginSDK.js +435 -465
- package/dist/esm/plugins/PluginTestKit.js +315 -329
- package/dist/esm/procedural/Procedural.js +248 -253
- package/dist/esm/procedural/WorldBuilding.js +316 -313
- package/dist/esm/quest/QuestSystem.js +982 -931
- package/dist/esm/release/MobileExport.js +163 -162
- package/dist/esm/release/Release.js +234 -237
- package/dist/esm/rendering/Camera2D.js +122 -123
- package/dist/esm/rendering/Renderer2D.js +323 -334
- package/dist/esm/rendering/WebGPURenderPipeline.js +647 -650
- package/dist/esm/runtime3d/Runtime3D.js +368 -377
- package/dist/esm/runtime3d/SceneEditor3D.js +268 -262
- package/dist/esm/scene/SceneManager.js +178 -192
- package/dist/esm/scripting/GraphToAST.js +576 -546
- package/dist/esm/scripting/LanguageExporter.js +263 -278
- package/dist/esm/scripting/NodeGraph.js +550 -569
- package/dist/esm/scripting/ScriptAST.js +45 -38
- package/dist/esm/scripting/VisualScripting2.js +1025 -1064
- package/dist/esm/scripting/exporters/CSharpExporter.js +465 -495
- package/dist/esm/scripting/exporters/GDScriptExporter.js +391 -441
- package/dist/esm/scripting/exporters/LuaExporter.js +407 -446
- package/dist/esm/scripting/exporters/PythonExporter.js +485 -548
- package/dist/esm/scripting/exporters/RustExporter.js +460 -511
- package/dist/esm/scripting/exporters/TypeScriptExporter.js +506 -555
- package/dist/esm/social/Social.js +77 -79
- package/dist/esm/systems/LightingSystem.js +855 -930
- package/dist/esm/systems/ParticleSystem2.js +1453 -1450
- package/dist/esm/systems/PhysicsDebugSystem.js +1078 -1140
- package/dist/esm/systems/TerrainSystem.js +996 -1097
- package/dist/esm/templates/ActionTemplates.js +307 -308
- package/dist/esm/templates/FightingTemplate.js +439 -462
- package/dist/esm/templates/MetroidvaniaTemplate.js +391 -404
- package/dist/esm/templates/PartyTemplates.js +206 -201
- package/dist/esm/templates/PuzzleTemplates.js +260 -260
- package/dist/esm/templates/RPGTemplates.js +172 -177
- package/dist/esm/templates/SportsTemplates.js +251 -249
- package/dist/esm/templates/StrategyTemplates.js +158 -152
- package/dist/esm/templates/SurvivalTemplate.js +367 -379
- package/dist/esm/templates/WaveDefense.js +501 -525
- package/dist/esm/tilemap/Tilemap.js +209 -213
- package/dist/esm/tutorials/TutorialBranching.js +399 -416
- package/dist/esm/tutorials/TutorialEngine.js +893 -930
- package/dist/esm/tutorials/TutorialOverlay.js +603 -639
- package/dist/esm/tutorials/content/Tutorials_T05_T08.js +792 -808
- package/dist/esm/tutorials/content/Tutorials_T09_T11.js +740 -755
- package/dist/esm/tutorials/content/Tutorials_T12_T15.js +759 -777
- package/dist/esm/ui/GameUI.js +296 -311
- package/dist/esm/unity-integration/UnityAssetStore.js +704 -740
- package/dist/esm/unity-integration/UnityImport.js +1071 -1175
- package/dist/esm/unity-integration/UnityLiveLink.js +938 -980
- package/dist/esm/unity-integration/components/UnityAssetStoreBrowser.js +1234 -756
- package/dist/esm/unity-integration/components/UnityProjectBrowser.js +1241 -767
- package/dist/esm/unreal-integration/UnrealImport.js +395 -411
- package/dist/esm/unreal-integration/UnrealLiveLink.js +1105 -1136
- package/dist/esm/unreal-integration/UnrealMarketplace.js +442 -472
- package/dist/esm/unreal-integration/components/UnrealProjectBrowser.js +1151 -766
- package/dist/esm/xr/ARVR.js +181 -174
- package/package.json +7 -12
|
@@ -1,459 +1,473 @@
|
|
|
1
|
-
import React, { useState, useCallback, useRef, useMemo, useEffect } from
|
|
2
|
-
|
|
3
|
-
/* ────────────────────────────────────────────────────────────────
|
|
4
|
-
Audio Bridge — Integration between @nice2dev/ui-audio and
|
|
5
|
-
the game engine audio system
|
|
6
|
-
|
|
7
|
-
Bridges the standalone ui-audio package's components and hooks
|
|
8
|
-
into the game engine's AudioManager/AudioAdvanced system with:
|
|
9
|
-
- Spatial audio positioning (2D/3D)
|
|
10
|
-
- Game-state aware audio (pause/resume on menu, focus loss)
|
|
11
|
-
- Audio pools for frequent SFX
|
|
12
|
-
- Music crossfade tied to scene transitions
|
|
13
|
-
- Adaptive audio based on gameplay events
|
|
14
|
-
──────────────────────────────────────────────────────────────── */
|
|
1
|
+
import React, { useState, useCallback, useRef, useMemo, useEffect } from "react";
|
|
15
2
|
const DEFAULT_SPATIAL = {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
3
|
+
model: "3d-hrtf",
|
|
4
|
+
maxDistance: 100,
|
|
5
|
+
refDistance: 1,
|
|
6
|
+
rolloffFactor: 1,
|
|
7
|
+
coneInnerAngle: 360,
|
|
8
|
+
coneOuterAngle: 360,
|
|
9
|
+
coneOuterGain: 0
|
|
23
10
|
};
|
|
24
|
-
/* ══════════════════════════════════════════════════════════════
|
|
25
|
-
AUDIO BUS MIXER
|
|
26
|
-
══════════════════════════════════════════════════════════════ */
|
|
27
11
|
const DEFAULT_BUS_VOLUMES = {
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
12
|
+
master: 1,
|
|
13
|
+
music: 0.7,
|
|
14
|
+
sfx: 1,
|
|
15
|
+
voice: 1,
|
|
16
|
+
ambient: 0.5,
|
|
17
|
+
ui: 0.8
|
|
34
18
|
};
|
|
35
19
|
class AudioBusMixer {
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
20
|
+
constructor(eventBus) {
|
|
21
|
+
this.buses = /* @__PURE__ */ new Map();
|
|
22
|
+
this.eventBus = eventBus;
|
|
23
|
+
for (const [type, volume] of Object.entries(DEFAULT_BUS_VOLUMES)) {
|
|
24
|
+
this.buses.set(type, {
|
|
25
|
+
type,
|
|
26
|
+
volume,
|
|
27
|
+
muted: false,
|
|
28
|
+
effects: []
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
getBus(type) {
|
|
33
|
+
return this.buses.get(type);
|
|
34
|
+
}
|
|
35
|
+
setVolume(type, volume) {
|
|
36
|
+
const bus = this.buses.get(type);
|
|
37
|
+
if (bus) {
|
|
38
|
+
bus.volume = Math.max(0, Math.min(1, volume));
|
|
39
|
+
this.eventBus.emit("audio:bus-volume", { bus: type, volume: bus.volume });
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
setMuted(type, muted) {
|
|
43
|
+
const bus = this.buses.get(type);
|
|
44
|
+
if (bus) {
|
|
45
|
+
bus.muted = muted;
|
|
46
|
+
this.eventBus.emit("audio:bus-mute", { bus: type, muted });
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
/** Get effective volume considering master and mute */
|
|
50
|
+
getEffectiveVolume(type) {
|
|
51
|
+
const bus = this.buses.get(type);
|
|
52
|
+
if (!bus || bus.muted) {
|
|
53
|
+
return 0;
|
|
54
|
+
}
|
|
55
|
+
const master = this.buses.get("master");
|
|
56
|
+
if (!master || master.muted) {
|
|
57
|
+
return 0;
|
|
58
|
+
}
|
|
59
|
+
return bus.volume * master.volume;
|
|
60
|
+
}
|
|
61
|
+
addEffect(type, effect) {
|
|
62
|
+
const bus = this.buses.get(type);
|
|
63
|
+
if (bus) {
|
|
64
|
+
bus.effects.push(effect);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
removeEffect(type, effectType) {
|
|
68
|
+
const bus = this.buses.get(type);
|
|
69
|
+
if (bus) {
|
|
70
|
+
bus.effects = bus.effects.filter((e) => e.type !== effectType);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
getAllBuses() {
|
|
74
|
+
return this.buses;
|
|
75
|
+
}
|
|
76
|
+
snapshot() {
|
|
77
|
+
const result = {};
|
|
78
|
+
for (const [type, bus] of this.buses) {
|
|
79
|
+
result[type] = bus.muted ? 0 : bus.volume;
|
|
80
|
+
}
|
|
81
|
+
return result;
|
|
82
|
+
}
|
|
99
83
|
}
|
|
100
84
|
class SFXPool {
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
return this.config;
|
|
159
|
-
}
|
|
85
|
+
constructor(config) {
|
|
86
|
+
this.sounds = [];
|
|
87
|
+
this.nextId = 0;
|
|
88
|
+
this.lastPlayedAt = 0;
|
|
89
|
+
this.config = config;
|
|
90
|
+
for (let i = 0; i < config.maxInstances; i++) {
|
|
91
|
+
this.sounds.push({ id: i, playing: false, volume: 1, startedAt: 0 });
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
play(volume = 1, position) {
|
|
95
|
+
const now = Date.now();
|
|
96
|
+
if (this.config.cooldownMs && now - this.lastPlayedAt < this.config.cooldownMs) {
|
|
97
|
+
return null;
|
|
98
|
+
}
|
|
99
|
+
let slot = this.sounds.find((s) => !s.playing);
|
|
100
|
+
if (!slot) {
|
|
101
|
+
switch (this.config.strategy) {
|
|
102
|
+
case "round-robin":
|
|
103
|
+
slot = this.sounds[this.nextId % this.sounds.length];
|
|
104
|
+
break;
|
|
105
|
+
case "steal-oldest":
|
|
106
|
+
slot = this.sounds.reduce((a, b) => a.startedAt < b.startedAt ? a : b);
|
|
107
|
+
break;
|
|
108
|
+
case "steal-quietest":
|
|
109
|
+
slot = this.sounds.reduce((a, b) => a.volume < b.volume ? a : b);
|
|
110
|
+
break;
|
|
111
|
+
case "reject":
|
|
112
|
+
return null;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
if (!slot) {
|
|
116
|
+
return null;
|
|
117
|
+
}
|
|
118
|
+
slot.playing = true;
|
|
119
|
+
slot.volume = volume;
|
|
120
|
+
slot.startedAt = now;
|
|
121
|
+
this.lastPlayedAt = now;
|
|
122
|
+
this.nextId++;
|
|
123
|
+
return slot.id;
|
|
124
|
+
}
|
|
125
|
+
stop(id) {
|
|
126
|
+
const s = this.sounds.find((ss) => ss.id === id);
|
|
127
|
+
if (s) {
|
|
128
|
+
s.playing = false;
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
stopAll() {
|
|
132
|
+
for (const s of this.sounds) {
|
|
133
|
+
s.playing = false;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
getActiveCount() {
|
|
137
|
+
return this.sounds.filter((s) => s.playing).length;
|
|
138
|
+
}
|
|
139
|
+
getConfig() {
|
|
140
|
+
return this.config;
|
|
141
|
+
}
|
|
160
142
|
}
|
|
161
|
-
/* ══════════════════════════════════════════════════════════════
|
|
162
|
-
MUSIC MANAGER
|
|
163
|
-
══════════════════════════════════════════════════════════════ */
|
|
164
143
|
class MusicManager {
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
144
|
+
constructor(eventBus) {
|
|
145
|
+
this.tracks = /* @__PURE__ */ new Map();
|
|
146
|
+
this.currentTrackId = null;
|
|
147
|
+
this.adaptiveRules = [];
|
|
148
|
+
this.intensity = 0.5;
|
|
149
|
+
this.eventBus = eventBus;
|
|
150
|
+
}
|
|
151
|
+
registerTrack(track) {
|
|
152
|
+
this.tracks.set(track.id, track);
|
|
153
|
+
}
|
|
154
|
+
unregisterTrack(id) {
|
|
155
|
+
this.tracks.delete(id);
|
|
156
|
+
}
|
|
157
|
+
getTrack(id) {
|
|
158
|
+
return this.tracks.get(id);
|
|
159
|
+
}
|
|
160
|
+
getCurrentTrackId() {
|
|
161
|
+
return this.currentTrackId;
|
|
162
|
+
}
|
|
163
|
+
/** Start playing or crossfade to a new track */
|
|
164
|
+
play(trackId, crossfadeDuration = 1e3) {
|
|
165
|
+
const track = this.tracks.get(trackId);
|
|
166
|
+
if (!track) {
|
|
167
|
+
return null;
|
|
168
|
+
}
|
|
169
|
+
const config = {
|
|
170
|
+
fromTrackId: this.currentTrackId,
|
|
171
|
+
toTrackId: trackId,
|
|
172
|
+
duration: crossfadeDuration,
|
|
173
|
+
curve: "equal-power"
|
|
174
|
+
};
|
|
175
|
+
this.currentTrackId = trackId;
|
|
176
|
+
this.eventBus.emit("audio:music-crossfade", config);
|
|
177
|
+
return config;
|
|
178
|
+
}
|
|
179
|
+
stop(fadeOutMs = 500) {
|
|
180
|
+
if (this.currentTrackId) {
|
|
181
|
+
this.eventBus.emit("audio:music-stop", { trackId: this.currentTrackId, fadeOutMs });
|
|
182
|
+
this.currentTrackId = null;
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
/** Adaptive audio rules — respond to game events */
|
|
186
|
+
addRule(rule) {
|
|
187
|
+
this.adaptiveRules.push(rule);
|
|
188
|
+
this.adaptiveRules.sort((a, b) => b.priority - a.priority);
|
|
189
|
+
}
|
|
190
|
+
removeRule(id) {
|
|
191
|
+
this.adaptiveRules = this.adaptiveRules.filter((r) => r.id !== id);
|
|
192
|
+
}
|
|
193
|
+
/** Process a game event and apply matching adaptive rules */
|
|
194
|
+
processGameEvent(eventName) {
|
|
195
|
+
const rule = this.adaptiveRules.find((r) => r.triggerEvent === eventName);
|
|
196
|
+
if (!rule) {
|
|
197
|
+
return null;
|
|
198
|
+
}
|
|
199
|
+
switch (rule.action) {
|
|
200
|
+
case "switch-track":
|
|
201
|
+
if (rule.targetTrackId) {
|
|
202
|
+
this.play(rule.targetTrackId, rule.fadeDuration ?? 1e3);
|
|
189
203
|
}
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
curve: 'equal-power',
|
|
195
|
-
};
|
|
196
|
-
this.currentTrackId = trackId;
|
|
197
|
-
this.eventBus.emit('audio:music-crossfade', config);
|
|
198
|
-
return config;
|
|
199
|
-
}
|
|
200
|
-
stop(fadeOutMs = 500) {
|
|
201
|
-
if (this.currentTrackId) {
|
|
202
|
-
this.eventBus.emit('audio:music-stop', { trackId: this.currentTrackId, fadeOutMs });
|
|
203
|
-
this.currentTrackId = null;
|
|
204
|
+
break;
|
|
205
|
+
case "set-intensity":
|
|
206
|
+
if (rule.intensity !== void 0) {
|
|
207
|
+
this.intensity = rule.intensity;
|
|
204
208
|
}
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
this.
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
/** Process a game event and apply matching adaptive rules */
|
|
215
|
-
processGameEvent(eventName) {
|
|
216
|
-
const rule = this.adaptiveRules.find((r) => r.triggerEvent === eventName);
|
|
217
|
-
if (!rule) {
|
|
218
|
-
return null;
|
|
219
|
-
}
|
|
220
|
-
switch (rule.action) {
|
|
221
|
-
case 'switch-track':
|
|
222
|
-
if (rule.targetTrackId) {
|
|
223
|
-
this.play(rule.targetTrackId, rule.fadeDuration ?? 1000);
|
|
224
|
-
}
|
|
225
|
-
break;
|
|
226
|
-
case 'set-intensity':
|
|
227
|
-
if (rule.intensity !== undefined) {
|
|
228
|
-
this.intensity = rule.intensity;
|
|
229
|
-
}
|
|
230
|
-
this.eventBus.emit('audio:music-intensity', { intensity: this.intensity });
|
|
231
|
-
break;
|
|
232
|
-
case 'add-layer':
|
|
233
|
-
case 'remove-layer':
|
|
234
|
-
this.eventBus.emit(`audio:music-${rule.action}`, { layerId: rule.layerId });
|
|
235
|
-
break;
|
|
236
|
-
case 'play-stinger':
|
|
237
|
-
if (rule.stingerSrc) {
|
|
238
|
-
this.eventBus.emit('audio:play-stinger', { src: rule.stingerSrc });
|
|
239
|
-
}
|
|
240
|
-
break;
|
|
209
|
+
this.eventBus.emit("audio:music-intensity", { intensity: this.intensity });
|
|
210
|
+
break;
|
|
211
|
+
case "add-layer":
|
|
212
|
+
case "remove-layer":
|
|
213
|
+
this.eventBus.emit(`audio:music-${rule.action}`, { layerId: rule.layerId });
|
|
214
|
+
break;
|
|
215
|
+
case "play-stinger":
|
|
216
|
+
if (rule.stingerSrc) {
|
|
217
|
+
this.eventBus.emit("audio:play-stinger", { src: rule.stingerSrc });
|
|
241
218
|
}
|
|
242
|
-
|
|
243
|
-
}
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
219
|
+
break;
|
|
220
|
+
}
|
|
221
|
+
return rule;
|
|
222
|
+
}
|
|
223
|
+
getIntensity() {
|
|
224
|
+
return this.intensity;
|
|
225
|
+
}
|
|
226
|
+
setIntensity(value) {
|
|
227
|
+
this.intensity = Math.max(0, Math.min(1, value));
|
|
228
|
+
this.eventBus.emit("audio:music-intensity", { intensity: this.intensity });
|
|
229
|
+
}
|
|
230
|
+
getRules() {
|
|
231
|
+
return this.adaptiveRules;
|
|
232
|
+
}
|
|
233
|
+
getAllTracks() {
|
|
234
|
+
return Array.from(this.tracks.values());
|
|
235
|
+
}
|
|
236
|
+
/** Find tracks matching tags */
|
|
237
|
+
findByTags(tags) {
|
|
238
|
+
return this.getAllTracks().filter((t) => tags.some((tag) => t.tags.includes(tag)));
|
|
239
|
+
}
|
|
261
240
|
}
|
|
262
|
-
/* ══════════════════════════════════════════════════════════════
|
|
263
|
-
GAME AUDIO BRIDGE
|
|
264
|
-
══════════════════════════════════════════════════════════════ */
|
|
265
|
-
/** Main bridge class connecting @nice2dev/ui-audio features to the game engine */
|
|
266
241
|
class GameAudioBridge {
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
this.
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
242
|
+
constructor(eventBus) {
|
|
243
|
+
this.pools = /* @__PURE__ */ new Map();
|
|
244
|
+
this.paused = false;
|
|
245
|
+
this.snapshot = null;
|
|
246
|
+
this.eventBus = eventBus;
|
|
247
|
+
this.mixer = new AudioBusMixer(eventBus);
|
|
248
|
+
this.music = new MusicManager(eventBus);
|
|
249
|
+
this.setupGameStateHandlers();
|
|
250
|
+
}
|
|
251
|
+
setupGameStateHandlers() {
|
|
252
|
+
this.eventBus.on("game:pause", () => this.pauseAll());
|
|
253
|
+
this.eventBus.on("game:resume", () => this.resumeAll());
|
|
254
|
+
this.eventBus.on("scene:transition", (data) => {
|
|
255
|
+
if (data.musicTrackId) {
|
|
256
|
+
this.music.play(data.musicTrackId, 2e3);
|
|
257
|
+
}
|
|
258
|
+
});
|
|
259
|
+
this.eventBus.on("game:event", (data) => {
|
|
260
|
+
this.music.processGameEvent(data.name);
|
|
261
|
+
});
|
|
262
|
+
}
|
|
263
|
+
/** Register an SFX pool for frequent sounds */
|
|
264
|
+
registerPool(config) {
|
|
265
|
+
this.pools.set(config.id, new SFXPool(config));
|
|
266
|
+
}
|
|
267
|
+
/** Play a pooled SFX */
|
|
268
|
+
playSFX(poolId, volume = 1, position) {
|
|
269
|
+
const pool = this.pools.get(poolId);
|
|
270
|
+
return pool ? pool.play(volume, position) : null;
|
|
271
|
+
}
|
|
272
|
+
/** Stop a pooled SFX instance */
|
|
273
|
+
stopSFX(poolId, instanceId) {
|
|
274
|
+
this.pools.get(poolId)?.stop(instanceId);
|
|
275
|
+
}
|
|
276
|
+
/** Pause all audio (game menu, alt-tab, etc.) */
|
|
277
|
+
pauseAll() {
|
|
278
|
+
if (this.paused) {
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
this.paused = true;
|
|
282
|
+
this.snapshot = this.createSnapshot();
|
|
283
|
+
for (const pool of this.pools.values()) {
|
|
284
|
+
pool.stopAll();
|
|
285
|
+
}
|
|
286
|
+
this.eventBus.emit("audio:pause-all", {});
|
|
287
|
+
}
|
|
288
|
+
/** Resume all audio */
|
|
289
|
+
resumeAll() {
|
|
290
|
+
if (!this.paused) {
|
|
291
|
+
return;
|
|
292
|
+
}
|
|
293
|
+
this.paused = false;
|
|
294
|
+
this.eventBus.emit("audio:resume-all", { snapshot: this.snapshot });
|
|
295
|
+
this.snapshot = null;
|
|
296
|
+
}
|
|
297
|
+
isPaused() {
|
|
298
|
+
return this.paused;
|
|
299
|
+
}
|
|
300
|
+
/** Create a snapshot of current audio state for save/restore */
|
|
301
|
+
createSnapshot() {
|
|
302
|
+
const activeSounds = [];
|
|
303
|
+
for (const [poolId, pool] of this.pools) {
|
|
304
|
+
if (pool.getActiveCount() > 0) {
|
|
305
|
+
activeSounds.push({
|
|
306
|
+
id: poolId,
|
|
307
|
+
src: pool.getConfig().src,
|
|
308
|
+
bus: pool.getConfig().bus,
|
|
309
|
+
volume: 1,
|
|
310
|
+
playing: true
|
|
289
311
|
});
|
|
312
|
+
}
|
|
290
313
|
}
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
}
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
this.eventBus.emit('audio:pause-all', {});
|
|
315
|
-
}
|
|
316
|
-
/** Resume all audio */
|
|
317
|
-
resumeAll() {
|
|
318
|
-
if (!this.paused) {
|
|
319
|
-
return;
|
|
320
|
-
}
|
|
321
|
-
this.paused = false;
|
|
322
|
-
this.eventBus.emit('audio:resume-all', { snapshot: this.snapshot });
|
|
323
|
-
this.snapshot = null;
|
|
324
|
-
}
|
|
325
|
-
isPaused() {
|
|
326
|
-
return this.paused;
|
|
327
|
-
}
|
|
328
|
-
/** Create a snapshot of current audio state for save/restore */
|
|
329
|
-
createSnapshot() {
|
|
330
|
-
const activeSounds = [];
|
|
331
|
-
for (const [poolId, pool] of this.pools) {
|
|
332
|
-
if (pool.getActiveCount() > 0) {
|
|
333
|
-
activeSounds.push({
|
|
334
|
-
id: poolId,
|
|
335
|
-
src: pool.getConfig().src,
|
|
336
|
-
bus: pool.getConfig().bus,
|
|
337
|
-
volume: 1,
|
|
338
|
-
playing: true,
|
|
339
|
-
});
|
|
340
|
-
}
|
|
341
|
-
}
|
|
342
|
-
return {
|
|
343
|
-
timestamp: Date.now(),
|
|
344
|
-
busVolumes: this.mixer.snapshot(),
|
|
345
|
-
activeSounds,
|
|
346
|
-
currentMusicTrack: this.music.getCurrentTrackId(),
|
|
347
|
-
musicPosition: 0,
|
|
348
|
-
};
|
|
349
|
-
}
|
|
350
|
-
/** Restore audio from a snapshot */
|
|
351
|
-
restoreSnapshot(snap) {
|
|
352
|
-
for (const [bus, vol] of Object.entries(snap.busVolumes)) {
|
|
353
|
-
this.mixer.setVolume(bus, vol);
|
|
354
|
-
}
|
|
355
|
-
if (snap.currentMusicTrack) {
|
|
356
|
-
this.music.play(snap.currentMusicTrack, 0);
|
|
357
|
-
}
|
|
358
|
-
}
|
|
359
|
-
/** Process a game audio event */
|
|
360
|
-
processEvent(event) {
|
|
361
|
-
switch (event.type) {
|
|
362
|
-
case 'set-bus-volume':
|
|
363
|
-
if (event.bus !== undefined && event.volume !== undefined) {
|
|
364
|
-
this.mixer.setVolume(event.bus, event.volume);
|
|
365
|
-
}
|
|
366
|
-
break;
|
|
367
|
-
case 'crossfade':
|
|
368
|
-
if (event.sourceId) {
|
|
369
|
-
this.music.play(event.sourceId, event.fadeDuration ?? 1000);
|
|
370
|
-
}
|
|
371
|
-
break;
|
|
372
|
-
default:
|
|
373
|
-
this.eventBus.emit(`audio:${event.type}`, event);
|
|
314
|
+
return {
|
|
315
|
+
timestamp: Date.now(),
|
|
316
|
+
busVolumes: this.mixer.snapshot(),
|
|
317
|
+
activeSounds,
|
|
318
|
+
currentMusicTrack: this.music.getCurrentTrackId(),
|
|
319
|
+
musicPosition: 0
|
|
320
|
+
};
|
|
321
|
+
}
|
|
322
|
+
/** Restore audio from a snapshot */
|
|
323
|
+
restoreSnapshot(snap) {
|
|
324
|
+
for (const [bus, vol] of Object.entries(snap.busVolumes)) {
|
|
325
|
+
this.mixer.setVolume(bus, vol);
|
|
326
|
+
}
|
|
327
|
+
if (snap.currentMusicTrack) {
|
|
328
|
+
this.music.play(snap.currentMusicTrack, 0);
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
/** Process a game audio event */
|
|
332
|
+
processEvent(event) {
|
|
333
|
+
switch (event.type) {
|
|
334
|
+
case "set-bus-volume":
|
|
335
|
+
if (event.bus !== void 0 && event.volume !== void 0) {
|
|
336
|
+
this.mixer.setVolume(event.bus, event.volume);
|
|
374
337
|
}
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
getAllPools() {
|
|
380
|
-
return new Map(this.pools);
|
|
381
|
-
}
|
|
382
|
-
destroy() {
|
|
383
|
-
for (const pool of this.pools.values()) {
|
|
384
|
-
pool.stopAll();
|
|
338
|
+
break;
|
|
339
|
+
case "crossfade":
|
|
340
|
+
if (event.sourceId) {
|
|
341
|
+
this.music.play(event.sourceId, event.fadeDuration ?? 1e3);
|
|
385
342
|
}
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
343
|
+
break;
|
|
344
|
+
default:
|
|
345
|
+
this.eventBus.emit(`audio:${event.type}`, event);
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
getPool(id) {
|
|
349
|
+
return this.pools.get(id);
|
|
350
|
+
}
|
|
351
|
+
getAllPools() {
|
|
352
|
+
return new Map(this.pools);
|
|
353
|
+
}
|
|
354
|
+
destroy() {
|
|
355
|
+
for (const pool of this.pools.values()) {
|
|
356
|
+
pool.stopAll();
|
|
357
|
+
}
|
|
358
|
+
this.pools.clear();
|
|
359
|
+
this.music.stop(0);
|
|
360
|
+
}
|
|
389
361
|
}
|
|
390
|
-
/* ══════════════════════════════════════════════════════════════
|
|
391
|
-
REACT HOOK & COMPONENT
|
|
392
|
-
══════════════════════════════════════════════════════════════ */
|
|
393
362
|
function useGameAudio(eventBus) {
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
};
|
|
406
|
-
}, [bridge]);
|
|
407
|
-
const playSFX = useCallback((poolId, volume, position) => bridge.playSFX(poolId, volume, position), [bridge]);
|
|
408
|
-
const playMusic = useCallback((trackId, crossfadeDuration) => bridge.music.play(trackId, crossfadeDuration), [bridge]);
|
|
409
|
-
const stopMusic = useCallback((fadeOutMs) => bridge.music.stop(fadeOutMs), [bridge]);
|
|
410
|
-
const setVolume = useCallback((bus, volume) => bridge.mixer.setVolume(bus, volume), [bridge]);
|
|
411
|
-
return {
|
|
412
|
-
bridge,
|
|
413
|
-
playSFX,
|
|
414
|
-
playMusic,
|
|
415
|
-
stopMusic,
|
|
416
|
-
setVolume,
|
|
417
|
-
pauseAll: () => bridge.pauseAll(),
|
|
418
|
-
resumeAll: () => bridge.resumeAll(),
|
|
419
|
-
registerPool: (config) => bridge.registerPool(config),
|
|
420
|
-
registerTrack: (track) => bridge.music.registerTrack(track),
|
|
363
|
+
const bridgeRef = useRef(null);
|
|
364
|
+
const bridge = useMemo(() => {
|
|
365
|
+
if (!bridgeRef.current) {
|
|
366
|
+
bridgeRef.current = new GameAudioBridge(eventBus);
|
|
367
|
+
}
|
|
368
|
+
return bridgeRef.current;
|
|
369
|
+
}, [eventBus]);
|
|
370
|
+
useEffect(() => {
|
|
371
|
+
return () => {
|
|
372
|
+
bridge.destroy();
|
|
373
|
+
bridgeRef.current = null;
|
|
421
374
|
};
|
|
375
|
+
}, [bridge]);
|
|
376
|
+
const playSFX = useCallback(
|
|
377
|
+
(poolId, volume, position) => bridge.playSFX(poolId, volume, position),
|
|
378
|
+
[bridge]
|
|
379
|
+
);
|
|
380
|
+
const playMusic = useCallback(
|
|
381
|
+
(trackId, crossfadeDuration) => bridge.music.play(trackId, crossfadeDuration),
|
|
382
|
+
[bridge]
|
|
383
|
+
);
|
|
384
|
+
const stopMusic = useCallback((fadeOutMs) => bridge.music.stop(fadeOutMs), [bridge]);
|
|
385
|
+
const setVolume = useCallback(
|
|
386
|
+
(bus, volume) => bridge.mixer.setVolume(bus, volume),
|
|
387
|
+
[bridge]
|
|
388
|
+
);
|
|
389
|
+
return {
|
|
390
|
+
bridge,
|
|
391
|
+
playSFX,
|
|
392
|
+
playMusic,
|
|
393
|
+
stopMusic,
|
|
394
|
+
setVolume,
|
|
395
|
+
pauseAll: () => bridge.pauseAll(),
|
|
396
|
+
resumeAll: () => bridge.resumeAll(),
|
|
397
|
+
registerPool: (config) => bridge.registerPool(config),
|
|
398
|
+
registerTrack: (track) => bridge.music.registerTrack(track)
|
|
399
|
+
};
|
|
422
400
|
}
|
|
423
|
-
const GameAudioSettings = ({
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
fontVariantNumeric: 'tabular-nums',
|
|
401
|
+
const GameAudioSettings = ({
|
|
402
|
+
bridge,
|
|
403
|
+
className,
|
|
404
|
+
style
|
|
405
|
+
}) => {
|
|
406
|
+
const [volumes, setVolumes] = useState(
|
|
407
|
+
() => bridge.mixer.snapshot()
|
|
408
|
+
);
|
|
409
|
+
const handleVolumeChange = useCallback(
|
|
410
|
+
(bus, value) => {
|
|
411
|
+
bridge.mixer.setVolume(bus, value);
|
|
412
|
+
setVolumes((prev) => ({ ...prev, [bus]: value }));
|
|
413
|
+
},
|
|
414
|
+
[bridge]
|
|
415
|
+
);
|
|
416
|
+
const busOrder = ["master", "music", "sfx", "voice", "ambient", "ui"];
|
|
417
|
+
return React.createElement(
|
|
418
|
+
"div",
|
|
419
|
+
{
|
|
420
|
+
className: `nice-game-audio-settings ${className ?? ""}`.trim(),
|
|
421
|
+
style: { display: "flex", flexDirection: "column", gap: 8, padding: 16, ...style }
|
|
422
|
+
},
|
|
423
|
+
busOrder.map(
|
|
424
|
+
(bus) => React.createElement(
|
|
425
|
+
"div",
|
|
426
|
+
{
|
|
427
|
+
key: bus,
|
|
428
|
+
style: { display: "flex", alignItems: "center", gap: 8 }
|
|
452
429
|
},
|
|
453
|
-
|
|
430
|
+
React.createElement(
|
|
431
|
+
"label",
|
|
432
|
+
{
|
|
433
|
+
style: { width: 80, textTransform: "capitalize", fontSize: 14 }
|
|
434
|
+
},
|
|
435
|
+
bus
|
|
436
|
+
),
|
|
437
|
+
React.createElement("input", {
|
|
438
|
+
type: "range",
|
|
439
|
+
min: 0,
|
|
440
|
+
max: 1,
|
|
441
|
+
step: 0.01,
|
|
442
|
+
value: volumes[bus] ?? 1,
|
|
443
|
+
onChange: (e) => handleVolumeChange(bus, parseFloat(e.target.value)),
|
|
444
|
+
style: { flex: 1 }
|
|
445
|
+
}),
|
|
446
|
+
React.createElement(
|
|
447
|
+
"span",
|
|
448
|
+
{
|
|
449
|
+
style: {
|
|
450
|
+
width: 40,
|
|
451
|
+
textAlign: "right",
|
|
452
|
+
fontSize: 12,
|
|
453
|
+
fontVariantNumeric: "tabular-nums"
|
|
454
|
+
}
|
|
455
|
+
},
|
|
456
|
+
`${Math.round((volumes[bus] ?? 1) * 100)}%`
|
|
457
|
+
)
|
|
458
|
+
)
|
|
459
|
+
)
|
|
460
|
+
);
|
|
454
461
|
};
|
|
455
|
-
if (process.env.NODE_ENV !==
|
|
456
|
-
|
|
462
|
+
if (process.env.NODE_ENV !== "production") {
|
|
463
|
+
GameAudioSettings.displayName = "GameAudioSettings";
|
|
457
464
|
}
|
|
458
|
-
|
|
459
|
-
|
|
465
|
+
export {
|
|
466
|
+
AudioBusMixer,
|
|
467
|
+
DEFAULT_SPATIAL,
|
|
468
|
+
GameAudioBridge,
|
|
469
|
+
GameAudioSettings,
|
|
470
|
+
MusicManager,
|
|
471
|
+
SFXPool,
|
|
472
|
+
useGameAudio
|
|
473
|
+
};
|