AlphaToolsDocs v2.0.0
AlphaToolsStart hereInstallation

Installation

Get AlphaTools running, and update it safely.

On this page

Requirements

WhatNeededNotes
Server softwarePaper or FoliaFolia support is declared and the tools run on region and entity schedulers.
Minecraft1.21.1 or newerJars are built per Minecraft version.
Java21 or 251.21.x servers use Java 21. 26.x servers use Java 25.
NetworkOutgoing HTTPSNeeded for server approval.

Choose the right jar

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

AlphaTools-2.0.0-mc-1.21.1-java21.jar

Use the jar whose mc- part matches your server. A jar built for 26.x is compiled for Java 25 and will not load on Java 21.

Install

  1. Stop the server and put the jar in plugins/.
  2. Start it. The plugin creates plugins/AlphaTools/config.yml and a SQLite database for tool data.
  3. 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.
  4. Test. Run /atools give <you> titan-drill 10m and mine some stone.

Update

  1. Back up plugins/AlphaTools/. The database remembers every tool and who used it last.
  2. Replace the jar and restart. /atools reload never loads a new jar.
Tools already in player hands keep working after an update. Their expiry time is stored on the item itself.