# GeyserCommandsYML<\/p>\n
**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.<\/p>\n
Rather than disabling all of the server command suggestions entirely through the Geyser-Spigot configuration (aka `Geyser-Spigotconfig.yml` \u2192 `command-suggestions: false`), this plugin **hooks directly** into Geyser + Floodgate APIs, letting you **define your own custom list** of commands **only for Bedrock players** \u2014 avoiding crashes, bloat, or exposing irrelevant commands.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– \u2705 Add your own customizable list of visible commands for Bedrock players.
\n– \u2705 Prevents the need to disable Geyser’s command suggestions globally.
\n– \u2705 Simple YAML configuration (`plugins\/GeyserCommandsYML\/commands.yml`).
\n– \u2705 Hot-reloading support for external config edits (with controlled player kick).
\n– \u2705 Very lightweight \u2014 simply intercepts `PlayerCommandSendEvent` and modifies it for Bedrock clients.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | **Aliases:** —<\/p>\n ## How it Works<\/p>\n – On `PlayerCommandSendEvent`, the plugin: – The **Geyser client** **pulls the available commands at player join**, not dynamically \u2014 – **Important:** —<\/p>\n ## Permissions Overview<\/p>\n | Permission | Purpose | – If a player lacks the required permission, they will be denied access to the subcommand. —<\/p>\n ## Tested Environments<\/p>\n – \u2705 **PaperMC 1.21.4 – Build #226**: Compatible —<\/p>\n","protected":false},"excerpt":{"rendered":" Set your own list of custom command suggestions to be displayed for Geyser (Bedrock) Clients<\/p>\n","protected":false},"featured_media":75446,"template":"","meta":{"_minecraft_slug":"geysercommandsyml","_minecraft_project_id":"dblyfJou","_minecraft_author":"xHue","_minecraft_license":"MIT","_minecraft_downloads":720,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"geysercommandsyml.zip","_minecraft_size_bytes":37940,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T09:30:31.067044Z","_minecraft_date_created":"2025-04-28T04:42:25.522200Z","_minecraft_date_modified":"2025-04-28T06:00:40.394464Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/geysercommandsyml","_minecraft_icon_attachment_id":75446,"_minecraft_imported_at":"2026-06-04T08:56:50+00:00","_minecraft_import_hash":"43d0651dd27904b4c612aa395e4f248e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,73,74,38,78],"class_list":["post-75445","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\n| :— | :— | :— |
\n| `\/geysercommands add
\n| `\/geysercommands remove
\n| `\/geysercommands list` | Lists all currently registered Bedrock commands in chat. | `geysercommands.list` |
\n| `\/geysercommands reload` | Reloads the plugin configuration and updates the Bedrock command list (forces Bedrock players to reconnect). | `geysercommands.reload` |<\/p>\n
\n`\/geysercommandsyml`, `\/gcyml`<\/p>\n
\n – **Checks if the player is a Bedrock client** (via Geyser\/Floodgate APIs).
\n – If **yes**, it **clears** the default command suggestion list.
\n – Then it **adds** only the commands defined in the plugin’s YAML file.<\/p>\n
\n **therefore, after running `\/geysercommands reload`, Bedrock players must rejoin to see the updated list.**
\n (This command automatically kicks Bedrock players with a kind message asking them to rejoin.)<\/p>\n
\n – In `Geyser-Spigotconfig.yml`, ensure `command-suggestions: true` is set.
\n – The `\/geysercommands add
\n – But keep in mind, **online Bedrock players won’t see updated command lists** until they manually leave and rejoin.<\/p>\n
\n| :— | :— |
\n| `geysercommands.add` | Allows adding commands to the Bedrock command list. |
\n| `geysercommands.remove` | Allows removing commands from the Bedrock command list. |
\n| `geysercommands.list` | Allows viewing the current Bedrock command list. |
\n| `geysercommands.reload` | Allows reloading the plugin configuration and forcing Bedrock players to reconnect. |<\/p>\n
\n– Server Operators maintain default command access.<\/p>\n
\n– \u2705 **Geyser-Spigot – Build #816:** Compatible
\n– \u2705 **Floodgate – Build #116:** Compatible<\/p>\n