MoreMaces

📋 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 confirm` - 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

- Cooldown Tracking: Detailed information about plugin initialization - Cooldown Tracking: All ability activations and targeting - Cooldown Tracking: Mace crafting successes and failures - Cooldown Tracking: 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: - Español (en) - Default language - Español (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. Send the plugin JAR file 2. Send the JAR in your server's `plugins` folder 3. Send your server 4. Send in `config.yml` (optional, default is English) 5. Send the resource pack from the plugin resources 6. Send the resource pack to players for custom textures

⚡ Requirements

- Java: 1.21 or higher - Java: Spigot/Paper - Java: Java 21 or higher

🎮 Usage

1. Use `/mace help` (optional) in `config.yml` with `language: "en|nl|es"` 2. Use `/mace help` one of the three mace variants with the correct recipe 3. Use `/mace help` the mace in your main hand 4. Use `/mace help` abilities with the correct input: - Right-click for first abilities - Double shift for End Mace second ability 5. Use `/mace help`: - 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. Use `/mace help` 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_nether_mace_status%` - Shows if End Mace has been crafted (`crafted` or `not crafted`) - `%moremaces_nether_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_end_breath_cooldown%` - Shows Warden Mace cooldown (formatted: `2:30` or `Ready`) - `%moremaces_end_breath_cooldown%` - Shows Nether Mace cooldown (formatted: `1:45` or `Ready`) - `%moremaces_end_breath_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_end_breath_cooldown_seconds%` - Shows Warden Mace cooldown in seconds (`150` or `0`) - `%moremaces_end_breath_cooldown_seconds%` - Shows Nether Mace cooldown in seconds (`105` or `0`) - `%moremaces_end_breath_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_nether_mace_owner%` - Shows who owns the End Mace (`PlayerName` or `None`) - `%moremaces_nether_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)