PluginHelpGUI999: Your Ultimate In-Game Plugin Help System!

Are you tired of constantly looking up plugin commands and their usages? Do you wish for an intuitive, in-game way to explore all the functionalities your server's plugins offer? Look no further! PluginHelpGUI999 is a revolutionary Spigot plugin designed to streamline the way players discover and interact with plugin commands through a beautiful, easy-to-use graphical user interface (GUI).

Say goodbye to external wikis and messy chat commands. With PluginHelpGUI999, all the information about your server's plugins and their commands is just a click away, right inside Minecraft!

Key Features

✨ Dynamic Plugin Discovery: Automatically scans and detects all loaded plugins on your server, ensuring your help system is always up-to-date without manual configuration (for new plugins).

📖 Interactive Plugin Browser: A sleek, paginated GUI displays all detected plugins. Each plugin is represented by a unique item for easy identification.

⚡ Command-Specific GUIs: Click on any plugin to open a dedicated GUI listing all its commands, complete with descriptions and required permissions.

🚀 One-Click Command Execution: Execute any command directly from the GUI with a simple click. No more typing out long, complex commands!

💾 Persistent Command Items: Drag command items from the GUI into your inventory or hotbar to keep frequently used commands at your fingertips. Click them anytime to execute!

✍️ Customizable Descriptions & Permissions: Easily modify command descriptions and permissions in the config.yml to reflect your server's specific setup or to provide more player-friendly explanations.

🔄 In-Game Reload: Refresh the plugin configuration and GUIs with a dedicated reload button, perfect for when you've updated config.yml or added new plugins.

🔒 Permission-Based Access: Control who can access the help system and execute commands through simple Spigot permissions.

Commands

All features of PluginHelpGUI999 are accessible through a single, easy-to-remember command:

• /pluginhelp
  • Description: Opens the main Plugin Help Browser GUI, showing a list of all detected plugins.
  • Usage: /pluginhelp
  • Permission: PluginHelpGUI999.use

How It Works (Behind the Scenes)

PluginHelpGUI999 intelligently interacts with your server:

1. Startup Scan: Upon server startup or plugin reload, PluginHelpGUI999 scans your server for all active plugins.
2. config.yml Auto-Population: It automatically populates or updates its config.yml with entries for each detected plugin and their commands. This includes placeholder descriptions and permissions.
3. GUI Generation: When you use /pluginhelp, it dynamically generates an inventory GUI based on the data in its config.yml. Plugins are shown as Zombie Heads, and commands are shown as Player Heads.
4. Persistent Data: Command items store their respective commands using Spigot's Persistent Data Container (NBT tags), allowing them to be carried in a player's inventory and executed outside the main GUI.
5. Command Execution: When a command item is clicked, the plugin safely executes player.performCommand(command), respecting all server-side command handling and permissions.

Configuration (config.yml)

One of the most powerful features of PluginHelpGUI999 is its customizable config.yml. While the plugin auto-fills entries, you can personalize the help experience for your players:

plugins:
  PluginNameHere:
    description: Your custom description for this plugin.
    commands:
      commandname:
        description: A clear explanation of what /commandname does.
        permission: custom.permission.node # Or 'none' if no specific permission
  AnotherPlugin:
    description: Even more customization!
    commands:
      anothercommand:
        description: What this command does.
        permission: anotherplugin.use

• Modify description: Change the text displayed for any plugin or command in the GUIs.
• Set permission: Define the specific permission a player needs to use a command via the GUI. If left as none, it implies anyone can use it (or it relies on the plugin's default permission system).

Important: The plugin preserves your custom changes to descriptions and permissions. It will only auto-update entries that still have the default placeholder values (No description set or none).

Permissions

• PluginHelpGUI999.use (default: op)
  • Allows players to use the /pluginhelp command.
  • Allows players to click and execute commands from the GUIs or from command items in their inventory.