EquipCommands Plugin - Quick Overview What It Does: Auto-run commands when holding specific items - No typing needed!
⚡ Core Features: 1. Smart Item System
Hold item → Command runs automatically
Switch away → Command stops automatically
Works with custom lore (not just material type
# EquipCommands Configuration
# Configure items with custom lore and their corresponding commands
# When a player holds an item with matching lore, the command will be executed
# When they switch to a different item or empty hand, the cancel-command will be executed (if specified)
# Sneak Messages Configuration
sneak-messages:
enabled: true
message: "Sneak to get up"
color: "§e" # Color codes: §a=green, §b=aqua, §c=red, §d=light_purple, §e=yellow, §f=white, §0-9=colors
# Items Configuration
# Each item needs: material, lore (first line is used as identifier), command, and optional cancel-command
items:
# Example: Crawl Stick
crawl_stick:
material: "STICK"
display-name: "§6Crawl Stick"
lore:
- "§eCrawl Tool" # This line is used as the identifier
- "§7Hold to crawl automatically"
- "§7Right-click to activate"
command: "crawl"
cancel-command: "crawl stop"
# Instructions:
# 1. Each item must have a unique key (like crawl_stick, fly_feather, etc.)
# 2. material: Must be a valid Minecraft material name
# 3. display-name: The name that appears on the item (optional)
# 4. lore: List of lore lines. The FIRST line is used as the identifier!
# 5. command: Command to run when holding the item (without /)
# 6. cancel-command: Command to run when switching away (optional)
# 7. Use & or § for color codes in display names and lore
# 8. Use "/equipcommands give <item-key>" to get items
# 9. Use "/equipcommands list" to see all available items
# 10. Use "/equipcommands reload" to reload this config
# Available Commands:
# /equipcommands give crawl_stick - Gives you the crawl stick
# /equipcommands give fly_feather - Gives you the fly feather
# /equipcommands give speed_boots - Gives you the speed boots
# /equipcommands list - Shows all available items
# /equipcommands reload - Reloads the configuration
# Color Codes:
# §0 = Black, §1 = Dark Blue, §2 = Dark Green, §3 = Dark Aqua
# §4 = Dark Red, §5 = Dark Purple, §6 = Gold, §7 = Gray
# §8 = Dark Gray, §9 = Blue, §a = Green, §b = Aqua
# §c = Red, §d = Light Purple, §e = Yellow, §f = White