Frogger Arcade Game

This repository contains a refactored JavaFX Frogger clone originally built as a high school project. The codebase is now organized into standard source, resource, script, and test directories so the gameplay rules are easier to follow and the project is easier to run.

Game Logic

• The frog starts at the bottom center of the board and moves one grid step at a time.
• WASD and the arrow keys both work for movement.
• Reaching a new highest row awards 10 points.
• Filling an unclaimed home slot awards 50 points.
• Being hit by a vehicle or drowning costs 50 points, without letting the score go below 0.
• The round is won after all five home slots are filled.

Repository Layout

src/
  main/
    java/com/hirish/frogger/        JavaFX application, world, actors, config
    resources/assets/               Images and audio loaded from the classpath
  test/
    java/com/hirish/frogger/        Logic-only automated tests
scripts/
  test.sh                           Runs the logic test suite
  setup-javafx.sh                   Downloads repo-local JavaFX jars
  compile.sh                        Compiles the JavaFX application
  verify.sh                         Runs tests, then compiles the app
  package.sh                        Builds a downloadable zip bundle
  run-game.sh                       Compiles and launches the game
docs/
  images/gameplay.png               Screenshot used in this README

Requirements

• JDK 11 or newer
• make
• curl if you want the repo to download JavaFX locally

Quick Start

make run

On first run, make run downloads repo-local JavaFX jars into .javafx/, compiles the project, and launches the game.

Common Commands

Run the logic tests:

make test

Run the full verification path:

make verify

Download JavaFX explicitly:

make setup-javafx

Compile without launching:

make compile

Build a downloadable zip for your current platform:

make package

If you already have JavaFX installed elsewhere, you can still bypass the repo-local download and point JAVAFX_LIB at its lib directory:

JAVAFX_LIB=/path/to/javafx-sdk/lib make run

Downloadable Builds

This repo now includes a GitHub Actions workflow at .github/workflows/build-downloads.yml that builds downloadable zip archives for:

• Linux x64
• Windows x64
• macOS Intel
• macOS Apple Silicon

Each archive contains:

• frogger.jar
• the matching JavaFX runtime jars for that platform
• run-frogger.sh
• run-frogger.bat

You can generate a bundle locally with make package, or run the Build Downloads workflow from the Actions tab and download the artifacts from the workflow run.

Permanent Download Links

Published releases now use GitHub Releases, so the latest downloadable builds can live at stable URLs:

• macOS Intel: https://github.com/hirish99/Frogger-Arcade-Game/releases/latest/download/frogger-mac-x64.zip
• macOS Apple Silicon: https://github.com/hirish99/Frogger-Arcade-Game/releases/latest/download/frogger-mac-aarch64.zip
• Windows x64: https://github.com/hirish99/Frogger-Arcade-Game/releases/latest/download/frogger-win-x64.zip
• Linux x64: https://github.com/hirish99/Frogger-Arcade-Game/releases/latest/download/frogger-linux-x64.zip

The release publishing workflow is defined in .github/workflows/release-downloads.yml.

To publish a release:

1. Push a version tag such as v1.0.0.
2. Or run the Publish Release Downloads workflow manually from the Actions tab and provide a version tag.

After the workflow finishes, users can download the game from the repository’s Releases page:

• https://github.com/hirish99/Frogger-Arcade-Game/releases