Installation and Build

RAVEN can either be run from the ready-made JAR or compiled manually for your specific platform using Maven.

Option A — Ready to Use (Precompiled)

A precompiled, ready-to-run JAR is generated automatically by GitHub Actions and stored at:

output/raven.jar

Run it directly:

java -jar output/raven.jar

This is the fastest option if you don't need to modify the source code.

mvn clean package -q

JavaFX requires a platform classifier to bundle the correct native libraries.

Linux & Termux

mvn clean package -Djavafx.platform=linux -q

Windows

mvn clean package -Djavafx.platform=windows -q

macOS

mvn clean package -Djavafx.platform=macos -q

BSD

mvn clean package -Djavafx.platform=openbsd -q

After a successful build, the compiled JAR with all dependencies bundled will be located at:

target/raven.jar

Once built (or using the prebuilt JAR), launch the server in one of three modes:

# Web Panel Mode (Default)
java -jar target/raven.jar

# CLI Mode
java -jar target/raven.jar -C

# JavaFX GUI Mode
java -jar target/raven.jar -G

See Interface Modes for details on each.

Problem	Likely Cause	Fix
`UnsupportedClassVersionError`	JDK version too old	Install JDK 17+ and verify with `java -version`
JavaFX native lib errors	Wrong/missing platform classifier	Re-run Maven with the correct `-Djavafx.platform=` flag for your OS
`mvn: command not found`	Maven not installed	Install Maven and ensure it's on your `PATH`
Build hangs on dependency download	Network/proxy issue	Check internet access or configure Maven's `settings.xml` proxy