Mobile Game Development in Godot

# CHAPTER 14

Mobile Game Development in Godot #

1. Introduction #

2. Learning Objectives #

• Configure Project Settings for mobile screen orientations (Portrait vs. Landscape).

• Implement multi-touch input handling via GDScript.

• Use the TouchScreenButton node to create an on-screen D-Pad.

• Ensure Control nodes scale correctly using Anchors and Stretch settings.

• Understand the prerequisites for building an Android .apk.

3. Screen Orientation and Stretching #

• Go to Project -> Project Settings -> Display -> Window.

• Orientation: Choose Landscape (held sideways) or Portrait (held upright).

• Stretch Mode: This is critical. Set it to Canvas Items or Viewport, and set Aspect to Expand or Keep. This ensures that if someone plays your game on a long tablet, the game will automatically zoom and add letterboxing (black bars) instead of stretching your character so they look fat and distorted.

4. Touch Controls (TouchScreenButton) #

• Godot provides a specific node for this: TouchScreenButton.

• It is a 2D node, *not* a Control node.

• The Magic: In the Inspector for the TouchScreenButton, you upload an image of a button, and you assign it an Action string (e.g., type uiaccept or jump).

• In input(event):, you listen for InputEventScreenTouch (finger down/up) and InputEventScreenDrag (finger sliding).

func _input(event):
    if event is InputEventScreenDrag:
        print("Finger is sliding at position: ", event.position)

6. Exporting to Android (The Pipeline) #

1. 1. You must install Android Studio and the Java SDK on your computer.

1. 2. In Godot, go to Editor -> Editor Settings -> Export -> Android and point Godot to the SDK paths.

1. 3. Go to Project -> Export. Click Add -> Android.

1. 4. Generate a debug "Keystore" (a digital signature proving you made the game).

1. 5. Click Export Project. It will generate an .apk file that you can transfer to your phone and install.

7. Visual Learning: On-Screen Mobile Layout #

+-----------------------------------------------------------+
| [HUD: Hearts]                               [HUD: Score]  |
|                                                           |
|                                                           |
|                          [PLAYER]                         |
|                                                           |
|                                                           |
|    ^                                                      |
|  < + > (D-Pad: TouchScreenButtons)           (O) (Jump)   |
|    v                                                      |
+-----------------------------------------------------------+

*Because TouchScreenButtons map directly to Input Actions, pressing (O) triggers the exact same Input.isactionpressed("jump") code as pressing the Spacebar on a PC.*

8. Best Practices #

• Emulate Touch from Mouse: Testing on a physical phone every 5 minutes is annoying. Go to Project -> Project Settings -> Input Devices -> Pointing and check Emulate Touch From Mouse. Now, clicking your mouse in the Godot Editor simulates a finger touch, allowing you to test mobile controls instantly on your PC.

9. Common Mistakes #

• UI Off-Screen on Notched Phones: Modern iPhones and Androids have physical "Notches" or camera hole-punches that cover the screen. If you anchor your Pause Button to the absolute Top-Left corner, it might be hidden under the camera lens. Always leave a "Safe Area" margin when designing mobile UI.

10. Mini Project: Build a Virtual Joystick #

1. 1. In your Player Scene, add a CanvasLayer node (so the controls follow the camera).

1. 2. Add a TouchScreenButton child. Add a circle graphic to its Texture.

1. 3. In its Inspector, under Action, type the exact name of your jump action (e.g., uiup).

1. 4. Add two more TouchScreenButton nodes for Left and Right. Map them to uileft and ui_right.

1. 5. Position them in the bottom corners of the screen.

1. 6. Enable "Emulate Touch From Mouse" in the Project Settings.

1. 7. Press Play. Click the on-screen buttons with your mouse. Your character will run and jump as if you were pressing the keyboard!

11. Practice Exercises #

1. 1. What project setting must you change to prevent your 16:9 game from looking stretched and distorted when played on a 21:9 ultra-wide smartphone?

1. 2. How does the TouchScreenButton node communicate with your existing character movement code without requiring you to rewrite the script?

12. MCQs with Answers #

13. Interview Questions #

• Q: Walk me through the architecture of converting a PC keyboard-controlled platformer to a Mobile game in Godot using TouchScreenButton nodes. Why is this method superior to rewriting the player script?

• Q: Explain the difference between InputEventScreenTouch and InputEventScreenDrag. In what type of mobile game would you need to access these raw events instead of using virtual buttons?

• Q: What is the "Stretch Mode" in Godot's window settings, and why is the "Keep Aspect" setting absolutely critical for modern mobile game development?

14. FAQs #

15. Summary #

16. Next Chapter Recommendation #