Add Debian package support for apt installation

Co-authored-by: Project516 <138796702+Project516@users.noreply.github.com>

Author: Copilot

.gitignore

@@ -23,4 +23,5 @@ gradle-app.setting
 # Ignore Gradle build output directory
 build
 
-archive.zip
+archive.zip
+numberguessinggame.deb

README.md

@@ -2,13 +2,35 @@
 
 A simple number guessing game where you try to guess a randomly generated number. The game will tell you if your guess is too high or too low until you find the correct number.
 
-## Running the Game
+## Installation & Running
+
+### Installation via Debian Package (Linux)
+
+For Debian/Ubuntu and derivatives (recommended for terminal usage):
+
+1. Download the `.deb` package from the [latest release](https://github.com/Project516/NumberGuessingGame/releases)
+2. Install it:
+   ```bash
+   sudo dpkg -i numberguessinggame.deb
+   sudo apt-get install -f  # Install dependencies if needed
+   ```
+3. Run from anywhere in your terminal:
+   ```bash
+   numberguessinggame
+   ```
+
+To uninstall:
+```bash
+sudo dpkg -r numberguessinggame
+```
 
-### Requirements
+### Manual Installation
+
+#### Requirements
 
 - Java 8 or higher (may require Java 17+ in future versions)
 
-### How to Run
+#### How to Run
 
 **On Windows:**
 Run `run.bat`
@@ -55,7 +77,9 @@ gradle build
 gradle test
 ```
 
-### Creating Release Archive
+### Creating Release Archives
+
+#### Zip Archive
 
 **On Windows:**
 Run `.\gradlew build` and `package.bat` from the project root.
@@ -64,3 +88,10 @@ Run `.\gradlew build` and `package.bat` from the project root.
 Run `./package.sh` from the project root.
 
 This will create `archive.zip` containing the application, run scripts, and README. The archive can be released to GitHub Releases.
+
+#### Debian Package
+
+**On Linux:**
+Run `./package-deb.sh` from the project root.
+
+This will create `numberguessinggame.deb` which can be installed via `apt`/`dpkg` on Debian-based systems. The package can be released to GitHub Releases for easy distribution.

debian-package/DEBIAN/control

@@ -0,0 +1,11 @@
+Package: numberguessinggame
+Version: 1.0.0
+Section: games
+Priority: optional
+Architecture: all
+Depends: default-jre | java8-runtime
+Maintainer: Project516 <project516@github.com>
+Description: A simple number guessing game
+ A simple number guessing game where you try to guess a randomly
+ generated number. The game will tell you if your guess is too high
+ or too low until you find the correct number.

debian-package/DEBIAN/postinst

@@ -0,0 +1,7 @@
+#!/bin/sh
+set -e
+
+# Make the game executable
+chmod +x /usr/games/numberguessinggame
+
+exit 0

debian-package/usr/games/numberguessinggame

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Wrapper script to launch Number Guessing Game
+
+java -jar /usr/share/games/numberguessinggame/game.jar "$@"

debian-package/usr/share/games/numberguessinggame/.gitignore

@@ -0,0 +1,4 @@
+# Ignore all files in this directory (they are generated during build)
+*
+# But not this file
+!.gitignore

package-deb.sh

@@ -0,0 +1,43 @@
+#!/bin/sh
+# Script to create a Debian package (.deb) for Number Guessing Game
+
+set -e
+
+echo "Building Number Guessing Game Debian package..."
+
+# Clean up previous builds
+rm -rf debian-package/usr/share/games/numberguessinggame/*
+rm -f numberguessinggame.deb
+
+# Build the application
+echo "Building application..."
+cd app
+gradle build
+cd ..
+
+# Copy the jar file
+echo "Copying files to package directory..."
+cp app/build/libs/app.jar debian-package/usr/share/games/numberguessinggame/game.jar
+
+# Copy documentation
+cp README.md debian-package/usr/share/games/numberguessinggame/README.md
+cp LICENSE debian-package/usr/share/games/numberguessinggame/LICENSE
+
+# Set permissions
+chmod 755 debian-package/DEBIAN/postinst
+chmod 755 debian-package/usr/games/numberguessinggame
+
+# Build the .deb package
+echo "Building .deb package..."
+dpkg-deb --build debian-package numberguessinggame.deb
+
+echo ""
+echo "✓ Debian package created: numberguessinggame.deb"
+echo ""
+echo "To install, run:"
+echo "  sudo dpkg -i numberguessinggame.deb"
+echo "  sudo apt-get install -f  # to install any missing dependencies"
+echo ""
+echo "After installation, run the game with:"
+echo "  numberguessinggame"
+echo ""