Skip to main content
Get Space Pong up and running on your local machine in just a few minutes. This guide will walk you through downloading the project and playing the game in the Godot Editor.

​
Prerequisites

Before you begin, ensure you have:
  • Godot Engine 4.3 installed on your machine
    • Download from godotengine.org
    • Space Pong is built specifically for Godot 4.3 with Mobile rendering features
  • Basic familiarity with the Godot Editor (optional but helpful)
Space Pong uses the Mobile rendering method optimized for mobile devices, but runs perfectly in the Godot Editor for development and testing.

​
Get Started

1

Clone or Download the Repository

Get the Space Pong source code on your local machine:
git clone https://github.com/Matheusfbio/Space-pong.git
cd Space-pong
Alternatively, download the ZIP file and extract it to your preferred location.
2

Open the Project in Godot

Launch Godot Engine 4.3 and import the project:
  1. Click Import on the Project Manager
  2. Navigate to the Space Pong directory
  3. Select the project.godot file
  4. Click Import & Edit
The project will open in the Godot Editor with the main game scene loaded.
The main scene is located at res://scenes/game.tscn and includes the player paddle, ball, walls, and background.
3

Run the Game

Press F5 or click the Play button in the top-right corner of the editor to launch the game.The game window will open with these display settings:
  • Resolution: 460×720 (mobile portrait orientation)
  • Aspect ratio: Keep height scaling
If this is your first time running the project, Godot may ask you to select the main scene. Choose res://scenes/game.tscn.
4

Play the Game

Once the game window opens, you’ll see the Space Pong arena with your paddle at the bottom and a ball ready to launch.Controls:
  • Press Space to start the game and launch the ball
  • Use Left Arrow and Right Arrow to move your paddle
  • Keep the ball from falling into the hole at the bottom
The paddle only moves after you press Space to start. The ball will launch with a random horizontal angle and speed up each time it bounces!

​
What’s Next?

Now that you have Space Pong running locally, you can:

Explore the Code

Dive into the GDScript code and understand how the game mechanics work

Build for Android

Export the game as an APK and run it on your Android device

Game Mechanics

Learn about the physics and collision system

Project Structure

Understand the project organization and configuration

​
Project Structure

Here’s what you’ll find in the Space Pong directory: 
space-pong/
├── project.godot          # Main project configuration
├── scenes/
│   ├── game.tscn         # Main game scene
│   ├── player.tscn       # Player paddle scene
│   └── ball.tscn         # Ball scene
├── scripts/
│   └── player.gd         # Player movement script
└── sprites/              # Game graphics and textures

​
Troubleshooting

Open Project → Project Settings → Application → Run and ensure the Main Scene is set to res://scenes/game.tscn.
Check that you’re using Godot 4.3 specifically. The project uses features from this version and may not work correctly with older or newer versions.
Verify that the input actions are properly configured in Project → Project Settings → Input Map. The game requires Start (Space key) and the default ui_left/ui_right actions.

​
Need Help?

If you encounter any issues not covered here, check the project’s issue tracker or consult the Godot documentation for troubleshooting specific to the engine.

Build docs developers (and LLMs) love

Get started for freeTalk to us