@directivegames/genesys.sdk 3.2.2 → 3.2.4

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 (82) hide show
  1. package/README.md +60 -60
  2. package/dist/src/core/cli.js +22 -22
  3. package/dist/src/templates/scripts/genesys/genesys-mcp.js +25 -25
  4. package/dist/src/templates/scripts/genesys/mcp/editor-functions.js +4 -4
  5. package/dist/src/templates/src/templates/vehicle/src/ui-hints.js +30 -30
  6. package/package.json +176 -176
  7. package/scripts/post-install.ts +143 -143
  8. package/src/asset-pack/.gitattributes +88 -88
  9. package/src/asset-pack/eslint.config.js +45 -45
  10. package/src/asset-pack/gitignore +11 -11
  11. package/src/asset-pack/scripts/postinstall.ts +81 -81
  12. package/src/asset-pack/tsconfig.json +33 -33
  13. package/src/templates/.cursor/mcp.json +20 -20
  14. package/src/templates/.cursorignore +2 -2
  15. package/src/templates/.gitattributes +88 -88
  16. package/src/templates/.vscode/settings.json +6 -6
  17. package/src/templates/AGENTS.md +86 -86
  18. package/src/templates/README.md +24 -24
  19. package/src/templates/eslint.config.js +45 -45
  20. package/src/templates/gitignore +11 -11
  21. package/src/templates/index.html +34 -34
  22. package/src/templates/pnpm-lock.yaml +3676 -3676
  23. package/src/templates/scripts/genesys/build-project.ts +51 -51
  24. package/src/templates/scripts/genesys/calc-bounding-box.ts +272 -272
  25. package/src/templates/scripts/genesys/common.ts +46 -46
  26. package/src/templates/scripts/genesys/const.ts +9 -9
  27. package/src/templates/scripts/genesys/dev/dump-default-scene.ts +11 -11
  28. package/src/templates/scripts/genesys/dev/generate-manifest.ts +146 -146
  29. package/src/templates/scripts/genesys/dev/launcher.ts +46 -46
  30. package/src/templates/scripts/genesys/dev/storage-provider.ts +229 -229
  31. package/src/templates/scripts/genesys/dev/update-template-scenes.ts +84 -84
  32. package/src/templates/scripts/genesys/doc-server.ts +16 -16
  33. package/src/templates/scripts/genesys/genesys-mcp.ts +526 -526
  34. package/src/templates/scripts/genesys/mcp/doc-tools.ts +86 -86
  35. package/src/templates/scripts/genesys/mcp/editor-functions.ts +151 -151
  36. package/src/templates/scripts/genesys/mcp/editor-tools.ts +73 -73
  37. package/src/templates/scripts/genesys/mcp/get-scene-state.ts +35 -35
  38. package/src/templates/scripts/genesys/mcp/run-subprocess.ts +30 -30
  39. package/src/templates/scripts/genesys/mcp/search-actors.ts +858 -858
  40. package/src/templates/scripts/genesys/mcp/search-assets.ts +380 -380
  41. package/src/templates/scripts/genesys/mcp/utils.ts +281 -281
  42. package/src/templates/scripts/genesys/misc.ts +42 -42
  43. package/src/templates/scripts/genesys/mock.ts +6 -6
  44. package/src/templates/scripts/genesys/place-actors.ts +179 -179
  45. package/src/templates/scripts/genesys/post-install.ts +30 -30
  46. package/src/templates/scripts/genesys/prefab.schema.json +84 -84
  47. package/src/templates/scripts/genesys/remove-engine-comments.ts +134 -134
  48. package/src/templates/scripts/genesys/run-mcp-inspector.bat +4 -4
  49. package/src/templates/scripts/genesys/storageProvider.ts +182 -182
  50. package/src/templates/scripts/genesys/validate-prefabs.ts +138 -138
  51. package/src/templates/src/index.ts +22 -22
  52. package/src/templates/src/templates/firstPerson/assets/default.genesys-scene +165 -165
  53. package/src/templates/src/templates/firstPerson/src/game.ts +39 -39
  54. package/src/templates/src/templates/firstPerson/src/player.ts +63 -63
  55. package/src/templates/src/templates/fps/assets/default.genesys-scene +9459 -9459
  56. package/src/templates/src/templates/fps/src/game.ts +39 -39
  57. package/src/templates/src/templates/fps/src/player.ts +69 -69
  58. package/src/templates/src/templates/fps/src/weapon.ts +54 -54
  59. package/src/templates/src/templates/freeCamera/assets/default.genesys-scene +165 -165
  60. package/src/templates/src/templates/freeCamera/src/game.ts +39 -39
  61. package/src/templates/src/templates/freeCamera/src/player.ts +45 -45
  62. package/src/templates/src/templates/sideScroller/assets/default.genesys-scene +121 -121
  63. package/src/templates/src/templates/sideScroller/src/const.ts +45 -45
  64. package/src/templates/src/templates/sideScroller/src/game.ts +122 -122
  65. package/src/templates/src/templates/sideScroller/src/level-generator.ts +361 -361
  66. package/src/templates/src/templates/sideScroller/src/player.ts +125 -125
  67. package/src/templates/src/templates/thirdPerson/assets/default.genesys-scene +165 -165
  68. package/src/templates/src/templates/thirdPerson/src/game.ts +39 -39
  69. package/src/templates/src/templates/thirdPerson/src/player.ts +61 -61
  70. package/src/templates/src/templates/vehicle/assets/default.genesys-scene +225 -225
  71. package/src/templates/src/templates/vehicle/src/base-vehicle.ts +145 -145
  72. package/src/templates/src/templates/vehicle/src/game.ts +43 -43
  73. package/src/templates/src/templates/vehicle/src/mesh-vehicle.ts +191 -191
  74. package/src/templates/src/templates/vehicle/src/player.ts +109 -109
  75. package/src/templates/src/templates/vehicle/src/primitive-vehicle.ts +266 -266
  76. package/src/templates/src/templates/vehicle/src/ui-hints.ts +101 -101
  77. package/src/templates/src/templates/vr-game/assets/default.genesys-scene +246 -246
  78. package/src/templates/src/templates/vr-game/src/auto-imports.ts +1 -1
  79. package/src/templates/src/templates/vr-game/src/game.ts +66 -66
  80. package/src/templates/src/templates/vr-game/src/sample-vr-actor.ts +26 -26
  81. package/src/templates/tsconfig.json +34 -34
  82. package/src/templates/vite.config.ts +52 -52
@@ -1,61 +1,61 @@
1
- import * as ENGINE from 'genesys.js';
2
- import * as THREE from 'three';
3
-
4
-
5
- /**
6
- * A third person player class.
7
- *
8
- * Key points:
9
- * - No need to provide movementComponent and camera, they are created internally
10
- * - The pawn is set to be transient so it's never saved in the level
11
- * - The directional light follows the player for consistent shadows
12
- *
13
- */
14
- @ENGINE.GameClass()
15
- export class ThirdPersonPlayer extends ENGINE.ThirdPersonCharacterPawn {
16
- // Omit all the options that are created internally
17
- constructor(options: Omit<ENGINE.ThirdPersonCharacterPawnOptions,
18
- 'rootComponent' | 'movementComponent' | 'camera' | 'modelUrl' | 'configUrl' | 'meshPosition' | 'meshRotation' | 'meshScale'>) {
19
- // simple camera component - contains a perspective camera by default
20
- const camera = new THREE.PerspectiveCamera(ENGINE.CAMERA_FOV, 1, 0.1, 1000);
21
- // set camera position for third person view
22
- camera.position.set(0, ENGINE.CHARACTER_HEIGHT * 1.3, ENGINE.CHARACTER_HEIGHT * 2);
23
- camera.lookAt(0, 0, 0);
24
-
25
- // use capsule root component for collision
26
- const rootComponent = new ENGINE.MeshComponent({
27
- geometry: ENGINE.GameBuilder.createDefaultPawnCapsuleGeometry(),
28
- material: new THREE.MeshStandardMaterial({ color: ENGINE.Color.YELLOW, visible: false, transparent: true, opacity: 0.5 }),
29
- physicsOptions: {
30
- enabled: true,
31
- // KinematicVelocityBased is required to use the physics character controller
32
- motionType: ENGINE.PhysicsMotionType.KinematicVelocityBased,
33
- collisionProfile: ENGINE.DefaultCollisionProfile.Character,
34
- },
35
- });
36
-
37
- // use third person movement mechanics
38
- const movementComponent = new ENGINE.CharacterMovementComponent({
39
- ...ENGINE.CharacterMovementComponent.DEFAULT_OPTIONS,
40
- movementType: ENGINE.CharacterMovementType.ThirdPerson,
41
- });
42
-
43
- // construct the pawn
44
- super({
45
- ...options,
46
- rootComponent,
47
- movementComponent,
48
- camera,
49
- // make sure the directional light follows the player for consistent shadows
50
- enableDirectionalLightFollowing: true,
51
- modelUrl: '@engine/assets/character/mannequinG.glb',
52
- configUrl: '@engine/assets/character/config/mannequin-anim.json',
53
- meshPosition: new THREE.Vector3(0, -ENGINE.CHARACTER_HEIGHT / 2, 0),
54
- meshRotation: new THREE.Euler(0, Math.PI, 0),
55
- meshScale: new THREE.Vector3(1, 1, 1),
56
- });
57
-
58
- // set the pawn to be transient so it's never saved in the level
59
- this.setTransient(true);
60
- }
61
- }
1
+ import * as ENGINE from 'genesys.js';
2
+ import * as THREE from 'three';
3
+
4
+
5
+ /**
6
+ * A third person player class.
7
+ *
8
+ * Key points:
9
+ * - No need to provide movementComponent and camera, they are created internally
10
+ * - The pawn is set to be transient so it's never saved in the level
11
+ * - The directional light follows the player for consistent shadows
12
+ *
13
+ */
14
+ @ENGINE.GameClass()
15
+ export class ThirdPersonPlayer extends ENGINE.ThirdPersonCharacterPawn {
16
+ // Omit all the options that are created internally
17
+ constructor(options: Omit<ENGINE.ThirdPersonCharacterPawnOptions,
18
+ 'rootComponent' | 'movementComponent' | 'camera' | 'modelUrl' | 'configUrl' | 'meshPosition' | 'meshRotation' | 'meshScale'>) {
19
+ // simple camera component - contains a perspective camera by default
20
+ const camera = new THREE.PerspectiveCamera(ENGINE.CAMERA_FOV, 1, 0.1, 1000);
21
+ // set camera position for third person view
22
+ camera.position.set(0, ENGINE.CHARACTER_HEIGHT * 1.3, ENGINE.CHARACTER_HEIGHT * 2);
23
+ camera.lookAt(0, 0, 0);
24
+
25
+ // use capsule root component for collision
26
+ const rootComponent = new ENGINE.MeshComponent({
27
+ geometry: ENGINE.GameBuilder.createDefaultPawnCapsuleGeometry(),
28
+ material: new THREE.MeshStandardMaterial({ color: ENGINE.Color.YELLOW, visible: false, transparent: true, opacity: 0.5 }),
29
+ physicsOptions: {
30
+ enabled: true,
31
+ // KinematicVelocityBased is required to use the physics character controller
32
+ motionType: ENGINE.PhysicsMotionType.KinematicVelocityBased,
33
+ collisionProfile: ENGINE.DefaultCollisionProfile.Character,
34
+ },
35
+ });
36
+
37
+ // use third person movement mechanics
38
+ const movementComponent = new ENGINE.CharacterMovementComponent({
39
+ ...ENGINE.CharacterMovementComponent.DEFAULT_OPTIONS,
40
+ movementType: ENGINE.CharacterMovementType.ThirdPerson,
41
+ });
42
+
43
+ // construct the pawn
44
+ super({
45
+ ...options,
46
+ rootComponent,
47
+ movementComponent,
48
+ camera,
49
+ // make sure the directional light follows the player for consistent shadows
50
+ enableDirectionalLightFollowing: true,
51
+ modelUrl: '@engine/assets/character/mannequinG.glb',
52
+ configUrl: '@engine/assets/character/config/mannequin-anim.json',
53
+ meshPosition: new THREE.Vector3(0, -ENGINE.CHARACTER_HEIGHT / 2, 0),
54
+ meshRotation: new THREE.Euler(0, Math.PI, 0),
55
+ meshScale: new THREE.Vector3(1, 1, 1),
56
+ });
57
+
58
+ // set the pawn to be transient so it's never saved in the level
59
+ this.setTransient(true);
60
+ }
61
+ }
@@ -1,226 +1,226 @@
1
- {
2
- "$version": 0,
3
- "class": "ENGINE.World",
4
- "uuid": "c0ae85792bc3b946",
5
- "ctor": {
6
- "backgroundColor": 3026478,
7
- "navigationOptions": {
8
- "engine": "recast-navigation",
9
- "debug": false,
10
- "generateOnStartUp": false
11
- },
12
- "physicsOptions": {
13
- "gravity": [
14
- 0,
15
- -9.81,
16
- 0,
17
- "v"
18
- ],
19
- "engine": "rapier"
20
- },
21
- "useManifold": true
22
- },
23
- "actors": [
24
- {
25
- "uuid": "9a86d389088b361c",
26
- "class": "ENGINE.Actor",
27
- "properties": {
28
- "editorData": {
29
- "displayName": "Directional Light",
30
- "hidden": false
31
- }
32
- },
33
- "ctor": {
34
- "rootComponent": {
35
- "class": "ENGINE.DirectionalLightComponent",
36
- "uuid": "cfe05433-9edc-4dfe-a535-c71f33e92d78",
37
- "ctor": {
38
- "color": 16777215,
39
- "intensity": 1,
40
- "castShadow": true,
41
- "shadowMapSize": 2048,
42
- "shadowBias": 0,
43
- "shadowNormalBias": 0,
44
- "shadowNear": 0.1,
45
- "shadowFar": 100
46
- },
47
- "properties": {
48
- "position": [
49
- 10,
50
- 50,
51
- -10,
52
- "v"
53
- ],
54
- "castShadow": true
55
- }
56
- }
57
- }
58
- },
59
- {
60
- "uuid": "9d428f2a16e5374a",
61
- "class": "ENGINE.Actor",
62
- "properties": {
63
- "editorData": {
64
- "displayName": "Ground",
65
- "hidden": false
66
- }
67
- },
68
- "ctor": {
69
- "rootComponent": {
70
- "class": "ENGINE.MeshComponent",
71
- "uuid": "71caea24-62d7-4e45-a76e-4c7519de2c3c",
72
- "ctor": {
73
- "geometry": {
74
- "class": "THREE.BoxGeometry",
75
- "ctor": [
76
- 500,
77
- 0.1,
78
- 500
79
- ]
80
- },
81
- "material": {
82
- "@external": "DefaultMaterial"
83
- },
84
- "uvScaleTilesPerUnit": 0.2,
85
- "physicsOptions": {
86
- "enabled": true,
87
- "motionType": "static",
88
- "collisionProfile": "BlockAll"
89
- }
90
- },
91
- "properties": {
92
- "position": [
93
- 0,
94
- -0.9,
95
- 0,
96
- "v"
97
- ],
98
- "receiveShadow": true
99
- }
100
- }
101
- }
102
- },
103
- {
104
- "uuid": "b87cbc5e60a2e54c",
105
- "class": "ENGINE.PlayerStart",
106
- "properties": {
107
- "editorData": {
108
- "displayName": "Player Start",
109
- "hidden": false
110
- }
111
- },
112
- "ctor": {
113
- "rootComponent": {
114
- "class": "ENGINE.SceneComponent",
115
- "uuid": "b4d5f8f7-2512-45e1-9157-c7ff6772402d",
116
- "ctor": {},
117
- "properties": {
118
- "position": [
119
- 0,
120
- 0.9,
121
- 0,
122
- "v"
123
- ]
124
- }
125
- }
126
- }
127
- },
128
- {
129
- "uuid": "0ba1f4677e8370d1",
130
- "class": "ENGINE.Actor",
131
- "properties": {
132
- "editorData": {
133
- "displayName": "Skybox",
134
- "hidden": false
135
- }
136
- },
137
- "ctor": {
138
- "rootComponent": {
139
- "class": "ENGINE.SceneComponent",
140
- "uuid": "195e88df-73ff-4f4b-82ae-7fb58671463d",
141
- "ctor": {},
142
- "properties": {},
143
- "children": [
144
- {
145
- "class": "ENGINE.SkyboxComponent",
146
- "uuid": "15d8d439-a7dd-49a1-800e-f1f893812293",
147
- "ctor": {
148
- "textureUrl": "@engine/assets/textures/skybox/citrus_orchard_road_puresky_2k.hdr",
149
- "width": 2048,
150
- "height": 1024,
151
- "bottomColor": "#E6F3FF",
152
- "middleColor": "#4A90E2",
153
- "topColor": "#0F1B3C",
154
- "envMapIntensity": 1
155
- },
156
- "properties": {}
157
- }
158
- ]
159
- }
160
- }
161
- },
162
- {
163
- "uuid": "f527684a997f6384",
164
- "class": "GAME.MeshVehicle",
165
- "properties": {
166
- "editorData": {
167
- "hidden": false
168
- }
169
- },
170
- "ctor": {
171
- "enableDirectionalLightFollowing": true,
172
- "position": [
173
- -4.2,
174
- 2.5,
175
- -8.2,
176
- "v"
177
- ],
178
- "rotation": [
179
- 0,
180
- 0,
181
- 0,
182
- "e"
183
- ],
184
- "scale": [
185
- 1,
186
- 1,
187
- 1,
188
- "v"
189
- ]
190
- }
191
- },
192
- {
193
- "uuid": "2aa7b313363fa7b2",
194
- "class": "GAME.PrimitiveVehicle",
195
- "properties": {
196
- "editorData": {
197
- "hidden": false
198
- }
199
- },
200
- "ctor": {
201
- "enableDirectionalLightFollowing": true,
202
- "position": [
203
- 3.1,
204
- 2.3,
205
- -7.7,
206
- "v"
207
- ],
208
- "rotation": [
209
- 0,
210
- 0,
211
- 0,
212
- "e"
213
- ],
214
- "scale": [
215
- 1,
216
- 1,
217
- 1,
218
- "v"
219
- ]
220
- }
221
- }
222
- ],
223
- "properties": {
224
- "editorData": {}
225
- }
1
+ {
2
+ "$version": 0,
3
+ "class": "ENGINE.World",
4
+ "uuid": "c0ae85792bc3b946",
5
+ "ctor": {
6
+ "backgroundColor": 3026478,
7
+ "navigationOptions": {
8
+ "engine": "recast-navigation",
9
+ "debug": false,
10
+ "generateOnStartUp": false
11
+ },
12
+ "physicsOptions": {
13
+ "gravity": [
14
+ 0,
15
+ -9.81,
16
+ 0,
17
+ "v"
18
+ ],
19
+ "engine": "rapier"
20
+ },
21
+ "useManifold": true
22
+ },
23
+ "actors": [
24
+ {
25
+ "uuid": "9a86d389088b361c",
26
+ "class": "ENGINE.Actor",
27
+ "properties": {
28
+ "editorData": {
29
+ "displayName": "Directional Light",
30
+ "hidden": false
31
+ }
32
+ },
33
+ "ctor": {
34
+ "rootComponent": {
35
+ "class": "ENGINE.DirectionalLightComponent",
36
+ "uuid": "cfe05433-9edc-4dfe-a535-c71f33e92d78",
37
+ "ctor": {
38
+ "color": 16777215,
39
+ "intensity": 1,
40
+ "castShadow": true,
41
+ "shadowMapSize": 2048,
42
+ "shadowBias": 0,
43
+ "shadowNormalBias": 0,
44
+ "shadowNear": 0.1,
45
+ "shadowFar": 100
46
+ },
47
+ "properties": {
48
+ "position": [
49
+ 10,
50
+ 50,
51
+ -10,
52
+ "v"
53
+ ],
54
+ "castShadow": true
55
+ }
56
+ }
57
+ }
58
+ },
59
+ {
60
+ "uuid": "9d428f2a16e5374a",
61
+ "class": "ENGINE.Actor",
62
+ "properties": {
63
+ "editorData": {
64
+ "displayName": "Ground",
65
+ "hidden": false
66
+ }
67
+ },
68
+ "ctor": {
69
+ "rootComponent": {
70
+ "class": "ENGINE.MeshComponent",
71
+ "uuid": "71caea24-62d7-4e45-a76e-4c7519de2c3c",
72
+ "ctor": {
73
+ "geometry": {
74
+ "class": "THREE.BoxGeometry",
75
+ "ctor": [
76
+ 500,
77
+ 0.1,
78
+ 500
79
+ ]
80
+ },
81
+ "material": {
82
+ "@external": "DefaultMaterial"
83
+ },
84
+ "uvScaleTilesPerUnit": 0.2,
85
+ "physicsOptions": {
86
+ "enabled": true,
87
+ "motionType": "static",
88
+ "collisionProfile": "BlockAll"
89
+ }
90
+ },
91
+ "properties": {
92
+ "position": [
93
+ 0,
94
+ -0.9,
95
+ 0,
96
+ "v"
97
+ ],
98
+ "receiveShadow": true
99
+ }
100
+ }
101
+ }
102
+ },
103
+ {
104
+ "uuid": "b87cbc5e60a2e54c",
105
+ "class": "ENGINE.PlayerStart",
106
+ "properties": {
107
+ "editorData": {
108
+ "displayName": "Player Start",
109
+ "hidden": false
110
+ }
111
+ },
112
+ "ctor": {
113
+ "rootComponent": {
114
+ "class": "ENGINE.SceneComponent",
115
+ "uuid": "b4d5f8f7-2512-45e1-9157-c7ff6772402d",
116
+ "ctor": {},
117
+ "properties": {
118
+ "position": [
119
+ 0,
120
+ 0.9,
121
+ 0,
122
+ "v"
123
+ ]
124
+ }
125
+ }
126
+ }
127
+ },
128
+ {
129
+ "uuid": "0ba1f4677e8370d1",
130
+ "class": "ENGINE.Actor",
131
+ "properties": {
132
+ "editorData": {
133
+ "displayName": "Skybox",
134
+ "hidden": false
135
+ }
136
+ },
137
+ "ctor": {
138
+ "rootComponent": {
139
+ "class": "ENGINE.SceneComponent",
140
+ "uuid": "195e88df-73ff-4f4b-82ae-7fb58671463d",
141
+ "ctor": {},
142
+ "properties": {},
143
+ "children": [
144
+ {
145
+ "class": "ENGINE.SkyboxComponent",
146
+ "uuid": "15d8d439-a7dd-49a1-800e-f1f893812293",
147
+ "ctor": {
148
+ "textureUrl": "@engine/assets/textures/skybox/citrus_orchard_road_puresky_2k.hdr",
149
+ "width": 2048,
150
+ "height": 1024,
151
+ "bottomColor": "#E6F3FF",
152
+ "middleColor": "#4A90E2",
153
+ "topColor": "#0F1B3C",
154
+ "envMapIntensity": 1
155
+ },
156
+ "properties": {}
157
+ }
158
+ ]
159
+ }
160
+ }
161
+ },
162
+ {
163
+ "uuid": "f527684a997f6384",
164
+ "class": "GAME.MeshVehicle",
165
+ "properties": {
166
+ "editorData": {
167
+ "hidden": false
168
+ }
169
+ },
170
+ "ctor": {
171
+ "enableDirectionalLightFollowing": true,
172
+ "position": [
173
+ -4.2,
174
+ 2.5,
175
+ -8.2,
176
+ "v"
177
+ ],
178
+ "rotation": [
179
+ 0,
180
+ 0,
181
+ 0,
182
+ "e"
183
+ ],
184
+ "scale": [
185
+ 1,
186
+ 1,
187
+ 1,
188
+ "v"
189
+ ]
190
+ }
191
+ },
192
+ {
193
+ "uuid": "2aa7b313363fa7b2",
194
+ "class": "GAME.PrimitiveVehicle",
195
+ "properties": {
196
+ "editorData": {
197
+ "hidden": false
198
+ }
199
+ },
200
+ "ctor": {
201
+ "enableDirectionalLightFollowing": true,
202
+ "position": [
203
+ 3.1,
204
+ 2.3,
205
+ -7.7,
206
+ "v"
207
+ ],
208
+ "rotation": [
209
+ 0,
210
+ 0,
211
+ 0,
212
+ "e"
213
+ ],
214
+ "scale": [
215
+ 1,
216
+ 1,
217
+ 1,
218
+ "v"
219
+ ]
220
+ }
221
+ }
222
+ ],
223
+ "properties": {
224
+ "editorData": {}
225
+ }
226
226
  }