TreeCapitator

• 🌲 Tree detection via BFS (connected log blocks)
• ⚡ Instant chop or configurable break delay
• 🔒 Sneak required to activate (configurable)
• ⏱️ Cooldown — global or per player
• 📊 XP & level system with exponential progression (up to level 100)
• 🏆 Leaderboard — top N players by trees chopped
• 🎁 Custom axes — vanilla and ItemsAdder support
• 💥 Temporary boosts — XP and drops multipliers
• 🎉 Global Double XP event — start/stop via command
• ✨ Particles & sounds — configurable per event
• 🌱 Auto-replant (configurable)
• 🌍 World whitelist/blacklist
• 💾 Auto-save to playerdata.yml (configurable interval)
• 🔄 Hot reload — no restart needed

Player (/trees or /tc)

| Command | Description |
|---|---|
| /trees help | Show help menu |
| /trees toggle | Enable/disable TreeCapitator for yourself |
| /trees stats [player] | View your (or another player's) statistics |
| /trees level | View your current level and XP |
| /trees top | Show the leaderboard |
| /trees boosts | View your active boosts |

Admin (/trees — requires treecapitator.admin)

| Command | Description |
|---|---|
| /trees reload | Reload config and lang files |
| /trees give <player> <axe> | Give a custom axe to a player |
| /trees reset <player> | Reset a player's data |
| /trees xp add <player> <amount> | Add XP to a player |
| /trees xp remove <player> <amount> | Remove XP from a player |
| /trees level set <player> <level> | Set a player's level |
| /trees boost give <player> <type> <multiplier> <time> | Give a boost (type: XP or DROPS) |
| /trees event doublexp start | Start the global Double XP event |
| /trees event doublexp stop | Stop the global Double XP event |
| /trees save | Manually save all player data |
| /trees debug | Toggle debug mode |

| Permission | Description | Default |
|---|---|---|
| treecapitator.use | Access to player commands | true |
| treecapitator.toggle | Toggle chop on/off | true |
| treecapitator.stats | View stats | true |
| treecapitator.top | View leaderboard | true |
| treecapitator.level | View level & XP | true |
| treecapitator.boosts | View active boosts | true |
| treecapitator.profile | View another player's profile | true |
| treecapitator.admin | All admin commands (includes all below) | op |
| treecapitator.admin.reload | Reload the plugin | op |
| treecapitator.admin.give | Give custom axes | op |
| treecapitator.admin.reset | Reset player data | op |
| treecapitator.admin.xp.add | Add XP to a player | op |
| treecapitator.admin.xp.remove | Remove XP from a player | op |
| treecapitator.admin.level.set | Set a player's level | op |
| treecapitator.admin.boost | Give boosts | op |
| treecapitator.admin.event | Manage events | op |
| treecapitator.admin.debug | Toggle debug mode | op |
| treecapitator.admin.save | Manually save data | op |

Use these three placeholder patterns to access all supported values:

| Pattern | Available values |
|---|---|
| %treecapitator_player_<field>% | level, xp, xp_next, trees, logs, enabled |
| %treecapitator_boost_<type>_<field>% | Type: xp or drops; field: active, multiplier, remaining |
| %treecapitator_event_<id>_<field>% | Field: active, name, multiplier, xp_multiplier, drops_multiplier, remaining |

Examples: %treecapitator_player_level%, %treecapitator_boost_xp_remaining%, and %treecapitator_event_double-xp_xp_multiplier%.

The previous player placeholders without the player_ prefix (such as %treecapitator_level%) remain supported for compatibility.

• ItemsAdder — use ItemsAdder items as custom axes (set itemsadder-id in config.yml)
• PlaceholderAPI — expose player stats as external placeholders