Player and Social Features

Player and social features

Homes and warps

Players can save named homes with /sethome [name] and return with /home [name]. The unnamed default is called home.

Warps are public destinations. Staff create them with /setwarp <name>, and players use /warp <name>.

Homes, warps, /spawn, /back, accepted teleport requests, and /rtp share the policy in settings/teleports.yml. By default, the warmup is three seconds, movement cancels it, and a successful teleport starts a ten-second shared cooldown.

rivet.tp.nocooldown bypasses shared and feature-specific teleport cooldowns. It does not bypass the warmup. Staff and test-world movement commands are immediate.

Teleport requests

/tpa <player> asks to teleport to another player. /tpahere <player> asks the other player to come to the sender. Recipients answer with /tpaccept [player] or /tpdeny [player].

Request expiry and request throttling are configured in settings/tpa.yml. The actual teleport uses the shared teleport policy.

Chat and private messages

The chat module provides:

• configurable public chat and /me formats;
• /msg and /r private messages;
• per-player ignore lists;
• social spy for authorised staff;
• persistent chat colours and safe formatting.

Player-provided MiniMessage is filtered. Formatting permissions do not grant click events, command execution, hover events, or other unsafe interactive tags.

Nicknames, AFK, and statistics

/nick stores a persistent nickname. Extra formatting requires rivet.nick.format; changing another player's nickname requires rivet.nick.others.

AFK status can be set manually with /afk or automatically after the configured idle time. AFK players can be excluded from sleep calculations. /afkcheck shows current AFK state and duration.

/stats, /playtime, and /seen use Paper's native statistics and cached player records. Rivet does not block the server to look up completely unknown player profiles.

Storage and item handling

Backpacks are persistent personal inventories. Their visible size comes from the configured default and the highest rivet.backpack.rows.<number> permission. Items in hidden rows remain stored.

Pickup filters can work as an allowlist or denylist. /filter manages the material list and enabled state. Feedback can use an action bar and an optional sound.

/trash opens a configurable disposable inventory. Items left there are destroyed when the inventory closes.

Utilities and poses

Rivet can open portable crafting, anvil, smithing, stonecutting, and grindstone interfaces. It also provides player lists, ping checks, safe targeted jumps, and controlled entity riding.

Sitting, laying, and crawling use Paper's native pose support. They can be limited by world in settings/poses.yml.

Kits and daily rewards

Kits are defined in settings/kits.yml. A player needs the base rivet.kit permission and the kit-specific rivet.kit.<name> node. Cooldowns are persistent.

Daily rewards use real timestamps, streaks, milestone rewards, experience, items, and console commands. Claims are saved before rewards are issued to prevent duplicated rewards after a failed save.