Controls dialog startup changes

Author: gcclinux

src/main/java/wagemaker/uk/gdx/MyGdxGame.java

@@ -353,6 +353,9 @@ public void create() {
         // Load player position from save file if it exists
         gameMenu.loadPlayerPosition();
 
+        // Show controls dialog on first startup
+        gameMenu.showControlsOnStartup();
+        
         // Initialize connection quality indicator (will be set when connecting)
         connectionQualityIndicator = new wagemaker.uk.ui.ConnectionQualityIndicator(null, gameMenu.getFont());
 

src/main/java/wagemaker/uk/ui/GameMenu.java

@@ -85,6 +85,11 @@ public class GameMenu implements LanguageChangeListener, FontChangeListener {
 
     // Compass reference for custom target
     private Compass compass;
+    
+    // First launch flag for showing controls on startup
+    private boolean hasShownControlsOnStartup = false;
+    private boolean shouldShowControlsOnStartup = false;
+    private int startupFrameCounter = 0;
 
 
     public GameMenu() {
@@ -683,6 +688,9 @@ private int parseJsonObjectInt(String json, String objectKey, String propertyKey
     }
 
     public void update() {
+        // Check if we should show controls on startup (after a few frames)
+        checkStartupControlsDisplay();
+        
         // Update save notification timer
         if (showSaveNotification) {
             saveNotificationTimer -= Gdx.graphics.getDeltaTime();
@@ -1086,6 +1094,34 @@ private void openControlsDialog() {
         controlsDialog.show();
     }
 
+    /**
+     * Marks that the controls dialog should be shown on startup.
+     * This is called during game initialization.
+     * The actual display is delayed by a few frames to allow the world to load properly.
+     */
+    public void showControlsOnStartup() {
+        if (!hasShownControlsOnStartup) {
+            shouldShowControlsOnStartup = true;
+            startupFrameCounter = 0;
+        }
+    }
+    
+    /**
+     * Checks if controls should be shown after a few frames have passed.
+     * This ensures the world has loaded and camera is positioned correctly.
+     */
+    private void checkStartupControlsDisplay() {
+        if (shouldShowControlsOnStartup) {
+            startupFrameCounter++;
+            // Wait 3 frames before showing controls to allow world to load
+            if (startupFrameCounter >= 3) {
+                controlsDialog.show();
+                hasShownControlsOnStartup = true;
+                shouldShowControlsOnStartup = false;
+            }
+        }
+    }
+    
     /**
      * Handles the result of the player location dialog.
      */