[Engine V2] create a game with V2, show on game card, URL param

Author: michaeljb

assets/app/lib/whats_this.rb

@@ -10,6 +10,14 @@ def auto_route_whats_this
       end
     end
 
+    module EngineV2
+      def engine_v2_whats_this
+        h(Component,
+          tooltip: 'Various work-in-progress changes to make the game Engine more efficient.',
+          url: 'https://github.com/tobymao/18xx/wiki/Engine-V2')
+      end
+    end
+
     class Component < Snabberb::Component
       needs :tooltip
       needs :url

assets/app/view/create_game.rb

@@ -11,6 +11,7 @@ class CreateGame < Form
     include GameManager
     include Lib::Settings
     include Lib::WhatsThis::AutoRoute
+    include Lib::WhatsThis::EngineV2
 
     needs :mode, default: :multi, store: true
     needs :flash_opts, default: {}, store: true
@@ -99,6 +100,7 @@ def render_content
           end
 
           inputs << render_random_seed
+          inputs << render_engine_v2 if should_render_engine_v2?
           inputs << render_optional if should_render_optional?
           inputs << render_game_info
         end
@@ -455,6 +457,7 @@ def submit
           title: game_params[:title],
         }
         game_data[:settings][:seed] = game_params[:seed] if game_params[:seed]
+        game_data[:settings][:use_engine_v2] = game_params[:use_engine_v2] if game_params[:use_engine_v2]
 
       when :json
         begin
@@ -711,5 +714,22 @@ def update_player_range(meta)
       title = meta.title
       @min_p[title], @max_p[title] = meta::PLAYER_RANGE
     end
+
+    def render_engine_v2
+      render_input(
+        'Use Engine V2 (experimental)',
+        id: 'use_engine_v2',
+        type: :checkbox,
+        container_style: { paddingLeft: '0.5rem' },
+        attrs: { checked: false },
+        siblings: [engine_v2_whats_this],
+      )
+    end
+
+    def should_render_engine_v2?
+      # for now, only available locally for any contributors
+      # https://github.com/tobymao/18xx/issues/12193
+      !@production
+    end
   end
 end

assets/app/view/game_card.rb

@@ -13,6 +13,7 @@ class GameCard < Snabberb::Component
     include GameManager
     include Lib::Settings
     include Lib::WhatsThis::AutoRoute
+    include Lib::WhatsThis::EngineV2
     include Lib::ProfileLink
 
     needs :user
@@ -242,6 +243,7 @@ def render_body
       if @gdata['status'] == 'new'
         children << h(:div, [h(:i, 'Invite only game')]) if @gdata.dig('settings', 'unlisted')
         children << h(:div, [h(:i, ['Auto Routing', auto_route_whats_this])]) if @gdata.dig('settings', 'auto_routing')
+        children << h(:div, [h(:i, ['Engine V2', engine_v2_whats_this])]) if @gdata.dig('settings', 'use_engine_v2')
       end
       children << h(:div, [h(:strong, 'Description: '), @gdata['description']]) unless @gdata['description'].empty?
 

assets/app/view/game_page.rb

@@ -80,9 +80,15 @@ def load_game
         LOGGER.debug do
           @_logger ||= {}
           @_logger[:process] = Time.now
-          "Processing game actions, strict: #{strict}..."
+          "Processing game actions, strict: #{strict}, use_engine_v2: #{use_engine_v2}..."
         end
-        @game = Engine::Game.load(@game_data, at_action: cursor, user: @user&.dig('id'), strict: strict)
+        @game = Engine::Game.load(
+          @game_data,
+          at_action: cursor,
+          user: @user&.dig('id'),
+          strict: strict,
+          use_engine_v2: use_engine_v2
+        )
         LOGGER.debug do
           "Done processing game actions: #{Time.now - @_logger[:process]} seconds"
         end
@@ -516,5 +522,15 @@ def strict
         @strict
       end
     end
+
+    # https://github.com/tobymao/18xx/issues/12193
+    def use_engine_v2
+      if (param = Lib::Params['v2'])
+        return false if param.start_with?('f')
+        return true if param.start_with?('t')
+      end
+
+      @game_data.dig('settings', 'use_engine_v2')
+    end
   end
 end

routes/game.rb

@@ -207,6 +207,7 @@ class Api
               unlisted: r.params['unlisted'],
               optional_rules: r.params['optional_rules'],
               auto_routing: r.params['auto_routing'],
+              use_engine_v2: r.params['use_engine_v2'],
               is_async: r.params['async'],
             },
             title: title,