Installation
Requirements, step-by-step install, first run, and the plugin folder layout.
This page gets HoeWars running on your server. For download links see Download.
Requirements
| Requirement | Detail |
|---|---|
| Server software | Spigot, Paper, or Purpur |
| Minecraft | 1.16.5 and newer |
| Java | 11 or newer on the server |
| Internet on first start | Yes (see note below) |
The first server start needs internet access. HoeWars downloads three small libraries (XSeries, HikariCP, and the SQLite driver) from Maven Central and caches them under your server's libraries/ folder. Later starts work offline.
Install
Stop the server
Shut it down fully before adding the jar.
Drop in the jar
Move the HoeWars jar into your plugins/ folder.
Start the server
Start it with internet access. HoeWars fetches its libraries, generates its config files, and creates the SQLite database.
Build your first arena
The plugin ships with no arenas. Follow the Arenas guide to create one, mark the floor, set spawns, and save a template.
Set your lobby
Stand where players should return after matches and run /hoe setlobby.
Plugin folder layout
After the first start your folder looks like this:
config.ymlcontrols storage, match sizes, ranks, and visuals. See Configuration.messages.ymlholds every chat message. See Messages and Language.scoreboard.ymlcontrols the in-game scoreboard and tab list.hoewars.dbis the default SQLite database. See Storage and Data.arenas/holds one YAML file per arena (spawns, mode, settings).templates/holds the saved floor of each arena in a compact binary format.
Optional integrations
These plugins are detected automatically when present. None are required.
| Plugin | What it adds |
|---|---|
| PlaceholderAPI | Placeholders for scoreboards and tab plugins. See Placeholders. |
| Vault | Economy hook for future features. |
| WorldEdit / FastAsyncWorldEdit | Faster arena template pastes when present. |
| LuckPerms | Permission management. See Permissions. |
Verify it loaded
Run /hoe in game. The main menu should open. If it does not, check the FAQ for common fixes on the FAQ page.