Skip to content

Commands and Permissions

MisterFenek edited this page Jul 31, 2026 · 2 revisions

💻 Commands & Permissions

Navigation: Home · Quick Start · Configuration


📜 Commands

Note: All admin commands work from the server console and RCON. The plugin provides full tab completion for subcommands and online player names.

Player Commands

Command Description Permission
/rsam Display available subcommands rsam.user.rules
/rsam rules [page] Show server rules (paginated chat UI / Bedrock form) rsam.user.rules
/rsam accept Accept the server rules rsam.user.rules
/rsam decline Decline the server rules rsam.user.rules
/rule Alias — directly shows rules page 1 rsam.user.rules

Admin Commands

Command Description Permission
/rsam reload Hot-reload all config files without restart rsam.admin.reload
/rsam reset <player> Reset a player's acceptance (forces re-accept) rsam.admin.reset
/rsam approve <player> Force-accept rules on behalf of a player rsam.admin.approve
/rsam player [player] View player's acceptance status, version, and date rsam.admin.info
/rsam info [player] Alias for /rsam player rsam.admin.info

Aliases

Alias Equivalent
/rule /rsam rules 1
/rsam info /rsam player
/rsam <number> /rsam rules <number> (jump to page)

🔐 Permissions

Permission Node Default Description
rsam.user.rules true Allows viewing rules and using accept/decline. Given to all players by default.
rsam.user.bypass false Bypass the entire rule acceptance system. Players with this permission are never frozen and don't need to accept rules.
rsam.admin.* op Grants all admin permissions below.
rsam.admin.reload op Use /rsam reload.
rsam.admin.reset op Use /rsam reset <player>.
rsam.admin.approve op Use /rsam approve <player>.
rsam.admin.info op Use /rsam player [player].

Note about ForceOP: When Misc.ForceOP: true (default) in settings.yml, even operators must accept rules. When false, players with rsam.admin.* are automatically exempt.


📝 Usage Examples

Check a player's status

/rsam player Notch

Output:

---------------------------------------------
Player: Notch
Accepted: ✔
Version: 1.0
---------------------------------------------

Force a player to re-read rules

/rsam reset Steve

Steve will be re-frozen on next movement and must accept rules again.

Accept rules on behalf of a player

/rsam approve Alex

Useful when a player has a client issue and can't click the chat buttons (e.g., old ViaVersion client).

Hot-reload after config changes

/rsam reload

Reloads settings.yml, messages.yml, and rules.yml without server restart. Also restarts the freeze enforcement task.

View rules as a player

/rule

Opens page 1 of rules with interactive navigation buttons.


⌨️ Tab Completion

The plugin provides intelligent tab completion:

  • First argument: rules, accept, decline + admin commands if you have permission (reload, reset, approve, player)
  • Second argument for reset/approve/player: Online player names (provided by Bukkit)

Navigation: Home · Quick Start · Configuration