SimpleExecutables

SimpleExecutables
A lightweight and powerful Paper plugin that allows you to create custom, "executable" items. These items can run any command from the console when a player right-clicks them.

Perfect for creating server menus, custom kits, command scrolls, special keys, or any other item-based command trigger you can imagine!

Features

• Unlimited Custom Items: Create as many executable items as you need.
• Fully Customizable: Define the Material, CustomModelData, Display Name, Lore, and Glowing effect for each item.
• Powerful Actions: Assign any console command to be executed on right-click.
• Placeholders: Use the %player% placeholder in your commands.
• Per-Item Permissions: Set a unique permission node required to use a specific item.
• Easy Management: All items can be created, edited, and removed via simple in-game commands or by editing the executables.yml file.
• Admin GUI: Use /executables to open a GUI that lists all created items, allowing admins to quickly grab a copy.
• Performance-Friendly: All configuration loading and command processing are handled asynchronously to prevent server lag.
• Configurable: All messages are translatable in lang.yml.
• Update Checker: Automatically notifies admins with permission when a new version is available.

How It Works

1. You create an item definition with a unique ID (e.g., magic_scroll).
2. You configure this item using /exec set ... commands (setting its name, material, command, etc.).
3. You give the item to a player using /exec give magic_scroll 1 Notch.
4. When the player right-clicks the magic_scroll item:
   • The plugin checks if they have the required permission (if one was set).
   • If they do, the plugin runs the configured command (e.g., kit magic %player%) from the server console.
   • One item is consumed from the player's hand.

Commands & Permissions
The base command for this plugin is /executables (alias: /exec).

Main Permission: simpleexecutables.admin - Grants access to all commands listed below.

Command Description
/exec Opens the item GUI for admins. Shows plugin info for others.
/exec reload Reloads all configurations (executables.yml, lang.yml, settings.yml).
/exec create <id> Creates a new, blank executable item definition.
/exec remove <id> Deletes an executable item definition.
/exec give <id> [quantity] <player> Gives the specified item to a player.
/exec help Opens the help menu
Setting Item Properties
Use the /exec set <property> <id> <value...> command to configure an item.

• /exec set name <id> <name>
  • Sets the item's display name.
• /exec set lore <id> <name...>
  • Sets the item's lore. (Use <br> or \n for new lines).
• /exec set action <id> <command...>
  • Sets the console command to run (e.g., eco give %player% 100).
• /exec set permission <id> <node>
  • Sets the permission node the player must have to use the item. (Set to "" or null for no permission).
• /exec set material <id> <MATERIAL>
  • Sets the item's material (e.g., DIAMOND_SWORD).
• /exec set custommodeldata <id> <number>
  • Sets the item's CustomModelData value.
• /exec set glowing <id> <true|false>
  • Makes the item glow (enchanted look).

Other Permissions

• simpleexecutables.update.notify - Users with this permission will be notified of new plugin versions when they join.
• Custom Permissions: Any permission you set using the /exec set permission ... command will be required for players to use that specific item.

Configuration

• executables.yml: This file stores all your created item definitions. You can edit it manually (and use /exec reload) or manage it entirely with in-game commands.
• lang.yml: Contains all plugin messages, which can be translated.
• settings.yml: Contains general settings, such as toggling the update checker.

Support
Developed with ❤ by AlzyIT. Click here to visit my SpigotMC profile!