Everything your Paper server needs, held together.
Getting started · Features · Commands · Configuration · Permissions
Rivet is a modular utility suite for modern Paper servers. It brings survival essentials, community tools, staff controls, automation, world management, auditing, and polished visual feedback into one configurable JAR—with no required runtime plugins.
| Area | Highlights |
|---|---|
| Travel & survival | Homes, public warps, spawn, teleport requests, safe random teleportation, graves, kits, backpacks, daily rewards, and portable workstations |
| Players & community | MiniMessage chat, tags, nicknames, mentions, private messages, ignore lists, AFK state, polls, playtime, statistics, and last-seen information |
| Automation & quality of life | Auto breeders, faster hoppers, item magnets, pickup filters, tree felling, vein mining, egg capture, mob heads, and villager trade rerolling |
| World tools | Test worlds, biome search, time and weather controls, inventory scanning, creeper confetti, and crater restoration |
| Staff & moderation | Vanish, flight, inventory tools, moderation history, notes, holograms, boss bars, toasts, and optional local permissions |
| Safety & visibility | SQLite inventory snapshots, searchable backups, configurable retention, and safety-first restores |
Every major system can be switched independently in modules.yml, while feature-specific settings stay separated under settings/. Messages, sounds, particles, titles, boss bars, and other feedback are configurable instead of being buried in code.
| Component | Version |
|---|---|
| Paper | 1.21.11 |
| Java | 21 |
| Required plugins | None |
| Optional integration | PlaceholderAPI |
- Build Rivet with
mvn packageor download a published build. - Place the shaded JAR in the server's
plugins/directory. - Restart Paper.
- Review
plugins/Rivet/modules.ymland the generatedsettings/files. - Use
/rivet reloadafter making reload-safe configuration changes.
Rivet generates a structured plugins/Rivet/ directory:
plugins/Rivet/
├── config.yml # Global presentation and plugin-wide settings
├── modules.yml # Feature switches
├── settings/ # Settings grouped by module or responsibility
└── data/ # Generated persistent state
Do not edit files under data/ while the server is running. The configuration guide explains reload behavior and every settings group.
| Command | What it does |
|---|---|
/help |
Opens permission-aware interactive help |
/sethome |
Creates a personal home |
/setwarp |
Creates a public server warp |
/setspawn |
Sets the server spawn |
/seen |
Shows join, login, logout, and playtime information |
/snapshot |
Browses, searches, exports, and restores inventory backups |
/rivet reload |
Validates and reloads supported settings |
Rivet has an extensive command surface, so the README intentionally stays short. Use the complete command reference for syntax, aliases, permissions, and direct links to every command.
- Feature overview — modules, defaults, and behavior
- Getting started — installation and first configuration
- Commands — complete command reference
- Configuration — file layout and reload rules
- Permissions — permission nodes and defaults
- Building — Maven build and deployment workflow
git clone https://github.com/MineWing/Rivet.git
cd Rivet
mvn packageThe Maven package runs the test suite and writes the deployable shaded JAR to the destination configured in pom.xml. In this workspace, do not use Maven's clean goal.
Rivet uses bStats for anonymous server and player counts. Server owners can opt out globally in plugins/bStats/config.yml.
Built by MineWing · See also EveryBlock and OneMillionCrops