TreeCapitator

!Features

!TreeCapitator !Spigot

---

• 🌲 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

---

!Commands

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

---

!Perms

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

!Placeholders

Placeholder	Description
%treecapitator_level%	Player level
%treecapitator_xp%	Player experience points
%treecapitator_trees%	Total trees cut by the player
%treecapitator_logs%	Total logs broken by the player
%treecapitator_xp_next%	XP required to reach the next level
%treecapitator_enabled%	Whether TreeCapitator is enabled for the player
%treecapitator_boost_xp_multiplier%	Active XP boost multiplier
%treecapitator_boost_xp_remaining%	Remaining XP boost duration in seconds
%treecapitator_boost_drops_multiplier%	Active drops boost multiplier
%treecapitator_boost_drops_remaining%	Remaining drops boost duration in seconds
%treecapitator_event_<id>_active%	Whether the event is currently active
%treecapitator_event_<id>_name%	Display name of the event
%treecapitator_event_<id>_multiplier%	Multiplier applied during the event
%treecapitator_event_<id>_remaining%	Remaining event duration in seconds

---

!Integrations

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