📋 Commands

/mace help or /moremace help

Shows all available commands and information about the maces. Including:

• All available commands
• Language support information (English, Dutch, Spanish)
• Mace variants and their abilities
• Cooldown system explanation
• Important notes about crafting and durability

/mace status

Shows the global mace crafting status and your cooldown information.

/mace reload (Admin only)

Reloads the plugin configuration and recipes. Including language files!

/mace reset confirm (Admin only)

Resets all mace data and cooldowns. Makes all maces available for crafting again. ⚠️ WARNING: This command resets ALL data! Use /mace reset first to see what will be reset.

/mace debug (Admin only)

Shows extensive debug information about plugin status, data file location and mace crafting status.

Data Reset Functionality

The reset command has a safety mechanism:

1. /mace reset - Shows warning and list of what will be reset
2. /mace reset confirm - Actually performs the reset

🔍 Logging & Debugging

The plugin has extensive logging for troubleshooting:

Console Logging

• Startup: Detailed information about plugin initialization
• Ability Usage: All ability activations and targeting
• Crafting: Mace crafting successes and failures
• Data Changes: Status changes of maces
• Cooldown Tracking: Cooldown activations and resets

Log Messages

• === MoreMaces Plugin Starting === - Plugin start
• Player [name] activated [Mace] ability - Ability usage
• No players within range - no cooldown applied - No target found
• Successfully crafted [Mace] - now marked as crafted globally - Crafting success

🌍 Multi-Language Support

The plugin now supports multiple languages:

• English (en) - Default language
• Nederlands (nl) - Dutch translation
• Español (es) - Spanish translation

You can change the language in config.yml by modifying the language setting to en, nl, or es.

🔧 Installation

1. Download the plugin JAR file
2. Place the JAR in your server's plugins folder
3. Restart your server
4. Configure language in config.yml (optional, default is English)
5. Download the resource pack from the plugin resources
6. Send the resource pack to players for custom textures

⚡ Requirements

• Minecraft Version: 1.21 or higher
• Server Software: Spigot/Paper
• Java: Java 21 or higher

🎮 Usage

1. Configure language (optional) in config.yml with language: "en|nl|es"
2. Craft one of the three mace variants with the correct recipe
3. Use the mace in your main hand
4. Activate abilities with the correct input:
   • Right-click for first abilities
   • Double shift for End Mace second ability
5. Cooldown Management:
   • View cooldown in action bar (above hotbar)
   • No target = no cooldown, try again
   • Successful ability = 3 minutes cooldown
   • End Mace flight stops automatically after 20 seconds (no fall damage)
   • Fly speed is only adjusted in survival/adventure mode
6. Protect your mace from void damage
7. Use /mace help for extensive information in your chosen language

🐛 Troubleshooting

Mace doesn't work

• Try again if there's no target nearby

Commands don't work

• Check permissions: moremaces.use and moremaces.admin
• Make sure the plugin is loaded correctly
• Check the server console for errors
• Use /mace help to see all available commands

Changing language

• Modify language: "en|nl|es" in config.yml
• Restart the server or use /mace reload (admin)
• All messages and commands are now shown in the chosen language

Data/Data File Problems

• Delete mace_data.yml to make all maces available again
• Or use /mace reset (admin) to reset all data and cooldowns
• Plugin automatically initializes all maces as "not crafted" on first start
• Check console logs for data loading messages

🏷️ PlaceholderAPI Integration

The plugin includes full PlaceholderAPI support for use in other plugins, scoreboards, and chat messages.

Status Placeholders

• %moremaces_end_mace_status% - Shows if End Mace has been crafted (crafted or not crafted)
• %moremaces_warden_mace_status% - Shows if Warden Mace has been crafted (crafted or not crafted)
• %moremaces_nether_mace_status% - Shows if Nether Mace has been crafted (crafted or not crafted)

Cooldown Placeholders (Formatted)

• %moremaces_warden_cooldown% - Shows Warden Mace cooldown (formatted: 2:30 or Ready)
• %moremaces_nether_cooldown% - Shows Nether Mace cooldown (formatted: 1:45 or Ready)
• %moremaces_end_flight_cooldown% - Shows End Mace flight cooldown (formatted: 0:30 or Ready)
• %moremaces_end_breath_cooldown% - Shows End Mace breath cooldown (formatted: 3:00 or Ready)

Cooldown Placeholders (Seconds Only)

• %moremaces_warden_cooldown_seconds% - Shows Warden Mace cooldown in seconds (150 or 0)
• %moremaces_nether_cooldown_seconds% - Shows Nether Mace cooldown in seconds (105 or 0)
• %moremaces_end_flight_cooldown_seconds% - Shows End Mace flight cooldown in seconds (30 or 0)
• %moremaces_end_breath_cooldown_seconds% - Shows End Mace breath cooldown in seconds (180 or 0)

Ownership Placeholders

• %moremaces_end_mace_owner% - Shows who owns the End Mace (PlayerName or None)
• %moremaces_warden_mace_owner% - Shows who owns the Warden Mace (PlayerName or None)
• %moremaces_nether_mace_owner% - Shows who owns the Nether Mace (PlayerName or None)

Usage Examples

# In a scoreboard
End Mace: %moremaces_end_mace_status%
Warden Cooldown: %moremaces_warden_cooldown%

# In a chat message
The End Mace is owned by: %moremaces_end_mace_owner%

# In a plugin configuration
message: "Your Warden Mace cooldown: %moremaces_warden_cooldown%"

Requirements

• PlaceholderAPI plugin must be installed on your server
• Placeholders work automatically once both plugins are loaded
• All placeholders are player-specific (cooldowns show individual player cooldowns)