feat: multi instance support added (#1336)

Author: kevindecibe

packages/@dcl/sdk-commands/src/commands/start/explorer-alpha.ts

@@ -46,6 +46,7 @@ async function runApp(
   const skipAuthScreen = !!args['--skip-auth-screen']
   const landscapeTerrainEnabled = !!args['--landscape-terrain-enabled']
   const openDeeplinkInNewInstance = !!args['-n']
+  const multiInstance = !!args['--multi-instance']
 
   try {
     if (isWindows) {
@@ -74,6 +75,9 @@ async function runApp(
     if (openDeeplinkInNewInstance) {
       params.set('open-deeplink-in-new-instance', 'true')
     }
+    if (multiInstance) {
+      params.set('multi-instance', 'true')
+    }
 
     const queryParams = params.toString()
 

packages/@dcl/sdk-commands/src/commands/start/index.ts

@@ -66,7 +66,8 @@ export const args = declareArgs({
   '--skip-auth-screen': Boolean,
   '--landscape-terrain-enabled': Boolean,
   '-n': Boolean,
-  '--bevy-web': Boolean
+  '--bevy-web': Boolean,
+  '--multi-instance': Boolean
 })
 
 export async function help(options: Options) {
@@ -93,7 +94,8 @@ export async function help(options: Options) {
       --landscape-terrain-enabled       Enable landscape terrain.
       -n                                Open a new instance of the Client even if one is already running.
       --bevy-web                        Opens preview using the Bevy Web browser window.
-      --mobile                      Show QR code for mobile preview on the same network
+      --mobile                          Show QR code for mobile preview on the same network.
+      --multi-instance                  Allow running multiple Explorer instances simultaneously.
 
 
     Examples:

test/sdk-commands/commands/start/explorer-alpha.spec.ts

@@ -143,6 +143,48 @@ describe('explorer-alpha', () => {
     })
   })
 
+  describe('multiInstance parameter', () => {
+    it('should include multi-instance parameter when --multi-instance flag is provided', async () => {
+      const args: any = {
+        '--multi-instance': true
+      }
+
+      await runExplorerAlpha(mockComponents, {
+        cwd: '/test',
+        realm: 'test-realm',
+        baseCoords: { x: 0, y: 0 },
+        isHub: false,
+        args
+      })
+
+      expect(mockExec).toHaveBeenCalledWith(
+        '/test',
+        'open',
+        expect.arrayContaining([expect.stringContaining('multi-instance=true')]),
+        { silent: true }
+      )
+    })
+
+    it('should not include multi-instance parameter when --multi-instance flag is not provided', async () => {
+      const args: any = {}
+
+      await runExplorerAlpha(mockComponents, {
+        cwd: '/test',
+        realm: 'test-realm',
+        baseCoords: { x: 0, y: 0 },
+        isHub: false,
+        args
+      })
+
+      expect(mockExec).toHaveBeenCalledWith(
+        '/test',
+        'open',
+        expect.arrayContaining([expect.not.stringContaining('multi-instance')]),
+        { silent: true }
+      )
+    })
+  })
+
   describe('URL parameter construction', () => {
     it('should construct URL with all parameters correctly', async () => {
       const args: any = {