🚀 Dynamic Shortcut Plugin (1.13 - 1.21+)

A lightweight, high-performance, and professional plugin that allows server administrators to create custom permanent command shortcuts dynamically with full %player% placeholder support!

---

✨ Features

• Dynamic Creation: Create command shortcuts instantly in-game without restarting your server.
• Smart Placeholders: Automatically detects and replaces %player% (case-insensitive) with the name of the player executing the shortcut.
• Persistent Storage: All shortcuts are safely stored in a config.yml file, so they survive server restarts.
• Cross-Version Support: Works flawlessly from older versions (1.13) up to the latest modern versions (1.21+).
• Optimized & Lightweight: Zero lag, built using native Bukkit events.

---

💻 Commands & Usage

Managing your shortcuts is incredibly easy. Use the main command prefix /shortcut or its built-in alias /sc.

How to create a shortcut:

/sc add <alias> <original_command>

Examples:

• Give players a diamond via shortcut: /sc add s1 give %player% diamond (Now, when a player types /s1, the server will execute /give <PlayerName> diamond)

• Create a quick heal shortcut: /sc add healme effect give %player% regeneration 5 1

---

🔑 Permissions

To keep your server secure, only authorized users or administrators can create shortcuts.

• shortcutplugin.admin - Allows creating and managing shortcuts. (Default: OP)

---

⚙️ Configuration (config.yml)

You can also manage, add, or delete shortcuts directly through the configuration file located at plugins/ShortcutPlugin/config.yml:

yaml

ShortcutPlugin Configuration File

Define your shortcuts here manually, or use /sc add in-game!

shortcuts: s1: "give %player% diamond" healme: "effect give %player% regeneration 5 1"

🔑 Permissions & LuckPerms Support

This plugin features a fully dynamic, native permission system. It integrates automatically with LuckPerms, UltraPermissions, EssentialsX Protect, and any other Bukkit-compatible permission management plugin.

1. Administrative Permission

To allow staff or administrators to create and manage shortcuts, grant them this permission:

• shortcutplugin.admin — Allows the usage of /sc add (Default: OP)

2. Dynamic Shortcut Permissions (For Players)

Every time you create a new shortcut, the plugin automatically generates a unique permission node specifically for that shortcut using the following format:

shortcutplugin.use.<shortcut_name>

💡 How to set it up in LuckPerms:

If you created a shortcut named /s1 (/sc add s1 give %player% diamond), the permission node generated will be shortcutplugin.use.s1.

• To grant a specific rank/group (e.g., VIP) access to use /s1: /lp group vip permission set shortcutplugin.use.s1 true

• To grant a specific player access to use /s1: /lp user <PlayerName> permission set shortcutplugin.use.s1 true

• To allow a group to use ALL shortcuts on the server: /lp group admin permission set shortcutplugin.use.* true

Note: If a player does not have the required permission for a shortcut, the command will not appear in their Tab-Completion list, keeping your server clean and secure!

🛠️ Installation Download the ShortcutPlugin.jar file.

Drop it into your server's plugins/ directory.

Restart or start your server.

Enjoy your brand new dynamic shortcuts!

No responsibility is taken for any malfunction that may occur.