AlphaRewardsStart hereInstallation

Installation

Get AlphaRewards running, and update it without losing player progress.

On this page

Requirements
Choose the right jar
Install
Update

Requirements

What	Needed	Notes
Server software	Paper or Folia	Folia support is declared in `plugin.yml`, and the plugin logs when it detects Folia.
Minecraft	1.21.4 or newer	Jars are built per Minecraft version, see Choose the right jar.
Java	21 or 25	1.21.x servers use Java 21. 26.x servers use Java 25.
Network	Outgoing HTTPS	Needed for server approval.
Economy plugin	For money rewards	The shipped rewards run `money give` as a console command, which CMI provides.

Choose the right jar

Each release is built once per Minecraft version, and the file name says which one:

AlphaRewards-<version>-mc-<minecraft>-java<java>.jar

AlphaRewards-2.0.0-mc-26.2-java25.jar

Use the jar whose mc- part matches your server. Jars for 1.21.x need Java 21 and jars for 26.x need Java 25.

Install

Stop the server and put the jar in plugins/.
Start it. The plugin writes config.yml, messages.yml and the menus/ files into plugins/AlphaRewards/.
Get approved. A new server is pending and the plugin stays off. The console prints your server id. Send it to AlphaStudio, wait for approval and restart. See Server approval.
Open the menu. Run /rewards in game.

Update

Back up plugins/AlphaRewards/. playerdata/ holds every player's progress.
Replace the jar and restart. /alpharewards reload never loads a new jar.
Keep your files. Existing config, message and menu files are left as they are, and a missing config.yml is created on first start.

Upgrading from 1.x: license keys no longer exist. 2.0.0 needs the server to be approved in the AlphaStudio panel, and an unapproved server will not run the plugin. Read Server approval before updating a live server.