Command Reference

⌨️ Command reference

This page covers all 90 Rivet commands.

Reading command syntax

• <value> is required.
• [value] is optional.
• Do not type the angle or square brackets.
• OP means the permission defaults to server operators.
• Everyone means the permission defaults to all players.
• Most player targets must be online and visible to the sender.

Staff and administration

Command	What it does	Permission	Default
/gmc	Switches you to Creative mode	rivet.gamemode	OP
/gms	Switches you to Survival mode	rivet.gamemode	OP
/tp <player>	Teleports you to an online player	rivet.teleport	OP
/vanish or /v	Toggles vanish	rivet.vanish	OP
/fly	Toggles permission to fly	rivet.fly	OP
/flyspeed [player] <amount>	Sets flight speed from -1.0 to 1.0	rivet.flyspeed	OP
/heal [player]	Restores health and clears fire and freezing	rivet.heal	OP
/feed [player]	Restores hunger and saturation	rivet.feed	OP
/god [player] [true or false] [-s]	Toggles or explicitly sets invulnerability	rivet.god	OP
/bossbarmsg <player or all> [flags] <message>	Shows a timed MiniMessage boss bar	rivet.bossbarmsg	OP
/note <player> add <text>	Adds a timestamped staff note	rivet.notes	OP
/note <player> list	Lists a player's staff notes	rivet.notes	OP
/note <player> remove <id>	Removes one staff note by ID	rivet.notes	OP
/note <player> clear [confirm]	Clears all notes after confirmation	rivet.notes	OP
/sameip [player]	Lists visible online players sharing a session address	rivet.sameip	OP
/toast <player or all> [flags] <message>	Shows a temporary advancement toast	rivet.toast	OP
/rivet	Shows basic Rivet information	rivet.admin	OP
/rivet reload	Validates and reloads configuration	rivet.admin	OP
/help [page], /rivethelp or /rhelp	Shows commands available to the sender	rivet.help	Everyone

Extra permission checks:

• rivet.flyspeed.others changes another player's flight speed.
• rivet.heal.others, rivet.feed.others and rivet.god.others target another player.
• rivet.vanish.see lets a viewer see vanished players.
• -s suppresses /god feedback to both the actor and target.

Boss bar flags may appear before the message in any order:

Flag	Meaning	Values
-d:<seconds>	Display time	More than 0, up to 3600
-c:<color>	Bar colour	pink, blue, red, green, yellow, purple, white
-s:<style>	Bar segments	solid, segmented_6, segmented_10, segmented_12, segmented_20

Example:

/bossbarmsg all -d:15 -c:red -s:segmented_10 <red><bold>Server restarting soon

Toast flags are -t:task, -t:goal or -t:challenge, plus -icon:<item>. Staff notes use known online or cached player profiles and are saved by UUID.

Worlds, time and weather

Command	What it does	Permission	Default
/flat	Creates or enters the legacy world named flat	rivet.flat	OP
/flatworld create <name>	Creates a tracked flat test world	rivet.world	OP
/flatworld tp <name>	Loads and enters a tracked test world	rivet.world	OP
/flatworld reset <name>	Rebuilds a tracked flat world from scratch	rivet.world	OP
/flatworld list	Lists tracked flat and void worlds; names are clickable	rivet.world	OP
/voidworld create <name>	Creates a tracked empty world	rivet.world	OP
/worldspawn	Teleports to the current world's spawn	rivet.world	OP
/setworldspawn	Sets the current world's spawn to your location	rivet.world	OP
/killall	Removes every Mob in the current world	rivet.world	OP
/findbiome <biome>	Searches asynchronously for the nearest matching biome	rivet.findbiome	Everyone
/top [player]	Moves a player to the highest safe position in their current column	rivet.top	OP
/tree <tree-type>	Generates a vanilla tree above the targeted block	rivet.tree	OP
/day	Sets the current world to day	rivet.environment	OP
/noon	Sets the current world to noon	rivet.environment	OP
/night	Sets the current world to night	rivet.environment	OP
/midnight	Sets the current world to midnight	rivet.environment	OP
/sun	Clears rain and thunder	rivet.environment	OP
/rain	Starts rain	rivet.environment	OP
/thunder	Starts a thunderstorm	rivet.environment	OP

Caution

/flatworld reset <name> unloads the selected flat world and regenerates it. Players inside are moved to another loaded world first. Anything built in the reset world is lost.

World names may contain letters, numbers, _ and -, with a maximum length of 32 characters.

Targeting another player with /top needs rivet.top.others.

Homes, warps and travel

Command	What it does	Permission	Default
/sethome [name]	Saves your current position and facing	rivet.home	Everyone
/home [name]	Teleports to one of your homes	rivet.home	Everyone
/delhome [name]	Removes one of your homes	rivet.home	Everyone
/setwarp <name>	Creates or replaces a public warp	rivet.warp.set	OP
/warp <name>	Teleports to a public warp	rivet.warp	Everyone
/delwarp <name>	Removes a public warp	rivet.warp.set	OP
/spawn	Teleports to the Rivet server spawn	rivet.spawn	Everyone
/setspawn	Sets the Rivet server spawn	rivet.spawn.set	OP
/tpa <player>	Requests to teleport to a player	rivet.tpa	Everyone
/tpahere <player>	Requests that a player teleport to you	rivet.tpa	Everyone
/tpaccept [player]	Accepts an incoming request	rivet.tpa	Everyone
/tpdeny [player]	Denies an incoming request	rivet.tpa	Everyone
/back	Returns to your latest death location	rivet.back	Everyone
/rtp [world]	Finds a safe random location	rivet.rtp	Everyone
/near	Lists nearby visible players by distance	rivet.near	Everyone

Travel notes:

• Leaving the home name out uses the name home.
• TPA requests expire, have a sender cooldown and can use a movement-cancelled warm-up.
• If several requests are waiting, /tpaccept and /tpdeny require a player name.
• /rtp <world> additionally needs rivet.rtp.world.
• rivet.rtp.cooldown.bypass skips the random-teleport cooldown.
• /back saves the exact world, position and facing from the player's latest death.

Chat, identity and AFK

Command	What it does	Permission	Default
/msg <player> <message>	Sends a private message	rivet.message	Everyone
/r <message>	Replies to the last private-message partner	rivet.message	Everyone
/socialspy or /ss	Toggles viewing other players' private messages	rivet.socialspy	OP
/ignore <player>	Toggles a player in your private-message ignore list	rivet.ignore	Everyone
/ignore list	Lists ignored players	rivet.ignore	Everyone
/ignore clear	Clears the ignore list	rivet.ignore	Everyone
/chatcolor <color or reset>	Sets your persistent chat colour	rivet.chatcolor	Everyone
/chatcolor <player> <color or reset>	Sets another player's chat colour	rivet.chatcolor.others	OP
/afk [reason] [-p:<player>] [-s]	Toggles AFK status	rivet.afk	Everyone
/afkcheck [player or all]	Shows AFK state, duration and reason	rivet.afkcheck	Everyone
/nick <nickname or off>	Sets or clears your nickname	rivet.nick	Everyone
/nick <player> <nickname or off>	Changes another player's nickname	rivet.nick.others	OP
/stats [player]	Shows native Paper statistics	rivet.stats	Everyone
/playtime [player]	Shows native Paper playtime only	rivet.playtime	Everyone
/me <message>	Broadcasts an action message to visible, non-ignoring players	rivet.me	Everyone
/list	Lists visible online players using display names	rivet.list	Everyone
/ping [player]	Shows latency and a quality label	rivet.ping	Everyone

Chat colour examples:

/chatcolor <gold>
/chatcolor <#55ffff>
/chatcolor <gradient:red:gold>
/chatcolor <rainbow>
/chatcolor reset

Only one safe colour tag is accepted. Gradients and rainbow need rivet.chatcolor.advanced. Command, click, hover and insertion tags are rejected. Hex, gradients and rainbow can also be disabled in settings/chat.yml.

Other checks:

• rivet.ignore.bypass delivers private messages even when the sender is ignored.
• rivet.afk.others enables -p:<player>.
• rivet.afk.silent enables -s, which changes AFK state without broadcasting it.
• rivet.afkcheck.others enables player targets and all.
• rivet.nick.format allows safe colour and decoration tags in nicknames.
• rivet.stats.others allows another online or cached offline player to be inspected.
• rivet.playtime.others and rivet.ping.others allow player targets.
• rivet.me.format allows colour and decoration tags in /me text.

Inventory and item tools

Command	What it does	Permission	Default
/clear [player] [item[:amount][;plain]] [-s]	Clears a whole inventory or matching items	rivet.inventory	OP
/i <item> [amount]	Gives you an item; the default amount is 64	rivet.inventory	OP
/condense	Converts supported plain materials into storage blocks	rivet.condense	Everyone
/donate <player> [amount]	Gives held items to another online player	rivet.donate	Everyone
/giveall <item> [amount]	Gives an item to every online player	rivet.giveall	OP
/invsee <player>	Opens an online player's live inventory	rivet.inventory.invsee	OP
/enderchest [player] or /ec	Opens your or another online player's ender chest	rivet.inventory.enderchest	Everyone
/repair [all]	Repairs the held item or all damaged carried equipment	rivet.repair	OP
/rename <name or clear>	Changes the held item's display name	rivet.rename	OP
/lore add <text>	Appends a lore line to the held item	rivet.lore	OP
/lore set <line> <text>	Replaces an existing 1-based lore line	rivet.lore	OP
/lore remove <line>	Removes an existing lore line	rivet.lore	OP
/lore clear	Removes all lore	rivet.lore	OP
/trash	Opens a disposable inventory	rivet.trash	Everyone
/backpack or /bp	Opens personal persistent storage	rivet.backpack	Everyone
/head <player>	Gives a head for a known server profile	rivet.head	OP
/hat	Swaps the main-hand item with the helmet slot	rivet.hat	Everyone

/clear examples:

/clear
/clear Alex
/clear diamond
/clear Alex diamond:32
/clear Alex diamond:32;plain -s

rivet.inventory.clear.others is required when the first argument is another player. ;plain matches only stacks without custom metadata. -s suppresses command feedback.

/condense works with plain stacks of iron, gold, copper, diamond, emerald, coal, redstone, lapis, raw iron, raw gold, raw copper, wheat, dried kelp, slime balls and bone meal. It only commits conversions that fit in the inventory.

Extra permissions:

• rivet.inventory.enderchest.others opens another player's live ender chest.
• rivet.repair.all enables /repair all.
• rivet.rename.format and rivet.lore.format allow colour and decoration tags.

Warning

Items left in /trash are cleared when the inventory closes. They cannot be recovered by Rivet.

Player utilities, kits and rewards

Command	What it does	Permission	Default
/craft	Opens a portable crafting table	rivet.utility.craft	Everyone
/anvil	Opens a portable anvil	rivet.utility.anvil	Everyone
/smithing	Opens a portable smithing table	rivet.utility.smithing	Everyone
/stonecutter	Opens a portable stonecutter	rivet.utility.stonecutter	Everyone
/grindstone	Opens a portable grindstone	rivet.utility.grindstone	Everyone
/jump	Teleports safely to the block you are looking at	rivet.jump	OP
/ride	Mounts a suitable targeted entity or dismounts	rivet.ride	OP
/sit	Toggles Paper's native sitting pose	rivet.pose.sit	Everyone
/lay	Toggles Paper's native sleeping pose	rivet.pose.lay	Everyone
/crawl	Toggles Paper's native swimming/crawling pose	rivet.pose.crawl	Everyone
/kit	Lists kits you can use	rivet.kit	Everyone
/kit <name>	Claims a configured kit	rivet.kit.<name>	Per kit
/daily	Claims the next daily or milestone reward	rivet.daily	Everyone
/filter	Opens the item-filter GUI	rivet.filter	Everyone
/filter add [item]	Adds the held or named material	rivet.filter	Everyone
/filter remove	Opens the GUI for click-to-remove	rivet.filter	Everyone
/filter list	Prints filtered materials	rivet.filter	Everyone
/filter clear	Clears filtered materials	rivet.filter	Everyone
/filter toggle	Enables or disables pickup blocking	rivet.filter	Everyone

Movement, teleporting, damage, logging out or running the same pose command clears a pose. rivet.filter.admin bypasses the configured filter-size limit.

See Kits and daily rewards for item schemas and reward examples.

Permissions, holograms and player glows

Command	What it does	Permission	Default
/perm add <user> <permission>	Adds a direct permission	rivet.permissions.manage	OP
/perm remove <permission> <user>	Removes a direct permission	rivet.permissions.manage	OP
/perm list <user>	Lists effective Rivet-managed nodes	rivet.permissions.manage	OP
/perm check <user> <permission>	Checks whether a node is granted	rivet.permissions.manage	OP
/perm reload	Reloads group and user permission files	rivet.permissions.manage	OP
/group list	Lists configured groups	rivet.permissions.manage	OP
/group info <group>	Shows a group's parent and nodes	rivet.permissions.manage	OP
/group set <user> <group>	Assigns a player to one group	rivet.permissions.manage	OP
/hologram or /holo	Opens hologram help	rivet.holograms	OP
/glow color	Lists every fixed and animated glow colour	rivet.glow	OP
/glow add <player> <color> [-s]	Adds or changes a persistent player glow	rivet.glow	OP
/glow remove <player> [-s]	Removes a saved player glow	rivet.glow	OP

Holograms have creation, copy, listing, inspection and 25 edit operations. Player glows support 16 fixed colours plus an animated rainbow. The full syntax is in Holograms and player glows.

Rivet's permission groups, inheritance and wildcard rules are covered in Permissions.