GeyserCommandsYML

GeyserCommandsYML is a lightweight plugin designed for servers using Geyser-Spigot to allow better control over the command suggestion list shown to their Bedrock Edition players.

Rather than disabling all of the server command suggestions entirely through the Geyser-Spigot configuration (aka Geyser-Spigot\config.yml → command-suggestions: false), this plugin hooks directly into Geyser + Floodgate APIs, letting you define your own custom list of commands only for Bedrock players — avoiding crashes, bloat, or exposing irrelevant commands.

---

Features

• ✅ Add your own customizable list of visible commands for Bedrock players.
• ✅ Prevents the need to disable Geyser's command suggestions globally.
• ✅ Simple YAML configuration (plugins/GeyserCommandsYML/commands.yml).
• ✅ Hot-reloading support for external config edits (with controlled player kick).
• ✅ Very lightweight — simply intercepts PlayerCommandSendEvent and modifies it for Bedrock clients.

---

Commands

Command	Description	Permission
/geysercommands add <command>	Adds a command to the Bedrock command list.	geysercommands.add
/geysercommands remove <command>	Removes a command from the Bedrock command list.	geysercommands.remove
/geysercommands list	Lists all currently registered Bedrock commands in chat.	geysercommands.list
/geysercommands reload	Reloads the plugin configuration and updates the Bedrock command list (forces Bedrock players to reconnect).	geysercommands.reload

Aliases:
/geysercommandsyml, /gcyml

---

How it Works

• On PlayerCommandSendEvent, the plugin:

  • Checks if the player is a Bedrock client (via Geyser/Floodgate APIs).
  • If yes, it clears the default command suggestion list.
  • Then it adds only the commands defined in the plugin's YAML file.

• The Geyser client pulls the available commands at player join, not dynamically —
  therefore, after running /geysercommands reload, Bedrock players must rejoin to see the updated list.
  (This command automatically kicks Bedrock players with a kind message asking them to rejoin.)

• Important:

  • In Geyser-Spigot\config.yml, ensure command-suggestions: true is set.
  • The /geysercommands add <command> and /geysercommands remove <command> commands do not kick players.
    • But keep in mind, online Bedrock players won't see updated command lists until they manually leave and rejoin.

---

Permissions Overview

Permission	Purpose
geysercommands.add	Allows adding commands to the Bedrock command list.
geysercommands.remove	Allows removing commands from the Bedrock command list.
geysercommands.list	Allows viewing the current Bedrock command list.
geysercommands.reload	Allows reloading the plugin configuration and forcing Bedrock players to reconnect.

• If a player lacks the required permission, they will be denied access to the subcommand.
• Server Operators maintain default command access.

---

Tested Environments

• ✅ PaperMC 1.21.4 - Build #226: Compatible
• ✅ Geyser-Spigot - Build #816: Compatible
• ✅ Floodgate - Build #116: Compatible

---