@oyna360/lobby-sdk 0.1.0

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.
Files changed (211) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +123 -0
  3. package/dist/avatar-accessories.d.ts +16 -0
  4. package/dist/avatar-accessories.d.ts.map +1 -0
  5. package/dist/avatar-accessories.js +214 -0
  6. package/dist/avatar-accessories.js.map +1 -0
  7. package/dist/avatar-asset-manager.d.ts +54 -0
  8. package/dist/avatar-asset-manager.d.ts.map +1 -0
  9. package/dist/avatar-asset-manager.js +215 -0
  10. package/dist/avatar-asset-manager.js.map +1 -0
  11. package/dist/avatar-clips.d.ts +17 -0
  12. package/dist/avatar-clips.d.ts.map +1 -0
  13. package/dist/avatar-clips.js +47 -0
  14. package/dist/avatar-clips.js.map +1 -0
  15. package/dist/avatar-config.d.ts +4 -0
  16. package/dist/avatar-config.d.ts.map +1 -0
  17. package/dist/avatar-config.js +9 -0
  18. package/dist/avatar-config.js.map +1 -0
  19. package/dist/avatar-factory.d.ts +64 -0
  20. package/dist/avatar-factory.d.ts.map +1 -0
  21. package/dist/avatar-factory.js +464 -0
  22. package/dist/avatar-factory.js.map +1 -0
  23. package/dist/avatar-instance.d.ts +31 -0
  24. package/dist/avatar-instance.d.ts.map +1 -0
  25. package/dist/avatar-instance.js +56 -0
  26. package/dist/avatar-instance.js.map +1 -0
  27. package/dist/avatar-material-pipeline.d.ts +34 -0
  28. package/dist/avatar-material-pipeline.d.ts.map +1 -0
  29. package/dist/avatar-material-pipeline.js +580 -0
  30. package/dist/avatar-material-pipeline.js.map +1 -0
  31. package/dist/avatar-rig-builder.d.ts +74 -0
  32. package/dist/avatar-rig-builder.d.ts.map +1 -0
  33. package/dist/avatar-rig-builder.js +347 -0
  34. package/dist/avatar-rig-builder.js.map +1 -0
  35. package/dist/draco.d.ts +7 -0
  36. package/dist/draco.d.ts.map +1 -0
  37. package/dist/draco.js +82 -0
  38. package/dist/draco.js.map +1 -0
  39. package/dist/humanoid-animator.d.ts +35 -0
  40. package/dist/humanoid-animator.d.ts.map +1 -0
  41. package/dist/humanoid-animator.js +191 -0
  42. package/dist/humanoid-animator.js.map +1 -0
  43. package/dist/humanoid-bone-names.d.ts +35 -0
  44. package/dist/humanoid-bone-names.d.ts.map +1 -0
  45. package/dist/humanoid-bone-names.js +126 -0
  46. package/dist/humanoid-bone-names.js.map +1 -0
  47. package/dist/humanoid-locomotion.d.ts +101 -0
  48. package/dist/humanoid-locomotion.d.ts.map +1 -0
  49. package/dist/humanoid-locomotion.js +300 -0
  50. package/dist/humanoid-locomotion.js.map +1 -0
  51. package/dist/humanoid-rig.d.ts +51 -0
  52. package/dist/humanoid-rig.d.ts.map +1 -0
  53. package/dist/humanoid-rig.js +304 -0
  54. package/dist/humanoid-rig.js.map +1 -0
  55. package/dist/index.d.ts +60 -0
  56. package/dist/index.d.ts.map +1 -0
  57. package/dist/index.js +42 -0
  58. package/dist/index.js.map +1 -0
  59. package/dist/lobby-chat-ui.d.ts +3 -0
  60. package/dist/lobby-chat-ui.d.ts.map +1 -0
  61. package/dist/lobby-chat-ui.js +258 -0
  62. package/dist/lobby-chat-ui.js.map +1 -0
  63. package/dist/lobby-colliders.d.ts +10 -0
  64. package/dist/lobby-colliders.d.ts.map +1 -0
  65. package/dist/lobby-colliders.js +225 -0
  66. package/dist/lobby-colliders.js.map +1 -0
  67. package/dist/lobby-connection-ui.d.ts +8 -0
  68. package/dist/lobby-connection-ui.d.ts.map +1 -0
  69. package/dist/lobby-connection-ui.js +68 -0
  70. package/dist/lobby-connection-ui.js.map +1 -0
  71. package/dist/lobby-debug.d.ts +50 -0
  72. package/dist/lobby-debug.d.ts.map +1 -0
  73. package/dist/lobby-debug.js +132 -0
  74. package/dist/lobby-debug.js.map +1 -0
  75. package/dist/lobby-font.d.ts +5 -0
  76. package/dist/lobby-font.d.ts.map +1 -0
  77. package/dist/lobby-font.js +35 -0
  78. package/dist/lobby-font.js.map +1 -0
  79. package/dist/lobby-music.d.ts +40 -0
  80. package/dist/lobby-music.d.ts.map +1 -0
  81. package/dist/lobby-music.js +250 -0
  82. package/dist/lobby-music.js.map +1 -0
  83. package/dist/lobby-orientation-ui.d.ts +10 -0
  84. package/dist/lobby-orientation-ui.d.ts.map +1 -0
  85. package/dist/lobby-orientation-ui.js +64 -0
  86. package/dist/lobby-orientation-ui.js.map +1 -0
  87. package/dist/lobby-perf-diag.d.ts +254 -0
  88. package/dist/lobby-perf-diag.d.ts.map +1 -0
  89. package/dist/lobby-perf-diag.js +775 -0
  90. package/dist/lobby-perf-diag.js.map +1 -0
  91. package/dist/lobby-plaza-diag.d.ts +103 -0
  92. package/dist/lobby-plaza-diag.d.ts.map +1 -0
  93. package/dist/lobby-plaza-diag.js +534 -0
  94. package/dist/lobby-plaza-diag.js.map +1 -0
  95. package/dist/lobby-presence-ui.d.ts +4 -0
  96. package/dist/lobby-presence-ui.d.ts.map +1 -0
  97. package/dist/lobby-presence-ui.js +89 -0
  98. package/dist/lobby-presence-ui.js.map +1 -0
  99. package/dist/lobby-real-device-diag.d.ts +119 -0
  100. package/dist/lobby-real-device-diag.d.ts.map +1 -0
  101. package/dist/lobby-real-device-diag.js +468 -0
  102. package/dist/lobby-real-device-diag.js.map +1 -0
  103. package/dist/lobby-spawn.d.ts +15 -0
  104. package/dist/lobby-spawn.d.ts.map +1 -0
  105. package/dist/lobby-spawn.js +18 -0
  106. package/dist/lobby-spawn.js.map +1 -0
  107. package/dist/lobby-ui-i18n.d.ts +11 -0
  108. package/dist/lobby-ui-i18n.d.ts.map +1 -0
  109. package/dist/lobby-ui-i18n.js +21 -0
  110. package/dist/lobby-ui-i18n.js.map +1 -0
  111. package/dist/lobby-voice-ui.d.ts +3 -0
  112. package/dist/lobby-voice-ui.d.ts.map +1 -0
  113. package/dist/lobby-voice-ui.js +105 -0
  114. package/dist/lobby-voice-ui.js.map +1 -0
  115. package/dist/local-player-controller.d.ts +80 -0
  116. package/dist/local-player-controller.d.ts.map +1 -0
  117. package/dist/local-player-controller.js +422 -0
  118. package/dist/local-player-controller.js.map +1 -0
  119. package/dist/name-tag.d.ts +3 -0
  120. package/dist/name-tag.d.ts.map +1 -0
  121. package/dist/name-tag.js +59 -0
  122. package/dist/name-tag.js.map +1 -0
  123. package/dist/network-client.d.ts +87 -0
  124. package/dist/network-client.d.ts.map +1 -0
  125. package/dist/network-client.js +182 -0
  126. package/dist/network-client.js.map +1 -0
  127. package/dist/platform-bridge.d.ts +17 -0
  128. package/dist/platform-bridge.d.ts.map +1 -0
  129. package/dist/platform-bridge.js +90 -0
  130. package/dist/platform-bridge.js.map +1 -0
  131. package/dist/platform-lobby.d.ts +176 -0
  132. package/dist/platform-lobby.d.ts.map +1 -0
  133. package/dist/platform-lobby.js +679 -0
  134. package/dist/platform-lobby.js.map +1 -0
  135. package/dist/platform-types.d.ts +56 -0
  136. package/dist/platform-types.d.ts.map +1 -0
  137. package/dist/platform-types.js +3 -0
  138. package/dist/platform-types.js.map +1 -0
  139. package/dist/player-label.d.ts +9 -0
  140. package/dist/player-label.d.ts.map +1 -0
  141. package/dist/player-label.js +14 -0
  142. package/dist/player-label.js.map +1 -0
  143. package/dist/playground/playground-layout.d.ts +14 -0
  144. package/dist/playground/playground-layout.d.ts.map +1 -0
  145. package/dist/playground/playground-layout.js +320 -0
  146. package/dist/playground/playground-layout.js.map +1 -0
  147. package/dist/playground/playground-system.d.ts +30 -0
  148. package/dist/playground/playground-system.d.ts.map +1 -0
  149. package/dist/playground/playground-system.js +202 -0
  150. package/dist/playground/playground-system.js.map +1 -0
  151. package/dist/plaza-layout.d.ts +30 -0
  152. package/dist/plaza-layout.d.ts.map +1 -0
  153. package/dist/plaza-layout.js +527 -0
  154. package/dist/plaza-layout.js.map +1 -0
  155. package/dist/plugins.d.ts +5 -0
  156. package/dist/plugins.d.ts.map +1 -0
  157. package/dist/plugins.js +26 -0
  158. package/dist/plugins.js.map +1 -0
  159. package/dist/protocol.d.ts +276 -0
  160. package/dist/protocol.d.ts.map +1 -0
  161. package/dist/protocol.js +107 -0
  162. package/dist/protocol.js.map +1 -0
  163. package/dist/quality.d.ts +39 -0
  164. package/dist/quality.d.ts.map +1 -0
  165. package/dist/quality.js +95 -0
  166. package/dist/quality.js.map +1 -0
  167. package/dist/remote-player-manager.d.ts +48 -0
  168. package/dist/remote-player-manager.d.ts.map +1 -0
  169. package/dist/remote-player-manager.js +339 -0
  170. package/dist/remote-player-manager.js.map +1 -0
  171. package/dist/scene-manager.d.ts +26 -0
  172. package/dist/scene-manager.d.ts.map +1 -0
  173. package/dist/scene-manager.js +169 -0
  174. package/dist/scene-manager.js.map +1 -0
  175. package/dist/spawn-utils.d.ts +8 -0
  176. package/dist/spawn-utils.d.ts.map +1 -0
  177. package/dist/spawn-utils.js +29 -0
  178. package/dist/spawn-utils.js.map +1 -0
  179. package/dist/starter-layout.d.ts +17 -0
  180. package/dist/starter-layout.d.ts.map +1 -0
  181. package/dist/starter-layout.js +102 -0
  182. package/dist/starter-layout.js.map +1 -0
  183. package/dist/third-person-camera.d.ts +35 -0
  184. package/dist/third-person-camera.d.ts.map +1 -0
  185. package/dist/third-person-camera.js +181 -0
  186. package/dist/third-person-camera.js.map +1 -0
  187. package/dist/types.d.ts +164 -0
  188. package/dist/types.d.ts.map +1 -0
  189. package/dist/types.js +2 -0
  190. package/dist/types.js.map +1 -0
  191. package/dist/voice-chat.d.ts +78 -0
  192. package/dist/voice-chat.d.ts.map +1 -0
  193. package/dist/voice-chat.js +321 -0
  194. package/dist/voice-chat.js.map +1 -0
  195. package/dist/yield-to-render.d.ts +3 -0
  196. package/dist/yield-to-render.d.ts.map +1 -0
  197. package/dist/yield-to-render.js +11 -0
  198. package/dist/yield-to-render.js.map +1 -0
  199. package/dist/zones.d.ts +36 -0
  200. package/dist/zones.d.ts.map +1 -0
  201. package/dist/zones.js +68 -0
  202. package/dist/zones.js.map +1 -0
  203. package/docs/00-overview.md +47 -0
  204. package/docs/01-connect.md +85 -0
  205. package/docs/02-github.md +43 -0
  206. package/docs/03-modes.md +70 -0
  207. package/docs/04-api.md +106 -0
  208. package/docs/05-features.md +55 -0
  209. package/docs/06-controls.md +34 -0
  210. package/docs/07-troubleshooting.md +39 -0
  211. package/package.json +65 -0
@@ -0,0 +1,102 @@
1
+ import { Color3, MeshBuilder, PointLight, StandardMaterial, TransformNode, Vector3, } from '@babylonjs/core';
2
+ export function applyStarterLayout(lobby, config = {}) {
3
+ const scene = lobby.getScene();
4
+ const { showZones = true, showGameplayPortal = true, showGrid = true, gamePortals = [], } = config;
5
+ if (showGrid) {
6
+ const grid = MeshBuilder.CreateGround('grid-floor', { width: 48, height: 48, subdivisions: 24 }, scene);
7
+ grid.position.y = 0.015;
8
+ const gridMat = new StandardMaterial('grid-floor-mat', scene);
9
+ gridMat.wireframe = true;
10
+ gridMat.emissiveColor = Color3.FromHexString('#818cf8').scale(0.12);
11
+ grid.material = gridMat;
12
+ }
13
+ const plaza = MeshBuilder.CreateDisc('spawn-plaza', { radius: 4, tessellation: 48 }, scene);
14
+ plaza.position.y = 0.03;
15
+ const plazaMat = new StandardMaterial('spawn-plaza-mat', scene);
16
+ plazaMat.diffuseColor = Color3.FromHexString('#7c3aed');
17
+ plazaMat.emissiveColor = Color3.FromHexString('#a78bfa').scale(0.55);
18
+ plaza.material = plazaMat;
19
+ const pillarPositions = [
20
+ { x: -12, y: 0, z: -12 },
21
+ { x: 12, y: 0, z: -12 },
22
+ { x: -12, y: 0, z: 12 },
23
+ { x: 12, y: 0, z: 12 },
24
+ ];
25
+ for (let i = 0; i < pillarPositions.length; i++) {
26
+ const p = pillarPositions[i];
27
+ const pillar = MeshBuilder.CreateBox(`pillar-${i}`, { width: 1.2, height: 4, depth: 1.2 }, scene);
28
+ pillar.position = new Vector3(p.x, 2, p.z);
29
+ const mat = new StandardMaterial(`pillar-mat-${i}`, scene);
30
+ mat.diffuseColor = Color3.FromHexString('#4338ca');
31
+ mat.emissiveColor = Color3.FromHexString('#818cf8').scale(0.35);
32
+ pillar.material = mat;
33
+ }
34
+ if (showGameplayPortal) {
35
+ createPortalVisual(scene, 'portal-main', { x: 0, y: 0, z: 10 }, '#22d3ee');
36
+ lobby.addPortal({
37
+ id: 'gameplay-portal',
38
+ position: { x: 0, y: 0, z: 10 },
39
+ radius: 2.2,
40
+ toScene: 'gameplay',
41
+ });
42
+ }
43
+ if (showZones) {
44
+ createZonePlatform(scene, 'zone-shop', { x: -8, y: 0, z: 0 }, '#f59e0b');
45
+ lobby.addZone({
46
+ id: 'shop',
47
+ bounds: { min: { x: -10, y: 0, z: -3 }, max: { x: -6, y: 4, z: 3 } },
48
+ onEnter: () => lobby.emitOverlay('shop', { open: true }),
49
+ onExit: () => lobby.emitOverlay('shop', { open: false }),
50
+ });
51
+ createZonePlatform(scene, 'zone-leaderboard', { x: 8, y: 0, z: 0 }, '#10b981');
52
+ lobby.addZone({
53
+ id: 'leaderboard',
54
+ bounds: { min: { x: 6, y: 0, z: -3 }, max: { x: 10, y: 4, z: 3 } },
55
+ onEnter: () => lobby.emitOverlay('leaderboard', { open: true }),
56
+ onExit: () => lobby.emitOverlay('leaderboard', { open: false }),
57
+ });
58
+ }
59
+ for (const gp of gamePortals) {
60
+ createPortalVisual(scene, `portal-${gp.slug}`, gp.position, '#a855f7');
61
+ lobby.addPortal({
62
+ id: `portal-${gp.slug}`,
63
+ position: gp.position,
64
+ radius: 2,
65
+ toGameSlug: gp.slug,
66
+ label: gp.name,
67
+ });
68
+ }
69
+ }
70
+ export function createPortalVisual(scene, id, position, color) {
71
+ const root = new TransformNode(`portal-root-${id}`, scene);
72
+ root.position = new Vector3(position.x, 0, position.z);
73
+ const ring = MeshBuilder.CreateTorus(`portal-ring-${id}`, { diameter: 3.2, thickness: 0.28, tessellation: 48 }, scene);
74
+ ring.parent = root;
75
+ ring.position.y = 2.2;
76
+ ring.rotation.x = Math.PI / 2;
77
+ const ringMat = new StandardMaterial(`portal-ring-mat-${id}`, scene);
78
+ ringMat.diffuseColor = Color3.FromHexString(color);
79
+ ringMat.emissiveColor = Color3.FromHexString(color).scale(0.85);
80
+ ring.material = ringMat;
81
+ const pad = MeshBuilder.CreateDisc(`portal-pad-${id}`, { radius: 1.6, tessellation: 32 }, scene);
82
+ pad.parent = root;
83
+ pad.position.y = 0.04;
84
+ const padMat = new StandardMaterial(`portal-pad-mat-${id}`, scene);
85
+ padMat.diffuseColor = Color3.FromHexString(color);
86
+ padMat.emissiveColor = Color3.FromHexString(color).scale(0.35);
87
+ pad.material = padMat;
88
+ const light = new PointLight(`portal-light-${id}`, new Vector3(0, 2.5, 0), scene);
89
+ light.diffuse = Color3.FromHexString(color);
90
+ light.intensity = 1.2;
91
+ light.parent = root;
92
+ return root;
93
+ }
94
+ function createZonePlatform(scene, id, position, color) {
95
+ const disc = MeshBuilder.CreateDisc(id, { radius: 2.2, tessellation: 32 }, scene);
96
+ disc.position = new Vector3(position.x, 0.04, position.z);
97
+ const mat = new StandardMaterial(`${id}-mat`, scene);
98
+ mat.diffuseColor = Color3.FromHexString(color);
99
+ mat.emissiveColor = Color3.FromHexString(color).scale(0.45);
100
+ disc.material = mat;
101
+ }
102
+ //# sourceMappingURL=starter-layout.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"starter-layout.js","sourceRoot":"","sources":["../src/starter-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,OAAO,GACR,MAAM,iBAAiB,CAAC;AAYzB,MAAM,UAAU,kBAAkB,CAAC,KAAoB,EAAE,SAA8B,EAAE;IACvF,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,EACJ,SAAS,GAAG,IAAI,EAChB,kBAAkB,GAAG,IAAI,EACzB,QAAQ,GAAG,IAAI,EACf,WAAW,GAAG,EAAE,GACjB,GAAG,MAAM,CAAC;IAEX,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACxG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QACzB,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5F,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAChE,QAAQ,CAAC,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAE1B,MAAM,eAAe,GAAW;QAC9B,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE;QACvB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE;KACvB,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QAClG,MAAM,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3D,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACnD,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,IAAI,kBAAkB,EAAE,CAAC;QACvB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3E,KAAK,CAAC,SAAS,CAAC;YACd,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE;YAC/B,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACzE,KAAK,CAAC,OAAO,CAAC;YACZ,EAAE,EAAE,MAAM;YACV,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YACpE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACxD,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACzD,CAAC,CAAC;QAEH,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC/E,KAAK,CAAC,OAAO,CAAC;YACZ,EAAE,EAAE,aAAa;YACjB,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YAClE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC/D,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACvE,KAAK,CAAC,SAAS,CAAC;YACd,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE;YACvB,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,EAAE,CAAC,IAAI;YACnB,KAAK,EAAE,EAAE,CAAC,IAAI;SACf,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAsC,EACtC,EAAU,EACV,QAAc,EACd,KAAa;IAEb,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,eAAe,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEvD,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAClC,eAAe,EAAE,EAAE,EACnB,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,EACpD,KAAK,CACN,CAAC;IACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC;IACtB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,mBAAmB,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACnD,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAExB,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACjG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;IACtB,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACnE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC;IAEtB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,gBAAgB,EAAE,EAAE,EAAE,IAAI,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAClF,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5C,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC;IACtB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAEpB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAsC,EACtC,EAAU,EACV,QAAc,EACd,KAAa;IAEb,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/C,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;AACtB,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { ArcRotateCamera, Vector3 } from '@babylonjs/core';
2
+ import type { AbstractMesh, Scene } from '@babylonjs/core';
3
+ export declare class ThirdPersonCamera {
4
+ private scene;
5
+ readonly camera: ArcRotateCamera;
6
+ wantedRadius: number;
7
+ private target;
8
+ private lookX;
9
+ private lookY;
10
+ private dragging;
11
+ private pointerId;
12
+ private lastX;
13
+ private lastY;
14
+ private readonly desiredTarget;
15
+ private readonly camDir;
16
+ private readonly occlusionRay;
17
+ private ignoreSet;
18
+ constructor(scene: Scene, canvas: HTMLCanvasElement, options?: {
19
+ distance?: number;
20
+ height?: number;
21
+ });
22
+ private minRadius;
23
+ /** Mobile look pad: x/y in -1..1 held, or instantaneous deltas via addLookDelta. */
24
+ setLookStick(x: number, y: number): void;
25
+ addLookDelta(dx: number, dy: number): void;
26
+ private onPointerDown;
27
+ private onPointerMove;
28
+ private onPointerUp;
29
+ private onWheel;
30
+ private clampBeta;
31
+ update(playerPosition: Vector3, dt: number, ignoreMeshes: AbstractMesh[]): void;
32
+ private onContextMenu;
33
+ dispose(canvas: HTMLCanvasElement): void;
34
+ }
35
+ //# sourceMappingURL=third-person-camera.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"third-person-camera.d.ts","sourceRoot":"","sources":["../src/third-person-camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAO,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAS3D,qBAAa,iBAAiB;IAgB1B,OAAO,CAAC,KAAK;IAff,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiD;IAC9E,OAAO,CAAC,SAAS,CAA2B;gBAGlC,KAAK,EAAE,KAAK,EACpB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IA8BtD,OAAO,CAAC,SAAS;IAIjB,oFAAoF;IACpF,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAKjC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAMnC,OAAO,CAAC,aAAa,CAWnB;IAEF,OAAO,CAAC,aAAa,CAKnB;IAEF,OAAO,CAAC,WAAW,CAIjB;IAEF,OAAO,CAAC,OAAO,CAIb;IAEF,OAAO,CAAC,SAAS;IAgBjB,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE;IA+DxE,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,MAAM,EAAE,iBAAiB;CAQlC"}
@@ -0,0 +1,181 @@
1
+ import { ArcRotateCamera, Ray, Vector3 } from '@babylonjs/core';
2
+ /** Keep the lens above the floor so near-plane clipping never paints the whole frame black. */
3
+ const MIN_CAMERA_Y = 0.55;
4
+ /** Floor for occlusion pull-in; game tuning may raise lowerRadiusLimit further. */
5
+ const DEFAULT_MIN_RADIUS = 2.2;
6
+ /** Pull back from the hit surface so the near plane stays outside the mesh. */
7
+ const OCCLUSION_CLEARANCE = 0.55;
8
+ export class ThirdPersonCamera {
9
+ scene;
10
+ camera;
11
+ wantedRadius;
12
+ target = new Vector3(0, 1.6, 0);
13
+ lookX = 0;
14
+ lookY = 0;
15
+ dragging = false;
16
+ pointerId = -1;
17
+ lastX = 0;
18
+ lastY = 0;
19
+ desiredTarget = new Vector3();
20
+ camDir = new Vector3();
21
+ occlusionRay = new Ray(Vector3.Zero(), Vector3.Forward(), 1);
22
+ ignoreSet = new Set();
23
+ constructor(scene, canvas, options = {}) {
24
+ this.scene = scene;
25
+ const distance = options.distance ?? 9.5;
26
+ const worldHeight = options.height && options.height >= 2 ? options.height : 5;
27
+ this.wantedRadius = distance;
28
+ const yOff = Math.max(1.4, worldHeight - 1.65);
29
+ const beta = Math.acos(Math.min(0.82, Math.max(0.18, yOff / distance)));
30
+ this.camera = new ArcRotateCamera('camera', Math.PI, beta, distance, this.target.clone(), scene);
31
+ this.camera.lowerRadiusLimit = DEFAULT_MIN_RADIUS;
32
+ this.camera.upperRadiusLimit = 16;
33
+ // beta≈0 top-down, β=π/2 horizon, β>π/2 looks up at the sky.
34
+ this.camera.lowerBetaLimit = 0.28;
35
+ this.camera.upperBetaLimit = 1.72;
36
+ this.camera.minZ = 0.2;
37
+ this.camera.maxZ = 800;
38
+ this.camera.panningSensibility = 0;
39
+ this.camera.inertia = 0;
40
+ this.camera.inputs.clear();
41
+ // pointerdown on canvas; move/up on window so look still works inside cross-origin iframes
42
+ // where setPointerCapture is flaky and move events miss the canvas.
43
+ canvas.addEventListener('pointerdown', this.onPointerDown);
44
+ window.addEventListener('pointermove', this.onPointerMove);
45
+ window.addEventListener('pointerup', this.onPointerUp);
46
+ window.addEventListener('pointercancel', this.onPointerUp);
47
+ canvas.addEventListener('wheel', this.onWheel, { passive: false });
48
+ canvas.addEventListener('contextmenu', this.onContextMenu);
49
+ }
50
+ minRadius() {
51
+ return Math.max(DEFAULT_MIN_RADIUS, this.camera.lowerRadiusLimit ?? DEFAULT_MIN_RADIUS);
52
+ }
53
+ /** Mobile look pad: x/y in -1..1 held, or instantaneous deltas via addLookDelta. */
54
+ setLookStick(x, y) {
55
+ this.lookX = Math.abs(x) < 0.06 ? 0 : x;
56
+ this.lookY = Math.abs(y) < 0.06 ? 0 : y;
57
+ }
58
+ addLookDelta(dx, dy) {
59
+ this.camera.alpha -= dx * 0.0055;
60
+ this.camera.beta += dy * 0.0042;
61
+ this.clampBeta();
62
+ }
63
+ onPointerDown = (e) => {
64
+ if (e.button !== 0 && e.button !== 2)
65
+ return;
66
+ this.dragging = true;
67
+ this.pointerId = e.pointerId;
68
+ this.lastX = e.clientX;
69
+ this.lastY = e.clientY;
70
+ try {
71
+ e.target?.setPointerCapture?.(e.pointerId);
72
+ }
73
+ catch {
74
+ // ignore — window-level move/up still drives look
75
+ }
76
+ };
77
+ onPointerMove = (e) => {
78
+ if (!this.dragging || e.pointerId !== this.pointerId)
79
+ return;
80
+ this.addLookDelta(e.clientX - this.lastX, e.clientY - this.lastY);
81
+ this.lastX = e.clientX;
82
+ this.lastY = e.clientY;
83
+ };
84
+ onPointerUp = (e) => {
85
+ if (e.pointerId !== this.pointerId)
86
+ return;
87
+ this.dragging = false;
88
+ this.pointerId = -1;
89
+ };
90
+ onWheel = (e) => {
91
+ e.preventDefault();
92
+ const min = Math.max(this.minRadius(), 3.2);
93
+ this.wantedRadius = Math.min(16, Math.max(min, this.wantedRadius + Math.sign(e.deltaY) * 0.7));
94
+ };
95
+ clampBeta() {
96
+ const lo = this.camera.lowerBetaLimit ?? 0.28;
97
+ const hi = this.camera.upperBetaLimit ?? 1.72;
98
+ let beta = Math.min(hi, Math.max(lo, this.camera.beta));
99
+ // Soft floor: don't tip so far under the horizon that the lens clips underground.
100
+ const radius = Math.max(this.camera.radius, this.minRadius());
101
+ const minCos = (MIN_CAMERA_Y - this.target.y) / radius;
102
+ if (minCos > -1 && minCos < 1) {
103
+ const maxBeta = Math.acos(minCos);
104
+ if (beta > maxBeta)
105
+ beta = maxBeta;
106
+ }
107
+ this.camera.beta = beta;
108
+ }
109
+ update(playerPosition, dt, ignoreMeshes) {
110
+ if (this.lookX || this.lookY) {
111
+ this.camera.alpha -= this.lookX * 2.4 * dt;
112
+ this.camera.beta += this.lookY * 1.8 * dt;
113
+ this.clampBeta();
114
+ }
115
+ this.desiredTarget.set(playerPosition.x, playerPosition.y + 1.65, playerPosition.z);
116
+ const follow = 1 - Math.exp(-8 * dt);
117
+ this.target.x += (this.desiredTarget.x - this.target.x) * follow;
118
+ this.target.y += (this.desiredTarget.y - this.target.y) * follow;
119
+ this.target.z += (this.desiredTarget.z - this.target.z) * follow;
120
+ this.camera.setTarget(this.target);
121
+ this.ignoreSet.clear();
122
+ for (let i = 0; i < ignoreMeshes.length; i++)
123
+ this.ignoreSet.add(ignoreMeshes[i]);
124
+ this.camera.position.subtractToRef(this.target, this.camDir);
125
+ if (this.camDir.lengthSquared() < 0.01)
126
+ return;
127
+ const desiredLen = this.wantedRadius;
128
+ this.camDir.normalize();
129
+ this.occlusionRay.origin.copyFrom(this.target);
130
+ this.occlusionRay.direction.copyFrom(this.camDir);
131
+ this.occlusionRay.length = desiredLen;
132
+ const skip = this.ignoreSet;
133
+ const hit = this.scene.pickWithRay(this.occlusionRay, (mesh) => {
134
+ if (!mesh || skip.has(mesh) || !mesh.checkCollisions)
135
+ return false;
136
+ if (mesh.name.startsWith('local-player') || mesh.name.includes('nametag') || mesh.name.includes('-sign')) {
137
+ return false;
138
+ }
139
+ if (mesh.name.includes('-rail-'))
140
+ return false;
141
+ if (mesh.name === 'ground' ||
142
+ mesh.name === 'grass-ground' ||
143
+ mesh.name === 'spawn-plaza' ||
144
+ mesh.name.startsWith('path-') ||
145
+ mesh.name.includes('plaza')) {
146
+ return false;
147
+ }
148
+ return mesh.isPickable;
149
+ });
150
+ const minR = this.minRadius();
151
+ const blocked = hit?.hit && typeof hit.distance === 'number' && hit.distance < desiredLen;
152
+ let goal = desiredLen;
153
+ if (blocked && hit?.distance != null) {
154
+ goal = Math.max(minR, hit.distance - OCCLUSION_CLEARANCE);
155
+ }
156
+ if (blocked) {
157
+ const zoom = 1 - Math.exp(-18 * dt);
158
+ this.camera.radius += (goal - this.camera.radius) * zoom;
159
+ }
160
+ else {
161
+ // Snap to the wanted orbit when the view is clear — avoids stuck far cameras
162
+ // after limits/tuning changes (lerp alone could fight other writers).
163
+ this.camera.radius = desiredLen;
164
+ }
165
+ if (this.camera.radius < minR)
166
+ this.camera.radius = minR;
167
+ this.clampBeta();
168
+ }
169
+ onContextMenu = (e) => {
170
+ e.preventDefault();
171
+ };
172
+ dispose(canvas) {
173
+ canvas.removeEventListener('pointerdown', this.onPointerDown);
174
+ window.removeEventListener('pointermove', this.onPointerMove);
175
+ window.removeEventListener('pointerup', this.onPointerUp);
176
+ window.removeEventListener('pointercancel', this.onPointerUp);
177
+ canvas.removeEventListener('wheel', this.onWheel);
178
+ canvas.removeEventListener('contextmenu', this.onContextMenu);
179
+ }
180
+ }
181
+ //# sourceMappingURL=third-person-camera.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"third-person-camera.js","sourceRoot":"","sources":["../src/third-person-camera.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,164 @@
1
+ import type { SdkInitPayload, SdkLobbyAvatar, SdkUser, PlatformInitMessage } from './platform-types';
2
+ export type { SdkInitPayload, SdkLobbyAvatar, SdkUser, PlatformInitMessage };
3
+ export interface Vector3 {
4
+ x: number;
5
+ y: number;
6
+ z: number;
7
+ }
8
+ export interface LobbyThemeConfig {
9
+ groundColor?: string;
10
+ skyColor?: string;
11
+ ambientIntensity?: number;
12
+ fogEnabled?: boolean;
13
+ fogDensity?: number;
14
+ }
15
+ export interface LobbySpawnConfig {
16
+ spawnPoint?: Vector3;
17
+ spawnPoints?: Vector3[];
18
+ /** Ring radius when auto-spreading players around `spawnPoint`. */
19
+ spawnSlotRadius?: number;
20
+ /** Number of spawn slots on the ring. */
21
+ spawnSlotCount?: number;
22
+ }
23
+ export interface PlatformLobbyConfig extends LobbyThemeConfig, LobbySpawnConfig {
24
+ groundSize?: number;
25
+ cameraDistance?: number;
26
+ cameraHeight?: number;
27
+ playerSpeed?: number;
28
+ runMultiplier?: number;
29
+ enableMultiplayer?: boolean;
30
+ /** Default true. Live room chat overlay; messages are not stored. */
31
+ enableChat?: boolean;
32
+ /** Default true. WebRTC voice chat (friends / all lobby modes). */
33
+ enableVoice?: boolean;
34
+ /** Default true when multiplayer is on. Join/leave toasts. */
35
+ enablePresenceUi?: boolean;
36
+ /** Default true when multiplayer is on. Disconnect overlay. */
37
+ enableConnectionUi?: boolean;
38
+ /** Default true. Mobile portrait → landscape prompt. */
39
+ enableOrientationUi?: boolean;
40
+ /** UI copy locale for built-in overlays (default `fa`). */
41
+ locale?: import('./lobby-ui-i18n').LobbyUiLocale;
42
+ /** Partial overrides for built-in UI strings. */
43
+ uiMessages?: Partial<import('./lobby-ui-i18n').LobbyUiMessages>;
44
+ /** `auto` picks a tier from device hints; default `auto`. */
45
+ quality?: import('./quality').LobbyQualityLevel | 'auto';
46
+ /**
47
+ * Shared base avatar catalog (≈2–10 GLBs). Customization (tint/face/accessories)
48
+ * is applied per AvatarInstance; do not register one GLB per cosmetic combo.
49
+ */
50
+ avatarBases?: Array<{
51
+ id: string;
52
+ glbUrl: string;
53
+ }>;
54
+ /**
55
+ * After scene start, asynchronously warm the GLB container cache.
56
+ * - omitted / `true`: preload all `avatarBases`
57
+ * - `false`: skip auto-preload (call `lobby.preloadAvatarBases` manually)
58
+ * - `string[]`: preload only these base ids
59
+ */
60
+ preloadAvatarBases?: boolean | string[];
61
+ }
62
+ export interface PlatformLobbyCreateOptions {
63
+ canvas: HTMLCanvasElement;
64
+ roomId: string;
65
+ /** Join this exact room only (friend invite); no capacity spillover. */
66
+ strictRoom?: boolean;
67
+ platformInit: SdkInitPayload | PlatformInitMessage;
68
+ config?: PlatformLobbyConfig;
69
+ wsUrl?: string;
70
+ }
71
+ export interface PlatformLobbyDevOptions {
72
+ canvas: HTMLCanvasElement;
73
+ roomId?: string;
74
+ mockUser?: Partial<SdkUser>;
75
+ mockAvatar?: Partial<SdkLobbyAvatar>;
76
+ config?: PlatformLobbyConfig;
77
+ wsUrl?: string;
78
+ sessionToken?: string;
79
+ }
80
+ export interface LobbyZoneBounds {
81
+ min: Vector3;
82
+ max: Vector3;
83
+ }
84
+ export interface LobbyZoneOptions {
85
+ id: string;
86
+ bounds: LobbyZoneBounds;
87
+ onEnter?: (playerId: string) => void;
88
+ onExit?: (playerId: string) => void;
89
+ }
90
+ export interface LobbyPortalOptions {
91
+ id: string;
92
+ position: Vector3;
93
+ radius?: number;
94
+ label?: string;
95
+ /** Hint for the game (match key, catalog slug, etc.). The SDK never navigates on this. */
96
+ toGameSlug?: string;
97
+ /** Hint for the game's own scene switch. The SDK never changes scenes. */
98
+ toScene?: string;
99
+ /** Game-owned. Called when the local player enters the portal. */
100
+ onTrigger?: () => void;
101
+ }
102
+ export interface LobbyPlugin {
103
+ name: string;
104
+ setup: (lobby: import('./platform-lobby').PlatformLobby) => void | Promise<void>;
105
+ }
106
+ export type LobbyEventMap = {
107
+ ready: void;
108
+ destroyed: void;
109
+ playerJoined: {
110
+ userId: string;
111
+ displayName: string;
112
+ username?: string;
113
+ };
114
+ playerLeft: {
115
+ userId: string;
116
+ displayName?: string;
117
+ username?: string;
118
+ };
119
+ zoneEnter: {
120
+ zoneId: string;
121
+ playerId: string;
122
+ };
123
+ zoneExit: {
124
+ zoneId: string;
125
+ playerId: string;
126
+ };
127
+ portalTrigger: {
128
+ portalId: string;
129
+ toGameSlug?: string;
130
+ toScene?: string;
131
+ };
132
+ connected: void;
133
+ disconnected: void;
134
+ reconnecting: {
135
+ attempt: number;
136
+ };
137
+ reconnectFailed: void;
138
+ error: {
139
+ message: string;
140
+ code?: string;
141
+ };
142
+ /** Live room chat. Not stored. */
143
+ chat: {
144
+ userId: string;
145
+ username?: string;
146
+ displayName: string;
147
+ text: string;
148
+ at: number;
149
+ };
150
+ /**
151
+ * Ephemeral game data bus (`lobby:data`). Never shown in chat UI.
152
+ * Filter by `channel` (e.g. `fc.pad-room`, `mygame.queue`).
153
+ */
154
+ data: {
155
+ userId: string;
156
+ username?: string;
157
+ displayName?: string;
158
+ channel: string;
159
+ payload: string;
160
+ at: number;
161
+ };
162
+ };
163
+ export type LobbyEventName = keyof LobbyEventMap;
164
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,78 @@
1
+ import type { LobbyVoiceMode, LobbyVoicePeerState, RtcIceCandidate, RtcSessionDescription } from './protocol';
2
+ /** Default mesh cap — keep in sync with server LOBBY_VOICE_PEER_CAP (roadmap 3.4). */
3
+ export declare const DEFAULT_VOICE_PEER_CAP = 6;
4
+ export type VoicePosition = {
5
+ x: number;
6
+ y: number;
7
+ z: number;
8
+ };
9
+ export type VoiceSignaling = {
10
+ sendJoin(mode: LobbyVoiceMode): void;
11
+ sendLeave(): void;
12
+ sendMute(muted: boolean): void;
13
+ sendOffer(toUserId: string, sdp: RtcSessionDescription): void;
14
+ sendAnswer(toUserId: string, sdp: RtcSessionDescription): void;
15
+ sendIce(toUserId: string, candidate: RtcIceCandidate): void;
16
+ };
17
+ export type VoiceChatState = {
18
+ active: boolean;
19
+ mode: LobbyVoiceMode;
20
+ muted: boolean;
21
+ peerCount: number;
22
+ };
23
+ export type VoiceChatListener = (state: VoiceChatState) => void;
24
+ export declare class LobbyVoiceChat {
25
+ private readonly signaling;
26
+ private localStream;
27
+ private readonly peers;
28
+ private readonly remoteAudio;
29
+ private readonly voicePeers;
30
+ /** Peers we created an offer toward (vs inbound-only). */
31
+ private readonly offerInitiated;
32
+ private active;
33
+ private mode;
34
+ private micMuted;
35
+ private selfUserId;
36
+ private friendIds;
37
+ private readonly listeners;
38
+ private disposed;
39
+ private peerCap;
40
+ private getPosition;
41
+ private lastMeshRefreshMs;
42
+ constructor(signaling: VoiceSignaling);
43
+ onStateChange(listener: VoiceChatListener): () => boolean;
44
+ setContext(selfUserId: string, friendUserIds: string[]): void;
45
+ /** Optional world positions for nearest-N mesh selection. */
46
+ setPositionProvider(fn: (userId: string) => VoicePosition | null | undefined): void;
47
+ setPeerCap(cap: number): void;
48
+ getState(): VoiceChatState;
49
+ /**
50
+ * Re-evaluate nearest peers (e.g. after movement). Throttled to ~2Hz by default.
51
+ */
52
+ refreshMesh(force?: boolean): void;
53
+ enable(mode: LobbyVoiceMode): Promise<void>;
54
+ disable(): Promise<void>;
55
+ setMode(mode: LobbyVoiceMode): Promise<void>;
56
+ setMicMuted(muted: boolean): void;
57
+ toggleMicMuted(): void;
58
+ handleVoiceState(peers: LobbyVoicePeerState[], friendUserIds: string[]): void;
59
+ handleVoiceJoined(peer: LobbyVoicePeerState): void;
60
+ handleVoiceLeft(userId: string): void;
61
+ handleVoiceMute(userId: string, muted: boolean): void;
62
+ handleOffer(fromUserId: string, sdp: RtcSessionDescription): Promise<void>;
63
+ handleAnswer(fromUserId: string, sdp: RtcSessionDescription): Promise<void>;
64
+ handleIce(fromUserId: string, candidate: RtcIceCandidate): Promise<void>;
65
+ dispose(): void;
66
+ private syncPeerConnections;
67
+ private canConnectTo;
68
+ private nearestEligiblePeerIds;
69
+ private createOffer;
70
+ private ensurePeer;
71
+ private closePeer;
72
+ private teardownPeers;
73
+ private stopLocalStream;
74
+ private applyMicTrackState;
75
+ private snapshot;
76
+ private emitState;
77
+ }
78
+ //# sourceMappingURL=voice-chat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"voice-chat.d.ts","sourceRoot":"","sources":["../src/voice-chat.ts"],"names":[],"mappings":"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"}