From b793b83c961e0f92a2b9d67041ec214028a50649 Mon Sep 17 00:00:00 2001
From: forgebot <forgebot@forgejo.io>
Date: Wed, 26 Nov 2025 23:47:50 +0000
Subject: [PATCH 1/9] chore: update version to 1.0.0 [skip ci]

---
 VERSION       | 2 +-
 portainer.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/VERSION b/VERSION
index 8f0916f..3eefcb9 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.5.0
+1.0.0
diff --git a/portainer.yml b/portainer.yml
index 55f1f3c..dc71998 100644
--- a/portainer.yml
+++ b/portainer.yml
@@ -2,7 +2,7 @@ name: threejs-test
 
 services:
   app:
-    image: git.jusemon.com/jusemon/threejs-test:0.5.0
+    image: git.jusemon.com/jusemon/threejs-test:1.0.0
     restart: unless-stopped
 
 networks:

From 80153461e79ddb8e0e8e4fb9cb23e332fe3c2f55 Mon Sep 17 00:00:00 2001
From: Juan Sebastian Montoya <juansmm@outlook.com>
Date: Wed, 26 Nov 2025 19:18:09 -0500
Subject: [PATCH 2/9] Hotfix/No way to pause on mobile (#19)

- Added pause button functionality to control game state (pause/resume).
- Updated sound status button visibility and styling for improved user experience.
- Adjusted button styles for better responsiveness and aesthetics on mobile devices.
- Implemented logic to show/hide buttons based on game state transitions.

This update improves gameplay interaction and visual feedback for users.

Reviewed-on: https://git.jusemon.com/jusemon/threejs-test/pulls/19
Co-authored-by: Juan Sebastian Montoya <juansmm@outlook.com>
Co-committed-by: Juan Sebastian Montoya <juansmm@outlook.com>
---
 index.html       | 62 ++++++++++++++++++++++++++++++++++++++++++------
 src/game/Game.js | 48 +++++++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+), 7 deletions(-)

diff --git a/index.html b/index.html
index 6af2d9b..0929da0 100644
--- a/index.html
+++ b/index.html
@@ -118,18 +118,57 @@
             font-family: 'Courier New', monospace;
         }
         #soundStatus {
+            display: none;
             position: absolute;
             top: 20px;
-            right: 100px;
-            font-size: 20px;
+            right: 90px;
+            background: rgba(0,0,0,0.7);
+            border: 2px solid white;
+            color: white;
+            font-size: 24px;
+            padding: 10px 15px;
+            border-radius: 10px;
             cursor: pointer;
             z-index: 100;
+            font-family: Arial, sans-serif;
+            transition: all 0.2s;
             user-select: none;
-            opacity: 0.8;
-            transition: opacity 0.2s;
         }
         #soundStatus:hover {
-            opacity: 1;
+            background: rgba(0,0,0,0.9);
+            transform: scale(1.1);
+        }
+        #soundStatus:active {
+            transform: scale(0.95);
+        }
+        #pauseBtn {
+            display: none;
+            position: absolute;
+            top: 20px;
+            right: 20px;
+            background: rgba(0,0,0,0.7);
+            border: 2px solid white;
+            color: white;
+            font-size: 24px;
+            padding: 10px 15px;
+            border-radius: 10px;
+            cursor: pointer;
+            z-index: 100;
+            font-family: Arial, sans-serif;
+            transition: all 0.2s;
+        }
+        #pauseBtn:hover {
+            background: rgba(0,0,0,0.9);
+            transform: scale(1.1);
+        }
+        #pauseBtn:active {
+            transform: scale(0.95);
+        }
+        /* Show buttons when game is active */
+        @media (max-width: 768px) {
+            #pauseBtn {
+                display: block;
+            }
         }
         #perfMonitor {
             position: absolute;
@@ -162,8 +201,15 @@
             }
             #soundStatus {
                 top: 10px;
-                right: 60px;
-                font-size: 18px;
+                right: 80px;
+                font-size: 20px;
+                padding: 8px 12px;
+            }
+            #pauseBtn {
+                top: 10px;
+                right: 10px;
+                font-size: 20px;
+                padding: 8px 12px;
             }
             #perfMonitor {
                 top: 40px;
@@ -186,6 +232,8 @@
     
     <div id="soundStatus" title="Sound ON (Press M to mute)">🔊</div>
     
+    <button id="pauseBtn" title="Pause Game">⏸️</button>
+    
     <div id="perfMonitor">
         <div><span class="label">FPS:</span> <span id="fps">60</span></div>
         <div><span class="label">Frame:</span> <span id="frameTime">16.7</span>ms</div>
diff --git a/src/game/Game.js b/src/game/Game.js
index 90fc214..a7b922b 100644
--- a/src/game/Game.js
+++ b/src/game/Game.js
@@ -411,6 +411,16 @@ export class Game {
       document.getElementById('instructions').style.display = 'block';
     }
     
+    // Show pause and sound buttons when game starts
+    const pauseBtn = document.getElementById('pauseBtn');
+    if (pauseBtn) {
+      pauseBtn.style.display = 'block';
+    }
+    const soundStatus = document.getElementById('soundStatus');
+    if (soundStatus) {
+      soundStatus.style.display = 'block';
+    }
+    
     // Reset UI
     this.updateUI();
     document.getElementById('combo').style.display = 'none';
@@ -436,6 +446,13 @@ export class Game {
       this.soundSystem.stopBackgroundMusic();
     }
     
+    // Update pause button text
+    const pauseBtn = document.getElementById('pauseBtn');
+    if (pauseBtn) {
+      pauseBtn.textContent = '▶️';
+      pauseBtn.title = 'Resume Game';
+    }
+    
     if (this.uiSystem) {
       this.uiSystem.setState('paused');
     } else {
@@ -458,6 +475,13 @@ export class Game {
       });
     }
     
+    // Update pause button text
+    const pauseBtn = document.getElementById('pauseBtn');
+    if (pauseBtn) {
+      pauseBtn.textContent = '⏸️';
+      pauseBtn.title = 'Pause Game';
+    }
+    
     if (this.uiSystem) {
       this.uiSystem.setState('playing');
     } else {
@@ -476,6 +500,16 @@ export class Game {
     this.isPaused = false;
     this.timeScale = 0; // Stop time in menu
     
+    // Hide pause and sound buttons when returning to menu
+    const pauseBtn = document.getElementById('pauseBtn');
+    if (pauseBtn) {
+      pauseBtn.style.display = 'none';
+    }
+    const soundStatus = document.getElementById('soundStatus');
+    if (soundStatus) {
+      soundStatus.style.display = 'none';
+    }
+    
     // Update UI state
     if (this.uiSystem) {
       this.uiSystem.setState('menu');
@@ -516,6 +550,20 @@ export class Game {
       pauseMenuBtn.addEventListener('click', () => this.returnToMenu());
     }
     
+    // Pause button (for mobile)
+    const pauseBtn = document.getElementById('pauseBtn');
+    if (pauseBtn) {
+      pauseBtn.addEventListener('click', () => {
+        if (this.gameActive && !this.inMenu) {
+          if (this.isPaused) {
+            this.resumeGame();
+          } else {
+            this.pauseGame();
+          }
+        }
+      });
+    }
+    
     document.getElementById('restartBtn').addEventListener('click', () => this.restart());
 
     // Toggle performance monitor with 'T' key

From fe4c91e711f21bad88476a496ff6e61bc867d153 Mon Sep 17 00:00:00 2001
From: forgebot <forgebot@forgejo.io>
Date: Thu, 27 Nov 2025 00:18:18 +0000
Subject: [PATCH 3/9] chore: update version to 1.0.1 [skip ci]

---
 VERSION       | 2 +-
 portainer.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/VERSION b/VERSION
index 3eefcb9..7dea76e 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-1.0.0
+1.0.1
diff --git a/portainer.yml b/portainer.yml
index dc71998..b654641 100644
--- a/portainer.yml
+++ b/portainer.yml
@@ -2,7 +2,7 @@ name: threejs-test
 
 services:
   app:
-    image: git.jusemon.com/jusemon/threejs-test:1.0.0
+    image: git.jusemon.com/jusemon/threejs-test:1.0.1
     restart: unless-stopped
 
 networks:

From c4466ae7e66cff2a4f1de69fc19293d0ebd71000 Mon Sep 17 00:00:00 2001
From: Juan Sebastian Montoya <juansmm@outlook.com>
Date: Wed, 26 Nov 2025 19:24:25 -0500
Subject: [PATCH 4/9] Hotfix/Cache busting (#20)

Reviewed-on: https://git.jusemon.com/jusemon/threejs-test/pulls/20
Co-authored-by: Juan Sebastian Montoya <juansmm@outlook.com>
Co-committed-by: Juan Sebastian Montoya <juansmm@outlook.com>
---
 index.html | 565 +++++++++++++++++++++++++++++------------------------
 1 file changed, 311 insertions(+), 254 deletions(-)

diff --git a/index.html b/index.html
index 0929da0..d98142e 100644
--- a/index.html
+++ b/index.html
@@ -1,289 +1,346 @@
 <!DOCTYPE html>
 <html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>3D Coin Collector Game</title>
     <style>
-        * {
-            margin: 0;
-            padding: 0;
-            box-sizing: border-box;
+      * {
+        margin: 0;
+        padding: 0;
+        box-sizing: border-box;
+      }
+      body {
+        overflow: hidden;
+        font-family: "Arial", sans-serif;
+        background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      }
+      #ui {
+        position: absolute;
+        top: 20px;
+        left: 20px;
+        color: white;
+        font-size: 24px;
+        text-shadow: 2px 2px 4px rgba(0, 0, 0, 0.5);
+        z-index: 100;
+      }
+      #combo {
+        position: absolute;
+        top: 100px;
+        left: 50%;
+        transform: translateX(-50%);
+        color: #ffd700;
+        font-size: 32px;
+        font-weight: bold;
+        text-shadow: 2px 2px 4px rgba(0, 0, 0, 0.8);
+        z-index: 100;
+        display: none;
+        animation: comboPulse 0.5s ease-in-out;
+      }
+      @keyframes comboPulse {
+        0%,
+        100% {
+          transform: translateX(-50%) scale(1);
         }
-        body {
-            overflow: hidden;
-            font-family: 'Arial', sans-serif;
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+        50% {
+          transform: translateX(-50%) scale(1.2);
         }
-        #ui {
-            position: absolute;
-            top: 20px;
-            left: 20px;
-            color: white;
-            font-size: 24px;
-            text-shadow: 2px 2px 4px rgba(0,0,0,0.5);
-            z-index: 100;
-        }
-        #combo {
-            position: absolute;
-            top: 100px;
-            left: 50%;
-            transform: translateX(-50%);
-            color: #FFD700;
-            font-size: 32px;
-            font-weight: bold;
-            text-shadow: 2px 2px 4px rgba(0,0,0,0.8);
-            z-index: 100;
-            display: none;
-            animation: comboPulse 0.5s ease-in-out;
-        }
-        @keyframes comboPulse {
-            0%, 100% { transform: translateX(-50%) scale(1); }
-            50% { transform: translateX(-50%) scale(1.2); }
-        }
-        #startMenu, #pauseMenu, #gameOver {
-            position: absolute;
-            top: 50%;
-            left: 50%;
-            transform: translate(-50%, -50%);
-            background: rgba(0,0,0,0.9);
-            padding: 50px;
-            border-radius: 20px;
-            text-align: center;
-            color: white;
-            z-index: 200;
-            min-width: 400px;
-            box-shadow: 0 10px 40px rgba(0,0,0,0.5);
-        }
-        #startMenu {
-            display: block;
-        }
-        #pauseMenu, #gameOver {
-            display: none;
-        }
-        #startMenu h1, #pauseMenu h1, #gameOver h1 {
-            font-size: 48px;
-            margin-bottom: 20px;
-            color: #4CAF50;
-        }
-        #pauseMenu h1 {
-            color: #FFA500;
-        }
-        #gameOver h1 {
-            color: #ff6b6b;
-        }
-        #startMenu p, #pauseMenu p, #gameOver p {
-            font-size: 20px;
-            margin-bottom: 30px;
-            line-height: 1.6;
-        }
-        #startMenu button, #pauseMenu button, #restartBtn {
-            background: #4CAF50;
-            border: none;
-            color: white;
-            padding: 15px 40px;
-            font-size: 20px;
-            border-radius: 10px;
-            cursor: pointer;
-            transition: all 0.3s;
-            margin: 10px;
-        }
-        #startMenu button:hover, #pauseMenu button:hover, #restartBtn:hover {
-            background: #45a049;
-            transform: scale(1.1);
-        }
-        #pauseMenu button.resumeBtn {
-            background: #2196F3;
-        }
-        #pauseMenu button.resumeBtn:hover {
-            background: #1976D2;
+      }
+      #startMenu,
+      #pauseMenu,
+      #gameOver {
+        position: absolute;
+        top: 50%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        background: rgba(0, 0, 0, 0.9);
+        padding: 50px;
+        border-radius: 20px;
+        text-align: center;
+        color: white;
+        z-index: 200;
+        min-width: 400px;
+        box-shadow: 0 10px 40px rgba(0, 0, 0, 0.5);
+      }
+      #startMenu {
+        display: block;
+      }
+      #pauseMenu,
+      #gameOver {
+        display: none;
+      }
+      #startMenu h1,
+      #pauseMenu h1,
+      #gameOver h1 {
+        font-size: 48px;
+        margin-bottom: 20px;
+        color: #4caf50;
+      }
+      #pauseMenu h1 {
+        color: #ffa500;
+      }
+      #gameOver h1 {
+        color: #ff6b6b;
+      }
+      #startMenu p,
+      #pauseMenu p,
+      #gameOver p {
+        font-size: 20px;
+        margin-bottom: 30px;
+        line-height: 1.6;
+      }
+      #startMenu button,
+      #pauseMenu button,
+      #restartBtn {
+        background: #4caf50;
+        border: none;
+        color: white;
+        padding: 15px 40px;
+        font-size: 20px;
+        border-radius: 10px;
+        cursor: pointer;
+        transition: all 0.3s;
+        margin: 10px;
+      }
+      #startMenu button:hover,
+      #pauseMenu button:hover,
+      #restartBtn:hover {
+        background: #45a049;
+        transform: scale(1.1);
+      }
+      #pauseMenu button.resumeBtn {
+        background: #2196f3;
+      }
+      #pauseMenu button.resumeBtn:hover {
+        background: #1976d2;
+      }
+      #instructions {
+        position: absolute;
+        bottom: 20px;
+        left: 50%;
+        transform: translateX(-50%);
+        color: white;
+        text-align: center;
+        text-shadow: 2px 2px 4px rgba(0, 0, 0, 0.5);
+      }
+      #version {
+        position: absolute;
+        top: 20px;
+        right: 20px;
+        color: rgba(255, 255, 255, 0.7);
+        font-size: 14px;
+        text-shadow: 2px 2px 4px rgba(0, 0, 0, 0.5);
+        z-index: 100;
+        font-family: "Courier New", monospace;
+      }
+      #soundStatus {
+        display: none;
+        position: absolute;
+        top: 20px;
+        right: 90px;
+        background: rgba(0, 0, 0, 0.7);
+        border: 2px solid white;
+        color: white;
+        font-size: 24px;
+        padding: 10px 15px;
+        border-radius: 10px;
+        cursor: pointer;
+        z-index: 100;
+        font-family: Arial, sans-serif;
+        transition: all 0.2s;
+        user-select: none;
+      }
+      #soundStatus:hover {
+        background: rgba(0, 0, 0, 0.9);
+        transform: scale(1.1);
+      }
+      #soundStatus:active {
+        transform: scale(0.95);
+      }
+      #pauseBtn {
+        display: none;
+        position: absolute;
+        top: 20px;
+        right: 20px;
+        background: rgba(0, 0, 0, 0.7);
+        border: 2px solid white;
+        color: white;
+        font-size: 24px;
+        padding: 10px 15px;
+        border-radius: 10px;
+        cursor: pointer;
+        z-index: 100;
+        font-family: Arial, sans-serif;
+        transition: all 0.2s;
+      }
+      #pauseBtn:hover {
+        background: rgba(0, 0, 0, 0.9);
+        transform: scale(1.1);
+      }
+      #pauseBtn:active {
+        transform: scale(0.95);
+      }
+      /* Show buttons when game is active */
+      @media (max-width: 768px) {
+        #pauseBtn {
+          display: block;
         }
+      }
+      #perfMonitor {
+        position: absolute;
+        top: 60px;
+        right: 20px;
+        background: rgba(0, 0, 0, 0.7);
+        padding: 10px;
+        border-radius: 5px;
+        color: #00ff00;
+        font-size: 12px;
+        font-family: "Courier New", monospace;
+        z-index: 100;
+        display: none;
+        min-width: 120px;
+      }
+      #perfMonitor.visible {
+        display: block;
+      }
+      #perfMonitor .label {
+        color: #888;
+      }
+      @media (max-width: 768px) {
         #instructions {
-            position: absolute;
-            bottom: 20px;
-            left: 50%;
-            transform: translateX(-50%);
-            color: white;
-            text-align: center;
-            text-shadow: 2px 2px 4px rgba(0,0,0,0.5);
+          font-size: 14px;
         }
         #version {
-            position: absolute;
-            top: 20px;
-            right: 20px;
-            color: rgba(255, 255, 255, 0.7);
-            font-size: 14px;
-            text-shadow: 2px 2px 4px rgba(0,0,0,0.5);
-            z-index: 100;
-            font-family: 'Courier New', monospace;
+          font-size: 12px;
+          top: 10px;
+          right: 10px;
         }
         #soundStatus {
-            display: none;
-            position: absolute;
-            top: 20px;
-            right: 90px;
-            background: rgba(0,0,0,0.7);
-            border: 2px solid white;
-            color: white;
-            font-size: 24px;
-            padding: 10px 15px;
-            border-radius: 10px;
-            cursor: pointer;
-            z-index: 100;
-            font-family: Arial, sans-serif;
-            transition: all 0.2s;
-            user-select: none;
-        }
-        #soundStatus:hover {
-            background: rgba(0,0,0,0.9);
-            transform: scale(1.1);
-        }
-        #soundStatus:active {
-            transform: scale(0.95);
+          top: 10px;
+          right: 80px;
+          font-size: 20px;
+          padding: 8px 12px;
         }
         #pauseBtn {
-            display: none;
-            position: absolute;
-            top: 20px;
-            right: 20px;
-            background: rgba(0,0,0,0.7);
-            border: 2px solid white;
-            color: white;
-            font-size: 24px;
-            padding: 10px 15px;
-            border-radius: 10px;
-            cursor: pointer;
-            z-index: 100;
-            font-family: Arial, sans-serif;
-            transition: all 0.2s;
-        }
-        #pauseBtn:hover {
-            background: rgba(0,0,0,0.9);
-            transform: scale(1.1);
-        }
-        #pauseBtn:active {
-            transform: scale(0.95);
-        }
-        /* Show buttons when game is active */
-        @media (max-width: 768px) {
-            #pauseBtn {
-                display: block;
-            }
+          top: 10px;
+          right: 10px;
+          font-size: 20px;
+          padding: 8px 12px;
         }
         #perfMonitor {
-            position: absolute;
-            top: 60px;
-            right: 20px;
-            background: rgba(0, 0, 0, 0.7);
-            padding: 10px;
-            border-radius: 5px;
-            color: #00ff00;
-            font-size: 12px;
-            font-family: 'Courier New', monospace;
-            z-index: 100;
-            display: none;
-            min-width: 120px;
-        }
-        #perfMonitor.visible {
-            display: block;
-        }
-        #perfMonitor .label {
-            color: #888;
-        }
-        @media (max-width: 768px) {
-            #instructions {
-                font-size: 14px;
-            }
-            #version {
-                font-size: 12px;
-                top: 10px;
-                right: 10px;
-            }
-            #soundStatus {
-                top: 10px;
-                right: 80px;
-                font-size: 20px;
-                padding: 8px 12px;
-            }
-            #pauseBtn {
-                top: 10px;
-                right: 10px;
-                font-size: 20px;
-                padding: 8px 12px;
-            }
-            #perfMonitor {
-                top: 40px;
-                right: 10px;
-                font-size: 11px;
-            }
+          top: 40px;
+          right: 10px;
+          font-size: 11px;
         }
+      }
     </style>
-</head>
-<body>
-    <div id="ui" style="display: none;">
-        <div>Score: <span id="score">0</span></div>
-        <div>High Score: <span id="highScore">0</span></div>
-        <div>Health: <span id="health">100</span></div>
+  </head>
+  <body>
+    <div id="ui" style="display: none">
+      <div>Score: <span id="score">0</span></div>
+      <div>High Score: <span id="highScore">0</span></div>
+      <div>Health: <span id="health">100</span></div>
     </div>
-    
+
     <div id="combo">1x COMBO!</div>
-    
+
     <div id="version">v<span id="versionNumber">-</span></div>
-    
+
     <div id="soundStatus" title="Sound ON (Press M to mute)">🔊</div>
-    
+
     <button id="pauseBtn" title="Pause Game">⏸️</button>
-    
+
     <div id="perfMonitor">
-        <div><span class="label">FPS:</span> <span id="fps">60</span></div>
-        <div><span class="label">Frame:</span> <span id="frameTime">16.7</span>ms</div>
-        <div><span class="label">Entities:</span> <span id="entityCount">0</span></div>
+      <div><span class="label">FPS:</span> <span id="fps">60</span></div>
+      <div>
+        <span class="label">Frame:</span> <span id="frameTime">16.7</span>ms
+      </div>
+      <div>
+        <span class="label">Entities:</span> <span id="entityCount">0</span>
+      </div>
     </div>
-    
+
     <div id="startMenu">
-        <h1>🎮 Coin Collector</h1>
-        <p>Collect coins, avoid obstacles, and survive as long as you can!</p>
-        <p style="font-size: 16px; opacity: 0.8; margin-top: 20px;">
-            <strong>Controls:</strong><br>
-            WASD or Arrow Keys to move<br>
-            Touch and drag (mobile)<br>
-            ESC or P to pause
-        </p>
-        <button id="startBtn">Start Game</button>
+      <h1>🎮 Coin Collector</h1>
+      <p>Collect coins, avoid obstacles, and survive as long as you can!</p>
+      <p style="font-size: 16px; opacity: 0.8; margin-top: 20px">
+        <strong>Controls:</strong><br />
+        WASD or Arrow Keys to move<br />
+        Touch and drag (mobile)<br />
+        ESC or P to pause
+      </p>
+      <button id="startBtn">Start Game</button>
     </div>
-    
+
     <div id="pauseMenu">
-        <h1>⏸️ Paused</h1>
-        <p>Game is paused</p>
-        <button class="resumeBtn" id="resumeBtn">Resume</button>
-        <button id="pauseMenuBtn">Main Menu</button>
+      <h1>⏸️ Paused</h1>
+      <p>Game is paused</p>
+      <button class="resumeBtn" id="resumeBtn">Resume</button>
+      <button id="pauseMenuBtn">Main Menu</button>
     </div>
-    
+
     <div id="gameOver">
-        <h1>Game Over!</h1>
-        <p id="newHighScore" style="display: none; color: #FFD700; font-size: 28px; margin-bottom: 10px;">🏆 New High Score! 🏆</p>
-        <p>Final Score: <span id="finalScore">0</span></p>
-        <button id="restartBtn">Play Again</button>
+      <h1>Game Over!</h1>
+      <p
+        id="newHighScore"
+        style="
+          display: none;
+          color: #ffd700;
+          font-size: 28px;
+          margin-bottom: 10px;
+        "
+      >
+        🏆 New High Score! 🏆
+      </p>
+      <p>Final Score: <span id="finalScore">0</span></p>
+      <button id="restartBtn">Play Again</button>
     </div>
-    
-    <div id="instructions" style="display: none;">
-        <p><strong>Controls:</strong> WASD or Arrow Keys to move | Touch and drag to move (mobile) | Collect yellow coins | Avoid red obstacles!</p>
-        <p style="margin-top: 5px; font-size: 11px; opacity: 0.7;">Press "T" to toggle performance monitor | Press "M" to toggle sound | Press "ESC" or "P" to pause</p>
+
+    <div id="instructions" style="display: none">
+      <p>
+        <strong>Controls:</strong> WASD or Arrow Keys to move | Touch and drag
+        to move (mobile) | Collect yellow coins | Avoid red obstacles!
+      </p>
+      <p style="margin-top: 5px; font-size: 11px; opacity: 0.7">
+        Press "T" to toggle performance monitor | Press "M" to toggle sound |
+        Press "ESC" or "P" to pause
+      </p>
     </div>
 
     <script type="module">
-        // Import Three.js from CDN
-        
-        import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.181.2/build/three.module.js';
-        
-        // Make THREE globally available for our modules
-        window.THREE = THREE;
-        
-        // Load the game after THREE is loaded
-        import('./src/main.js').catch(err => {
-            console.error('Failed to load game:', err);
-        });
-    </script>
-</body>
-</html>
+      // Import Three.js from CDN
 
+      import * as THREE from "https://cdn.jsdelivr.net/npm/three@0.181.2/build/three.module.js";
+
+      // Make THREE globally available for our modules
+      window.THREE = THREE;
+
+      // Load version for cache busting
+      async function loadGame() {
+        try {
+          // Try to get version from version.json for cache busting
+          const versionResponse = await fetch(`/version.json?t=${Date.now()}`, {
+            cache: "no-store",
+          });
+          let cacheBuster = `?t=${Date.now()}`;
+
+          if (versionResponse.ok) {
+            const versionData = await versionResponse.json();
+            if (versionData.version) {
+              // Use version for cache busting (more reliable than timestamp)
+              cacheBuster = `?v=${versionData.version}`;
+            }
+          }
+
+          // Load the game with cache busting
+          await import(`./src/main.js${cacheBuster}`);
+        } catch (err) {
+          console.error("Failed to load game:", err);
+        }
+      }
+
+      // Load the game after THREE is loaded
+      loadGame();
+    </script>
+  </body>
+</html>

From 9739d5e8e9e838bf6204fb0e409a5c31d2338c3b Mon Sep 17 00:00:00 2001
From: forgebot <forgebot@forgejo.io>
Date: Thu, 27 Nov 2025 00:24:32 +0000
Subject: [PATCH 5/9] chore: update version to 1.0.2 [skip ci]

---
 VERSION       | 2 +-
 portainer.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/VERSION b/VERSION
index 7dea76e..6d7de6e 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-1.0.1
+1.0.2
diff --git a/portainer.yml b/portainer.yml
index b654641..e20a5a5 100644
--- a/portainer.yml
+++ b/portainer.yml
@@ -2,7 +2,7 @@ name: threejs-test
 
 services:
   app:
-    image: git.jusemon.com/jusemon/threejs-test:1.0.1
+    image: git.jusemon.com/jusemon/threejs-test:1.0.2
     restart: unless-stopped
 
 networks:

From 98ec60641d5627a78bcaba3263ff054fc195b185 Mon Sep 17 00:00:00 2001
From: Juan Sebastian Montoya <juansmm@outlook.com>
Date: Wed, 26 Nov 2025 19:40:41 -0500
Subject: [PATCH 6/9] Hotfix/Cache bust all js files (#21)

Reviewed-on: https://git.jusemon.com/jusemon/threejs-test/pulls/21
Co-authored-by: Juan Sebastian Montoya <juansmm@outlook.com>
Co-committed-by: Juan Sebastian Montoya <juansmm@outlook.com>
---
 Dockerfile          |  5 +++++
 build-cache-bust.sh | 46 +++++++++++++++++++++++++++++++++++++++++++++
 nginx.conf          | 18 +++++++++++++-----
 3 files changed, 64 insertions(+), 5 deletions(-)
 create mode 100755 build-cache-bust.sh

diff --git a/Dockerfile b/Dockerfile
index 4da0eb6..a6812e6 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -11,6 +11,11 @@ RUN printf '{"version":"%s","buildDate":"%s"}\n' "${VERSION}" "${BUILD_DATE}" >
 COPY index.html /usr/share/nginx/html/
 COPY src/ /usr/share/nginx/html/src/
 
+# Copy and run cache busting script (bash/sed - no external dependencies needed)
+COPY build-cache-bust.sh /tmp/build-cache-bust.sh
+RUN chmod +x /tmp/build-cache-bust.sh && \
+    /tmp/build-cache-bust.sh "${VERSION}" /usr/share/nginx/html
+
 # Copy nginx configuration
 COPY nginx.conf /etc/nginx/conf.d/default.conf
 
diff --git a/build-cache-bust.sh b/build-cache-bust.sh
new file mode 100755
index 0000000..ecac517
--- /dev/null
+++ b/build-cache-bust.sh
@@ -0,0 +1,46 @@
+#!/bin/sh
+# Simple cache busting script - adds version query params to all JS imports
+# Only runs during Docker build, not during local development
+# This keeps development simple (no tools needed) while ensuring production cache busting
+
+VERSION="${1:-dev}"
+SRC_DIR="${2:-/usr/share/nginx/html}"
+
+echo "Adding cache busting (v=${VERSION}) to JS imports in ${SRC_DIR}/src..."
+
+# Find all JS files and add version query param to relative imports
+find "$SRC_DIR/src" -type f -name "*.js" | while read -r file; do
+  # Skip if file doesn't exist
+  [ ! -f "$file" ] && continue
+  
+  # Process file with sed to add version query params
+  # Pattern: from './path.js' or from "../path.js" or import('./path.js')
+  # Only match relative imports (./ or ../) ending in .js
+  # Skip if already has query params (contains ?)
+  
+  # Handle single quote imports: from './path.js'
+  sed -i.bak \
+    -e "s|from '\\(\\.[./][^']*\\.js\\)'|from '\\1?v=${VERSION}'|g" \
+    -e "s|from '\\(\\.[./][^']*\\.js\\)?[^']*'|from '\\1?v=${VERSION}'|g" \
+    "$file"
+  
+  # Handle double quote imports: from "./path.js"
+  sed -i.bak \
+    -e "s|from \"\\(\\.[./][^\"]*\\.js\\)\"|from \"\\1?v=${VERSION}\"|g" \
+    -e "s|from \"\\(\\.[./][^\"]*\\.js\\)?[^\"]*\"|from \"\\1?v=${VERSION}\"|g" \
+    "$file"
+  
+  # Handle dynamic imports: import('./path.js')
+  sed -i.bak \
+    -e "s|import('\\(\\.[./][^']*\\.js\\)')|import('\\1?v=${VERSION}')|g" \
+    -e "s|import('\\(\\.[./][^']*\\.js\\)?[^']*')|import('\\1?v=${VERSION}')|g" \
+    -e "s|import(\"\\(\\.[./][^\"]*\\.js\\)\")|import(\"\\1?v=${VERSION}\")|g" \
+    -e "s|import(\"\\(\\.[./][^\"]*\\.js\\)?[^\"]*\")|import(\"\\1?v=${VERSION}\")|g" \
+    "$file"
+  
+  # Remove backup file
+  rm -f "${file}.bak"
+done
+
+echo "Cache busting complete! All JS imports now include ?v=${VERSION}"
+
diff --git a/nginx.conf b/nginx.conf
index eee0bb3..b7b147e 100644
--- a/nginx.conf
+++ b/nginx.conf
@@ -9,11 +9,19 @@ server {
         try_files $uri $uri/ =404;
     }
     
-    # Prevent caching of JavaScript files and version.json
-    location ~* \.(js|mjs)$ {
-        add_header Cache-Control "no-cache, no-store, must-revalidate";
-        add_header Pragma "no-cache";
-        add_header Expires "0";
+    # Cache JavaScript files with version query params for 1 year (immutable)
+    # Files without version params are not cached
+    location ~* \.(js|mjs)(\?v=[^&]+)?$ {
+        if ($args ~ "v=") {
+            # Has version param - cache for 1 year (immutable)
+            add_header Cache-Control "public, max-age=31536000, immutable";
+        }
+        if ($args !~ "v=") {
+            # No version param - don't cache
+            add_header Cache-Control "no-cache, no-store, must-revalidate";
+            add_header Pragma "no-cache";
+            add_header Expires "0";
+        }
         add_header Vary "Accept-Encoding";
     }
     

From 8f4047d15138a7eb1c3a33c1325397164b63d782 Mon Sep 17 00:00:00 2001
From: forgebot <forgebot@forgejo.io>
Date: Thu, 27 Nov 2025 00:40:50 +0000
Subject: [PATCH 7/9] chore: update version to 1.0.3 [skip ci]

---
 VERSION       | 2 +-
 portainer.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/VERSION b/VERSION
index 6d7de6e..21e8796 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-1.0.2
+1.0.3
diff --git a/portainer.yml b/portainer.yml
index e20a5a5..9a6e5e7 100644
--- a/portainer.yml
+++ b/portainer.yml
@@ -2,7 +2,7 @@ name: threejs-test
 
 services:
   app:
-    image: git.jusemon.com/jusemon/threejs-test:1.0.2
+    image: git.jusemon.com/jusemon/threejs-test:1.0.3
     restart: unless-stopped
 
 networks:

From f75e42d1311103d83b06c64a3456611058533eb8 Mon Sep 17 00:00:00 2001
From: Juan Sebastian Montoya <juansmm@outlook.com>
Date: Wed, 26 Nov 2025 23:07:24 -0500
Subject: [PATCH 8/9] Bugfix/Correct version tagging (#22)

Reviewed-on: https://git.jusemon.com/jusemon/threejs-test/pulls/22
Co-authored-by: Juan Sebastian Montoya <juansmm@outlook.com>
Co-committed-by: Juan Sebastian Montoya <juansmm@outlook.com>
---
 .forgejo/workflows/publish-and-deploy.yaml | 130 +++++++++++----------
 1 file changed, 71 insertions(+), 59 deletions(-)

diff --git a/.forgejo/workflows/publish-and-deploy.yaml b/.forgejo/workflows/publish-and-deploy.yaml
index 3bf30d3..01c787b 100644
--- a/.forgejo/workflows/publish-and-deploy.yaml
+++ b/.forgejo/workflows/publish-and-deploy.yaml
@@ -105,6 +105,60 @@ jobs:
           echo "New version: $NEW_VERSION"
           echo "Current VERSION file: $(cat VERSION 2>/dev/null || echo 'not found')"
 
+      - name: Update Version Files
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          TAG="${{ steps.version.outputs.tag }}"
+          
+          echo "📝 Updating version files to: $VERSION"
+          
+          # Configure git
+          git config user.name "forgebot"
+          git config user.email "forgebot@forgejo.io"
+          
+          # Fetch latest changes to avoid conflicts
+          git fetch origin main || echo "Fetch completed or already up to date"
+          git checkout main || echo "Already on main"
+          
+          # Update VERSION file
+          echo "$VERSION" > VERSION
+          
+          # Update portainer.yml with new version
+          sed -i "s|\(image: git.jusemon.com/jusemon/threejs-test:\)[0-9.]*|\1$VERSION|" portainer.yml
+          
+          # Verify the updates
+          if grep -q "^$VERSION$" VERSION && grep -q "image: git.jusemon.com/jusemon/threejs-test:$VERSION" portainer.yml; then
+            echo "✅ Successfully updated VERSION and portainer.yml to $VERSION"
+          else
+            echo "❌ Failed to update version files"
+            exit 1
+          fi
+          
+          # Check if there are changes to commit
+          if git diff --quiet VERSION portainer.yml; then
+            echo "⚠️ No changes to commit (files already up to date)"
+            echo "VERSION_COMMIT_HASH=$(git rev-parse HEAD)" >> $GITHUB_ENV
+          else
+            # Stage and commit with [skip ci] to prevent infinite loop
+            # Note: Forgejo Actions should respect [skip ci] in commit messages
+            git add VERSION portainer.yml
+            git commit -m "chore: update version to $VERSION [skip ci]" || {
+              echo "⚠️ Commit failed (may already be committed)"
+              exit 0
+            }
+            
+            # Push to main branch (remote should already be configured with token)
+            git push origin main || {
+              echo "⚠️ Push failed (check token permissions)"
+              exit 0
+            }
+            
+            # Get the commit hash of the version update commit
+            VERSION_COMMIT_HASH=$(git rev-parse HEAD)
+            echo "VERSION_COMMIT_HASH=$VERSION_COMMIT_HASH" >> $GITHUB_ENV
+            echo "✅ Successfully committed and pushed version update to $VERSION (commit: $VERSION_COMMIT_HASH)"
+          fi
+
       - name: Build Docker Image
         run: |
           VERSION="${{ steps.version.outputs.version }}"
@@ -128,20 +182,24 @@ jobs:
           VERSION="${{ steps.version.outputs.version }}"
           TAG="${{ steps.version.outputs.tag }}"
           IMAGE_NAME="git.jusemon.com/jusemon/threejs-test:$VERSION"
-          COMMIT_HASH=$(git rev-parse HEAD)
-          COMMIT_SHORT=$(git rev-parse --short HEAD)
+          # Use the version update commit hash (which has the correct version in files)
+          COMMIT_HASH="${VERSION_COMMIT_HASH:-$(git rev-parse HEAD)}"
+          COMMIT_SHORT=$(git rev-parse --short "$COMMIT_HASH")
           BUILD_DATE=$(date -u +"%Y-%m-%d %H:%M:%S UTC")
           
-          # Get commits since last tag
+          # Get commits since last tag, excluding version update commits
           LATEST_TAG=$(git describe --tags --match 'v*.*.*' --abbrev=0 2>/dev/null || echo "")
           if [[ -n "$LATEST_TAG" ]]; then
-            COMMITS=$(git log ${LATEST_TAG}..HEAD --pretty=format:"- %s (%h)" --no-merges)
+            # Get commits excluding "chore: update version" commits (from previous releases)
+            # We want commits from the tag to the version update commit (exclusive of the version commit itself)
+            COMMITS=$(git log ${LATEST_TAG}..${COMMIT_HASH}^ --pretty=format:"- %s (%h)" --no-merges | grep -v "chore: update version")
           else
-            COMMITS=$(git log --pretty=format:"- %s (%h)" --no-merges -10)
+            # Get commits excluding version update commits
+            COMMITS=$(git log ${COMMIT_HASH}^ --pretty=format:"- %s (%h)" --no-merges -10 | grep -v "chore: update version")
           fi
           
-          # Get author of the commit
-          COMMIT_AUTHOR=$(git log -1 --pretty=format:"%an <%ae>")
+          # Get author of the version update commit (or HEAD if no version commit)
+          COMMIT_AUTHOR=$(git log -1 --pretty=format:"%an <%ae>" "$COMMIT_HASH")
           
           # Read template and replace placeholders
           TEMPLATE_FILE=".forgejo/release-template.md"
@@ -185,67 +243,21 @@ jobs:
           git config user.name "forgejo-actions"
           git config user.email "forgejo-actions@forgejo.io"
           TAG="${{ steps.version.outputs.tag }}"
+          # Use the version update commit hash (which has the correct version in files)
+          VERSION_COMMIT="${VERSION_COMMIT_HASH:-$(git rev-parse HEAD)}"
+          
           # Check if tag already exists
           if git rev-parse "$TAG" >/dev/null 2>&1; then
             echo "Tag $TAG already exists, skipping tag creation"
             echo "TAG_CREATED=false" >> $GITHUB_ENV
           else
-            git tag -a "$TAG" -F /tmp/release_message.txt
+            # Create tag pointing to the version update commit (which has correct VERSION file)
+            git tag -a "$TAG" -F /tmp/release_message.txt "$VERSION_COMMIT"
             git push origin "$TAG"
-            echo "Created tag $TAG with detailed release notes"
+            echo "Created tag $TAG pointing to version update commit $VERSION_COMMIT with detailed release notes"
             echo "TAG_CREATED=true" >> $GITHUB_ENV
           fi
 
-      - name: Update Version Files
-        run: |
-          VERSION="${{ steps.version.outputs.version }}"
-          TAG="${{ steps.version.outputs.tag }}"
-          
-          echo "📝 Updating version files to: $VERSION"
-          
-          # Configure git
-          git config user.name "forgebot"
-          git config user.email "forgebot@forgejo.io"
-          
-          # Fetch latest changes to avoid conflicts
-          git fetch origin main || echo "Fetch completed or already up to date"
-          git checkout main || echo "Already on main"
-          
-          # Update VERSION file
-          echo "$VERSION" > VERSION
-          
-          # Update portainer.yml with new version
-          sed -i "s|\(image: git.jusemon.com/jusemon/threejs-test:\)[0-9.]*|\1$VERSION|" portainer.yml
-          
-          # Verify the updates
-          if grep -q "^$VERSION$" VERSION && grep -q "image: git.jusemon.com/jusemon/threejs-test:$VERSION" portainer.yml; then
-            echo "✅ Successfully updated VERSION and portainer.yml to $VERSION"
-          else
-            echo "❌ Failed to update version files"
-            exit 1
-          fi
-          
-          # Check if there are changes to commit
-          if git diff --quiet VERSION portainer.yml; then
-            echo "⚠️ No changes to commit (files already up to date)"
-          else
-            # Stage and commit with [skip ci] to prevent infinite loop
-            # Note: Forgejo Actions should respect [skip ci] in commit messages
-            git add VERSION portainer.yml
-            git commit -m "chore: update version to $VERSION [skip ci]" || {
-              echo "⚠️ Commit failed (may already be committed)"
-              exit 0
-            }
-            
-            # Push to main branch (remote should already be configured with token)
-            git push origin main || {
-              echo "⚠️ Push failed (check token permissions)"
-              exit 0
-            }
-            
-            echo "✅ Successfully committed and pushed version update to $VERSION"
-          fi
-
       - name: Job Summary
         if: success()
         run: |

From d8bf72b79dbcac2c1a1c2d88a122d892a909fce0 Mon Sep 17 00:00:00 2001
From: forgebot <forgebot@forgejo.io>
Date: Thu, 27 Nov 2025 04:07:30 +0000
Subject: [PATCH 9/9] chore: update version to 1.0.4 [skip ci]

---
 VERSION       | 2 +-
 portainer.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/VERSION b/VERSION
index 21e8796..ee90284 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-1.0.3
+1.0.4
diff --git a/portainer.yml b/portainer.yml
index 9a6e5e7..0a2fb84 100644
--- a/portainer.yml
+++ b/portainer.yml
@@ -2,7 +2,7 @@ name: threejs-test
 
 services:
   app:
-    image: git.jusemon.com/jusemon/threejs-test:1.0.3
+    image: git.jusemon.com/jusemon/threejs-test:1.0.4
     restart: unless-stopped
 
 networks: