Skip to content

Latest commit

 

History

History
75 lines (43 loc) · 2.6 KB

README.md

File metadata and controls

75 lines (43 loc) · 2.6 KB

Arduino Pool Game for MCUFRIEND TFT Shield

This project implements a simple, physics-based game of pool (billiards) designed specifically for an Arduino Mega (or Uno) paired with an MCUFRIEND TFT touchscreen shield.

1. Hardware Requirements

  • Arduino Board: Arduino Uno or Mega (Mega is recommended for better performance and memory).

  • Display: MCUFRIEND 2.4" - 3.5" TFT Display Shield (ILI9341, etc.).

  • Touch Screen: The shield must have a functional resistive touchscreen overlay.

Required Pin Configuration (as used in the code):

Function Pin (Analog/Digital)
Touch Y+ A1
Touch X- A2
Touch Y- D7
Touch X+ D6

(Note: These are standard pins for most MCUFRIEND shields.)

2. Software Setup

The following libraries must be installed in your Arduino IDE:

  1. Adafruit GFX Library (By Adafruit)

  2. MCUFRIEND_kbv (By David Prentice)

  3. TouchScreen (By Adafruit)

3. Game Features & Controls

Gameplay Overview

The game uses basic collision and friction physics for a simple billiards experience. The goal is to pocket the object balls (colored balls). If the cue ball (white) is pocketed, it automatically respawns at the starting position (the head spot).

Controls (Aiming & Shooting)

The game operates in two states:

  1. STATE_AIMING:

    • Aiming: Press and drag on the screen (starting near the cue ball).

    • Power: The length of the drag determines the shot power. Dragging away from the intended direction sets the vector and power.

    • Shot: Release the touch to fire the cue ball. A strong red line shows the aimed direction.

  2. STATE_MOVING:

    • The physics engine takes over. The balls move, collide, and slow down due to friction.

    • Input is ignored until all balls come to a complete stop.

Difficulty Tweak (Catch Radius)

To make the game easier, the actual area that "catches" the ball into a pocket (CATCH_RADIUS) is larger than the visible black pocket drawn on the screen (POCKET_RADIUS).

  • POCKET_RADIUS (Visual Size): 12

  • CATCH_RADIUS (Physics Size): 18

4. Key Configuration Constants

You can adjust these constants in the code to change the gameplay feel:

Constant Description Value
FRICTION Controls how quickly balls slow down (closer to 1.0 is less friction). 0.985
MAX_POWER Maximum possible speed/force applied by a shot. 14
MAX_DRAG_DIST The drag distance needed to achieve MAX_POWER. 80
BALL_RADIUS Radius of all balls in pixels. 6