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%	Current player level.
%treecapitator_xp%	Current player XP (raw value, accumulated since level 1).
%treecapitator_xp_next%	XP required to reach the next level.
%treecapitator_trees%	Total number of trees chopped by the player.
%treecapitator_logs%	Total number of logs broken by the player.
%treecapitator_enabled%	"true" or "false" — whether the player has enabled automatic tree chopping (/tree toggle).
%treecapitator_boost_xp_multiplier%	Active XP boost multiplier for the player (e.g. "2.0"). "1.0" if no XP boost is active.
%treecapitator_boost_xp_remaining%	Remaining time of the active XP boost, formatted (e.g. "4m", "1h"). "0" + seconds unit if no boost is active.
%treecapitator_boost_drops_multiplier%	Active drops boost multiplier for the player. "1.0" if no drops boost is active.
%treecapitator_boost_drops_remaining%	Remaining time of the active drops boost, formatted. Same behavior as the XP boost.
%treecapitator_event_active%	"true" if at least one TreeCapitator event is currently active, "false" otherwise.
%treecapitator_event_name%	Display name of the active event found. Empty if no event is active.
%treecapitator_event_multiplier%	Multiplier of the active event found. "1.0" if no event is active.
%treecapitator_event_remaining%	Remaining time of the active event, formatted. "0" + seconds unit if no event is active.
%treecapitator_event_<id>_active%	"true" if event <id> is currently active, "false" otherwise (including if it does not exist).
%treecapitator_event_<id>_name%	Display name of event <id>. Empty if it is not active.
%treecapitator_event_<id>_multiplier%	Multiplier of event <id>. "1.0" if it is not active.
%treecapitator_event_<id>_remaining%	Remaining time of event <id>, formatted. "0" + seconds unit if it is not active.

---

!Integrations

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