Installation Guide

Quick Installation

What the Installer Does

The install.bat script automatically configures your system:

Manual Installation

If you prefer to set up Forge manually without running the installer:

Step 1: Set FORGE_HOME

Open Command Prompt as Administrator and run:

setx FORGE_HOME "C:\Program Files\forge"

Step 2: Add to PATH

Run this command to append Forge to your PATH:

setx PATH "%PATH%;%FORGE_HOME%\bin"

Step 3: Restart Terminal

Close and reopen your terminal for changes to take effect.

Verify Installation

Test that Forge is installed correctly:

forge version
forge help

Directory Structure

After extraction, your Forge directory will look like this:

forge/
├── bin/                    # Scripts (added to PATH)
│   ├── forge.bat
├── lib/                    # JAR files
│   └── forger-1.2.9.jar
├── docs/
│   └── README.md
└── install.bat             # Installation script

Troubleshooting

Problem: "forge is not recognized"

The command forge is not found. Try these steps:

1. Check if FORGE_HOME is set: echo %FORGE_HOME%
2. Check if it's in PATH: echo %PATH%
3. Re-run the installer: %FORGE_HOME%\install.bat
4. Restart your terminal completely

Problem: "Java is not installed or not in PATH"

Forge requires Java 21 or later. Install it from Adoptium:

java -version
javac -version

Both commands should work and show Java 21+.

Problem: Permission Denied

Forge installation requires Administrator privileges. Make sure to:

1. Right-click install.bat
2. Select "Run as administrator"

Next Steps

Once installed, check out the Documentation to learn how to:

• Create your first build.forge file
• Use Groovy and Kotlin DSL syntax
• Manage dependencies and repositories
• Run common build commands