📐 Camera Configuration (Game Window)

What is it?

In the editor, you can define the width and height of the camera (cameraWidth and cameraHeight). These values determine the size of the game window, meaning the visible area on screen.

Think of the camera as a frame that cuts out which part of the world is visible at any moment. Anything outside this frame won’t be visible, even if it exists in the scene.

📖 Parameters

• cameraWidth: width of the game window (in pixels).
• cameraHeight: height of the game window (in pixels).

✅ Scene Example

{
  "cameraWidth": 640,
  "cameraHeight": 480,
  "cameraFollow": true,
  "backgroundColor": "#000000"
}

👉 This sets a 640×480 game window, a classic 4:3 arcade-style format.

🌍 Platform-Specific Configuration

🎮 PC

• Typical resolutions: 800x600, 1280x720, 1920x1080.
• It’s recommended to keep a standard aspect ratio (16:9 or 4:3) for better monitor compatibility.

📱 Mobile

• Typical resolutions: 720x1280 (vertical), 1080x1920 (vertical) or their horizontal equivalents.
• Depends on whether the game is vertical (endless runners, puzzles) or horizontal (arcades, platformers).

💻 Web / Tablets

• Ideal formats include 1024x768 (4:3) or 1280x800 (16:10).
• You can use letterboxing or scaling to maintain the aspect ratio.

🔧 Best Practices

• Decide early which aspect ratio you want to use (4:3, 16:9, 9:16 vertical).
• Set cameraWidth and cameraHeight in the editor to match that ratio.
• The canvas automatically adjusts to these values.
• In Play mode, the window automatically fits the browser size while maintaining its proportions when enabling fullscreen using the GameCrom icon.

📌 Notes