Merge remote-tracking branch 'origin/master' into release

Author: Project516

.github/workflows/gradle.yml

@@ -28,7 +28,7 @@ jobs:
     # Configure Gradle for optimal use in GitHub Actions, including caching of downloaded dependencies.
     # See: https://github.com/gradle/actions/blob/main/setup-gradle/README.md
     - name: Setup Gradle
-      uses: gradle/actions/setup-gradle@f29f5a9d7b09a7c6b29859002d29d24e1674c884 # v5.0.1
+      uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5.0.2
 
     - name: Build with Gradle Wrapper
       run: ./gradlew build
@@ -61,4 +61,4 @@ jobs:
     # Generates and submits a dependency graph, enabling Dependabot Alerts for all project dependencies.
     # See: https://github.com/gradle/actions/blob/main/dependency-submission/README.md
     - name: Generate and submit dependency graph
-      uses: gradle/actions/dependency-submission@f29f5a9d7b09a7c6b29859002d29d24e1674c884 # v5.0.1
+      uses: gradle/actions/dependency-submission@0723195856401067f7a2779048b490ace7a47d7c # v5.0.2

README.md

@@ -10,7 +10,7 @@ A simple number guessing game where you try to guess a randomly generated number
 
 **Features:**
 - Swing-based GUI (default)
-- Console mode (use `--console` flag)
+- Console mode (use `--console` or `-c`)
 - High score tracking with usernames
 - Persistent score storage
 - Cross-platform
@@ -19,68 +19,78 @@ A simple number guessing game where you try to guess a randomly generated number
 
 ### Installation via Debian Package (APT)
 
-For Debian/Ubuntu and derivatives (recommended for terminal usage):
+For Debian/Ubuntu and derivatives:
 
-1. Download the `.deb` package from the [latest release](https://github.com/Project516/NumberGuessingGame/releases)
+1. Download the `NumberGuessingGame.deb` package from the [latest release](https://github.com/Project516/NumberGuessingGame/releases)
 
    You can use curl to do it from the command line:
    ```bash
-   curl -s -L -o numberguessinggame.deb https://github.com/Project516/NumberGuessingGame/releases/latest/download/numberguessinggame.deb
+   curl -s -L -o NumberGuessingGame.deb https://github.com/Project516/NumberGuessingGame/releases/latest/download/NumberGuessingGame.deb
    ```
 2. Install it:
    ```bash
    sudo apt update # Update packages
-   sudo apt install ./numberguessinggame.deb # From directory with the deb package
+   sudo apt install ./NumberGuessingGame.deb # From directory with the deb package
    sudo apt install -f  # Install dependencies
    echo 'export PATH=$PATH:/usr/games' >> ~/.bashrc # Add games directory to user PATH
    source ~/.bashrc
    ```
-3. Run from anywhere in your terminal:
+3. Run from anywhere in your terminal (launches GUI by default):
    ```bash
-   numberguessinggame
+   NumberGuessingGame
+   ```
+
+   To run in console mode, use the `-c` flag:
+   ```bash
+   numberguessinggame -c
    ```
 
 To uninstall:
 ```bash
-sudo apt remove numberguessinggame
+sudo apt remove NumberGuessingGame
 sudo apt autoremove -y # Remove dependencies
 ```
 
 ### Installation via Fedora/RPM Package (DNF/YUM)
 
 For Fedora, RHEL, CentOS, and other RPM-based distributions:
 
-1. Download the `.rpm` package from the [latest release](https://github.com/Project516/NumberGuessingGame/releases)
+1. Download the `NumberGuessingGame.rpm` package from the [latest release](https://github.com/Project516/NumberGuessingGame/releases)
 
    You can use curl to do it from the command line:
    ```bash
-   curl -s -L -o numberguessinggame.rpm https://github.com/Project516/NumberGuessingGame/releases/latest/download/numberguessinggame.rpm
+   curl -s -L -o NumberGuessingGame.rpm https://github.com/Project516/NumberGuessingGame/releases/latest/download/NumberGuessingGame.rpm
    ```
 2. Install it:
    ```bash
-   sudo dnf install ./numberguessinggame.rpm
+   sudo dnf install ./NumberGuessingGame.rpm
    ```
    Or on older systems:
    ```bash
-   sudo yum install ./numberguessinggame.rpm
+   sudo yum install ./NumberGuessingGame.rpm
    ```
-3. Run from anywhere in your terminal:
+3. Run from anywhere in your terminal (launches GUI by default):
+   ```bash
+   NumberGuessingGame
+   ```
+
+   To run in console mode, use the `-c` flag:
    ```bash
-   numberguessinggame
+   numberguessinggame -c
    ```
 
 To uninstall:
 ```bash
-sudo dnf remove numberguessinggame
+sudo dnf remove NumberGuessingGame
 ```
 Or on older systems:
 ```bash
-sudo yum remove numberguessinggame
+sudo yum remove NumberGuessingGame
 ```
 
 ### Standalone Packages with Bundled JRE (Recommended)
 
-Download the platform-specific package with bundled JRE from the [latest release](https://github.com/project516/numberguessinggame/releases):
+Download the platform-specific package with bundled JRE from the [latest release](https://github.com/project516/NumberGuessingGame/releases):
 
 - **Windows**: `NumberGuessingGame-windows.zip`
 - **macOS**: `NumberGuessingGame-macos.zip`
@@ -96,7 +106,7 @@ Run `run.sh`
 
 ### Manual Installation (Requires Java)
 
-Download the `archive.zip` from the [latest release](https://github.com/project516/numberguessinggame/releases)
+Download the `archive.zip` from the [latest release](https://github.com/project516/NumberGuessingGame/releases)
 
 #### Requirements
 
@@ -138,10 +148,9 @@ The game features both a graphical user interface (GUI) and a console mode.
 To run the classic console version, use the `--console` or `-c` flag:
 
 ```bash
-java -jar app.jar --console
-# or
-./run.sh --console  # Linux/Mac
-run.bat --console   # Windows
+java -jar app.jar --console  # or use -c
+./run.sh --console   # Linux/Mac, can also use -c
+run.bat --console    # Windows, can also use -c
 ```
 
 In console mode:
@@ -154,7 +163,7 @@ In console mode:
 
 ### High Scores
 
-The game automatically tracks high scores (games won with the least guesses). High scores are stored in your home directory at `~/.numberguessinggame/highscores.properties`.
+The game automatically tracks high scores (games won with the least guesses). High scores are stored in your home directory at `~/.NumberGuessingGame/highscores.properties`.
 
 - The top 10 scores are kept
 - Scores are sorted by the number of guesses (least is best)
@@ -195,21 +204,21 @@ 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, README, and LICENSE. The archive can be released to GitHub Releases.
+This will create `archive.zip` containing the application, run scripts, README, and LICENSE.
 
 #### 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.
+This will create `NumberGuessingGame.deb` which can be installed via `apt`/`dpkg` on Debian-based systems.
 
 #### Fedora/RPM Package
 
 **On Linux (requires rpm-build):**
 Run `./package-rpm.sh` from the project root.
 
-This will create `numberguessinggame-1.0.0-1.noarch.rpm` which can be installed via `dnf`/`yum`/`rpm` on Fedora, RHEL, CentOS, and other RPM-based systems. The package can be released to GitHub Releases for easy distribution.
+This will create `NumberGuessingGame.rpm` which can be installed via `dnf`/`yum`/`rpm` on Fedora, RHEL, CentOS, and other RPM-based systems.
 
 #### Platform-Specific Packages with Bundled JRE
 
@@ -222,4 +231,4 @@ Run the following scripts to create platform-specific packages with bundled JRE:
 ./package-linux.sh    # Creates NumberGuessingGame-linux.tar.xz
 ```
 
-These packages include a bundled JRE and do not require Java to be installed on the target system. They are automatically built and uploaded to GitHub Releases via GitHub Actions.
+These packages include a bundled JRE and do not require Java to be installed on the target system.

app/src/main/java/dev/project516/NumberGuessingGame/HighScoreManager.java

@@ -18,7 +18,7 @@
  * scores from persistent storage.
  */
 public class HighScoreManager {
-    private static final String CONFIG_DIR = ".numberguessinggame";
+    private static final String CONFIG_DIR = ".NumberGuessingGame";
     private static final String HIGH_SCORE_FILE = "highscores.properties";
     private static final int MAX_HIGH_SCORES = 10;
 

app/src/test/java/dev/project516/NumberGuessingGame/HighScoreManagerTest.java

@@ -14,7 +14,7 @@
 
 /** Unit tests for the HighScoreManager class. */
 class HighScoreManagerTest {
-    private static final String TEST_CONFIG_DIR = ".numberguessinggame_test";
+    private static final String TEST_CONFIG_DIR = ".NumberGuessingGame_test";
 
     private void cleanup() {
         // Clean up test files

debian-package/usr/games/numberguessinggame

@@ -6,4 +6,4 @@
 
 # Wrapper script to launch Number Guessing Game
 
-java -jar /usr/share/games/numberguessinggame/game.jar --console "$@"
+java -jar /usr/share/games/numberguessinggame/game.jar "$@"