Arcade Badminton 3D

Prototype Godot 4 project for a macOS-playable 3D arcade badminton game. The design target is Pong with 3D court movement: readable rallies, simple controls, solo play against AI, and a clean path to native Mac export.

Current State

This repo now contains:

• A Godot 4 project scaffold rooted at project.godot
• Playable scene flow from menu to match and back
• Core rally systems for shuttle flight, player movement, AI movement, scoring, pause, and match end
• Placeholder 3D court and character scenes
• Headless smoke-test scripts for rules and simulation logic

Controls

• A / D: move left and right across the court
• W / S: move into and out of court depth
• Space: swing or serve
• Left Shift + Space: lob / clear
• Esc: pause during a match

The first playable keeps the controls intentionally simple. Smashes are biased from aggressive forward movement timing rather than a dedicated button.

Running In Godot

1. Install a Godot 4.x editor or export template build.
2. Open this folder in Godot.
3. Run the main scene or launch the project directly.

The main scene is scenes/MainMenu.tscn.

Headless Smoke Tests

If godot4 is installed locally, run:

godot4 --headless -s tests/headless/test_runner.gd

This executes logic-level checks for:

• score rules
• shot profile tuning
• landing prediction

macOS Export

A starter macOS preset is included in export_presets.cfg with Apple Silicon enabled first. Before distributing a real .app, fill in signing and notarization values for your Apple developer account.

Manual Acceptance Checklist

• Launch the project and start a match from the menu.
• Verify the player and AI remain on their own court halves.
• Rally until one side wins a game.
• Confirm Esc pauses and resumes the match without advancing the shuttle.
• Confirm the end screen can restart the match or return to the menu.