Skip to main content

Commands & Permissions

This page was scanned from plugin.yml, config.yml, and the current command handler source.

Scope

Use this page when you need the real FioChatGames command surface instead of an old shortcut list.

Root Commands

The plugin registers two root commands:

  • /fiochatgames
  • /fiochatgamesadmin

Aliases:

  • /cg for /fiochatgames
  • top as an alias for leaderboard

Command aliases for subcommands are configurable in config.yml under command-aliases.

User Commands

CommandPermissionDescription
/fiochatgames helpfiochatgames.command.helpShow player help.
/fiochatgames togglefiochatgames.command.toggleToggle your participation state.
/fiochatgames currentfiochatgames.command.currentShow the active round and remaining time.
/fiochatgames leaderboard <events|races> <type>fiochatgames.command.leaderboardShow leaderboard data for an event type or race objective.
/fiochatgames info <events|races> <player>fiochatgames.command.infoShow stored stats for a player.
/fiochatgames admin ...fiochatgames.command.adminRoute into admin subcommands through the main command.

User Permissions

PermissionDescription
fiochatgames.useBase permission required to use the command system.
fiochatgames.playRequired only when use-permission-toplay: true is enabled.
fiochatgames.command.helpAllows /cg help.
fiochatgames.command.toggleAllows /cg toggle.
fiochatgames.command.currentAllows /cg current.
fiochatgames.command.leaderboardAllows /cg leaderboard ....
fiochatgames.command.infoAllows /cg info ....
fiochatgames.command.adminAllows routing into admin subcommands from /cg admin.
fiochatgames.command.*Wildcard for the main user command nodes.

Admin Commands

You can use admin commands from either:

  • /fiochatgames admin ...
  • /fiochatgamesadmin ...
CommandPermissionDescription
admin helpfiochatgames.admin.helpShow admin help.
admin reloadfiochatgames.admin.reloadReload config, language, and plugin-managed files.
admin versionfiochatgames.admin.versionShow plugin version and server version.
admin authorfiochatgames.admin.authorShow plugin author list.
admin placeholdersfiochatgames.admin.placeholdersPrint supported placeholder patterns.
admin currentfiochatgames.admin.currentShow active round details.
admin listfiochatgames.admin.listShow enabled event types, race objectives, and start mode.
admin menufiochatgames.admin.menuOpen the admin GUI.
admin info <events|races> <player>fiochatgames.admin.infoShow player event or race statistics.
admin toggle <player> <true|false>fiochatgames.admin.toggleForce another player's participation toggle.
admin points <give|remove|set> <player> <amount>fiochatgames.admin.pointsEdit total points.
admin win <give|remove|set> <player> <events|races> <game> <amount>fiochatgames.admin.winEdit stored wins.
admin winstreak <give|remove|set> <player> <events|races> <game> <amount>fiochatgames.admin.winstreakEdit stored winstreaks.
admin blacklist listfiochatgames.admin.blacklistShow blacklisted players.
admin blacklist <add|remove> <player>fiochatgames.admin.blacklistAdd or remove a player from the blacklist.
admin start event <type> [-bypass]fiochatgames.admin.start and fiochatgames.admin.start.eventForce-start an event game.
admin start race <type> [-bypass]fiochatgames.admin.start and fiochatgames.admin.start.raceForce-start a race objective.
admin start <legacyGameOrRace> [-bypass]fiochatgames.admin.startLegacy compatibility path still supported in source.
admin stop [all|event|race]fiochatgames.admin.stopStop the currently running round.

Admin Permission Nodes

PermissionDescription
fiochatgames.adminMain wildcard-style admin access group.
fiochatgames.admin.helpAdmin help command.
fiochatgames.admin.reloadReload command.
fiochatgames.admin.versionVersion command.
fiochatgames.admin.authorAuthor command.
fiochatgames.admin.placeholdersPlaceholder list command.
fiochatgames.admin.currentCurrent command.
fiochatgames.admin.listList command.
fiochatgames.admin.startRoot start command.
fiochatgames.admin.start.eventAllows event starts.
fiochatgames.admin.start.raceAllows race starts.
fiochatgames.admin.start.*Wildcard for all start nodes.
fiochatgames.admin.start.race.*Wildcard for all race objective start nodes.
fiochatgames.admin.stopStop command.
fiochatgames.admin.menuAdmin GUI command.
fiochatgames.admin.infoAdmin info command.
fiochatgames.admin.toggleForce toggle command.
fiochatgames.admin.pointsPoints editor command.
fiochatgames.admin.winWins editor command.
fiochatgames.admin.winstreakWinstreak editor command.
fiochatgames.admin.blacklistBlacklist editor command.
fiochatgames.admin.updateUpdate-related permission declared in plugin.yml.

Start Permissions By Game Type

Event start permissions use the event GameType.id() value. Examples:

  • fiochatgames.admin.start.trivia
  • fiochatgames.admin.start.fast_type
  • fiochatgames.admin.start.guess_the_word
  • fiochatgames.admin.start.guess_the_number

Race start permissions use normalized objective names. Examples:

  • fiochatgames.admin.start.race.break
  • fiochatgames.admin.start.race.bartering
  • fiochatgames.admin.start.race.resurrecting
  • fiochatgames.admin.start.race.placeholderapi
  • fiochatgames.admin.start.race.shoot_at_entity

Notes

  • -bypass can be appended to start commands to bypass online-player requirements.
  • /fiochatgamesadmin routes into the same admin handler as /fiochatgames admin.
  • use-permission-toplay: true makes fiochatgames.play required for participation.
  • command-aliases in config.yml controls the user/admin subcommand aliases, including ver for version.