Installing RankForge on Paper, Purpur & Folia

This guide walks you through installing RankForge from scratch until it is fully active on your Minecraft server.

Official Download

RankForge is Closed Source (Proprietary) software. Official, verified, and secure .jar releases are distributed exclusively via Modrinth:

Download RankForge on ModrinthGet the latest stable release of RankForge for Paper, Purpur, and Folia.

Server Requirements

• A Paper, Purpur, or Folia server running version 1.21+.
• Java 21 or newer (verify via java -version).
• Access to the server’s plugins/ directory (via SFTP, game panel, or file explorer).

Standard Spigot / CraftBukkit

RankForge relies on modern Paper API enhancements and Folia regionized threading. Standard Spigot or CraftBukkit are not officially supported.

Installation Steps

1. Download the plugin file from Modrinth

   Visit the RankForge Modrinth Page and download the latest .jar file (e.g. RankForge-1.0.0.jar).

2. Place in the plugins/ directory

   Upload the downloaded JAR file directly into your server’s plugins/ directory.

   • Directoryserver/

     • Directoryplugins/

       • RankForge-1.0.0.jar
     • paper.jar
     • server.properties

3. Install optional integrations (recommended)

   Plugin	Purpose	Type
   PlaceholderAPI	Enables %rankforge_*% placeholders for Scoreboard, TAB, & Holograms	Soft Dependency
   PacketEvents	Powers the interactive Virtual Sign GUI for in-game player searching	Soft Dependency

   Note: RankForge runs completely fine without these plugins.

4. Start or Restart your server

   Start the server. Do not use /reload as it can cause thread leaks in database connection pools. Always perform a clean restart (/stop then start).

5. Verify in console

   Check your server boot logs. You should see output similar to:

   [RankForge] Enabling RankForge v1.0.0
   [RankForge] Running on: Paper (Compatible)
   [RankForge] Loaded 10 tiers from config.
   [RankForge] Connected to storage: SQLite (rankforge.db)
   [RankForge] RankForge has been successfully enabled!

   Run the version command in console or in-game (with OP permission):

   /rankforge version

Updating RankForge

When an update is released on Modrinth:

1. Stop the server (/stop).
2. Make a backup of your plugins/RankForge/ folder (especially your database files).
3. Replace the old JAR file in plugins/ with the new JAR from Modrinth.
4. Restart the server and monitor the console output.

Tip

Existing configuration files (config.yml, gui.yml) are not overwritten automatically.

Next Steps

Head over to First Setup to configure your default language, database engine, and staff permissions.