Merge branch 'master' into release

Author: Project516

.github/workflows/release.yml

@@ -0,0 +1,41 @@
+name: Build and Upload Release Assets
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up JDK 25
+        uses: actions/setup-java@v5
+        with:
+          java-version: '25'
+          distribution: 'temurin'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v5
+
+      - name: Build JAR with Gradle
+        run: ./gradlew build
+
+      - name: Build Debian package
+        run: ./package-deb.sh
+
+      - name: Build ZIP archive
+        run: ./package.sh
+
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            ./app/build/libs/app.jar
+            ./numberguessinggame.deb
+            ./archive.zip

.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,36 @@
 
 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 apt update # Update packages
+   sudo apt install ./numberguessinggame.deb # From directory the deb package is in
+   sudo apt install -f  # Install dependencies if needed
+   ```
+3. Run from anywhere in your terminal:
+   ```bash
+   numberguessinggame
+   ```
+
+To uninstall:
+```bash
+sudo apt remove 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,12 +78,21 @@ gradle build
 gradle test
 ```
 
-### Creating Release Archive
+### Creating Release Archives
+
+#### Zip Archive
 
 **On Windows:**
-Run `.\gradlew build` and `package.bat` from the project root.
+Run `.\gradlew build` and `.\package.bat` from the project root.
 
 **On Linux/Mac:**
 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.
+This will create `archive.zip` containing the application, run scripts, README, and LICENSE. 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.

app/src/main/java/io/github/project516/NumberGuessingGame/DebugInfo.java

@@ -6,7 +6,7 @@ public class DebugInfo {
     ReadVersionFile vFile = new ReadVersionFile();
 
     void launchDebug() {
-        System.out.println("===== DEBUG INFO =====\n\n");
+        System.out.println("\n===== DEBUG INFO =====\n\n");
         System.out.println("Java version: " + sysInfo.version());
         System.out.println("Vendor: " + sysInfo.vendor());
         System.out.println("JDK name: " + sysInfo.name());
@@ -15,6 +15,6 @@ void launchDebug() {
     }
 
     void gameCrash() {
-        System.out.println("\n\n=====Program Crashed!=====\n\n");
+        System.out.println("\n\n===Program Crashed!===\n\n");
     }
 }

app/src/main/java/io/github/project516/NumberGuessingGame/GUI.java

@@ -0,0 +1,26 @@
+package io.github.project516.NumberGuessingGame;
+
+import java.awt.*;
+import javax.swing.*;
+
+// TODO
+
+public class GUI {
+    void createWindow() {
+        JFrame jframe = new JFrame("Number Guessing Game");
+        JLabel jlabel = new JLabel("Number Guessing Game", SwingConstants.CENTER);
+        // JButton jbutton = new JButton("Start game!");
+
+        jframe.getContentPane().add(jlabel, BorderLayout.CENTER);
+
+        jframe.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE); // Exit on close
+        jframe.setSize(300, 300);
+
+        jframe.setVisible(true); // Set visible
+    }
+
+    public static void main(String[] args) { // Test GUI
+        GUI GUI = new GUI();
+        GUI.createWindow();
+    }
+}

app/src/main/java/io/github/project516/NumberGuessingGame/GameInfo.java

@@ -5,4 +5,16 @@ void about() {
         System.out.println("This is a Number Guessing Game!");
         System.out.println("Guess a number between 1 and 100!\n");
     }
+
+    String author() {
+        return "project516";
+    }
+
+    String projectURL() {
+        return "https://github.com/project516/numberguessinggame";
+    }
+
+    String onlineJavadoc() {
+        return "https://project516.github.io/NumberGuessingGame";
+    }
 }

app/src/main/java/io/github/project516/NumberGuessingGame/GameLogic.java

@@ -0,0 +1,31 @@
+package io.github.project516.NumberGuessingGame;
+
+public class GameLogic {
+    // TODO port game logic from Main to GameLogic
+    void game() {
+
+        RandomNumber ranNumber = new RandomNumber();
+        int number = ranNumber.number(100);
+        int numOfGuesses = 0;
+        ScannerHelper scan = new ScannerHelper();
+        CheckGuess check = new CheckGuess();
+
+        while (true) {
+
+            System.out.print("Guess a number: ");
+            int guess = scan.userGuess();
+            check.check(guess);
+            if (guess > number) {
+                System.out.println("You guessed to much!");
+            } else if (guess < number) {
+                System.out.println("You guessed to little!");
+            } else {
+                numOfGuesses++;
+                System.out.println("Took you " + numOfGuesses + " guesses!");
+                scan.close();
+                break;
+            }
+            numOfGuesses++;
+        }
+    }
+}

app/src/main/java/io/github/project516/NumberGuessingGame/Main.java

@@ -4,37 +4,17 @@ public class Main {
 
     public static void main(String[] args) {
 
-        int numOfGuesses = 0;
-
         ScannerHelper scan = new ScannerHelper();
-        RandomNumber ranNumber = new RandomNumber();
-        CheckGuess check = new CheckGuess();
         DebugInfo debugInfo = new DebugInfo();
         GameInfo gameInfo = new GameInfo();
+        GameLogic logic = new GameLogic();
 
         debugInfo.launchDebug();
 
         try {
-            int number = ranNumber.number(100);
-            gameInfo.about();
 
-            while (true) {
-
-                System.out.print("Guess a number: ");
-                int guess = scan.userGuess();
-                check.check(guess);
-                if (guess > number) {
-                    System.out.println("You guessed to much!");
-                } else if (guess < number) {
-                    System.out.println("You guessed to little!");
-                } else {
-                    numOfGuesses++;
-                    break;
-                }
-                numOfGuesses++;
-            }
-
-            System.out.println("Took you " + numOfGuesses + " guesses!");
+            gameInfo.about();
+            logic.game();
 
         } catch (Exception e) {
 

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.progress139@slmail.me>
+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