timberella

Drop-in quality-of-life plugin for Paper servers: instant tree felling, tidy leaf cleanup, and automatic replanting with safety rails so mega-builds stay intact.

Why server owners love it

• ⚡ One axe swing can clear an entire tree while axe wear, block limits and timing stay configurable.
• 🌱 Optional replanting with soil checks keeps forests alive, underwater too with UnderwaterTrees.
• 🛡️ Species-aware limits (per-tree caps, radii, durability rules) stop griefing before it starts.
• 🏠 Builds stay safe: only trees with naturally grown foliage are felled, so log cabins and walls touching a tree stay standing, and player-placed leaves are never cleared away.
• 🏰 Respects land protection: WorldGuard, GriefPrevention & co. can deny every extra log, cleared leaf and replanted sapling.
• 🧩 Custom blocks from ItemsAdder, MMOItems, MythicCrucible and CraftEngine are left alone.
• 🔁 Live config reloads merge new defaults automatically—no manual diffing: new settings are added with their comments, and the rest of your file stays exactly as you wrote it.
• 🔔 Update checker (Modrinth + Hangar) and join reminders keep your fleet current.
• 🌐 14 bundled languages, all MiniMessage-powered, so you can style player + console feedback exactly the way you like.

Server requirements (as of Timberella 2.0.0)

• Paper 26.3.x (Spigot and vanilla are not supported).
• Java 25 runtime.
• Optional: a permissions plugin (LuckPerms, etc.) for fine-grained access to /timberella commands.

Setup in 3 steps

1. Copy the latest timberella-paper-<version>.jar into plugins/.
2. Boot the server once—config.yml, lang/, and leaf_mappings.yml appear automatically.
3. Tweak plugins/Timberella/config.yml (modules, safety caps, labels) and run /timberella reload.

That's it. Edits to config.yml are picked up automatically by the config watcher; after editing lang/ or leaf_mappings.yml, run /timberella reload.

Upgrading from 1.x

Swap the jar and start the server: your old files move to plugins/Timberella/backup-1.x/, fresh files are created with every setting you had changed carried over, and the console lists exactly what happened. Two defaults changed (require_natural_leaves and replant.sapling_source); the upgrade notes explain how to get the 1.x behavior back.

Everyday tips

• Use sneak_mode to decide when felling triggers: only while sneaking (default), only while not sneaking, or always.
• Players switch Timberella off and on for themselves with /timberella toggle; admins can do it for others, even offline, with /timberella toggle <player>.
• Flip specific logs, woods or fences on or off in categories. Unknown materials are ignored safely.
• By default, only saplings the felled tree actually dropped are replanted; set replant.sapling_source to free to always replant for free.
• Watch the console after reloads: Timberella shows which modules are active and which files changed. Turn on log_detail to list every enabled material, leaf mapping, axe and sapling; a misspelled material won't show up there.
• Update notifications show up in the console and, with timberella.update.notify, for ops on join. Set update_check.notify_console_always_shown to true if you also want the "no update" summary, and leave update_check.filter_by_server_version on so only builds for your Minecraft version are reported.

Supported languages

Timberella bundles each locale as a MiniMessage YAML file so you can recolor or restyle them freely:

• 🇺🇸 English (en_US)
• 🇩🇪 German (de_DE)
• 🇸🇦 Arabic (ar_SA)
• 🇪🇸 Spanish (es_ES)
• 🇫🇷 French (fr_FR)
• 🇮🇹 Italian (it_IT)
• 🇯🇵 Japanese (ja_JP)
• 🇰🇷 Korean (ko_KR)
• 🇳🇱 Dutch (nl_NL)
• 🇵🇱 Polish (pl_PL)
• 🇵🇹 Portuguese (pt_PT)
• 🇹🇷 Turkish (tr_TR)
• 🇺🇦 Ukrainian (uk_UA)
• 🇨🇳 Simplified Chinese (zh_CN)

Updates add new texts to your language files without touching your edits, and /timberella reload applies language changes.

Need deeper guidance?

This page keeps things short on purpose. The wiki explains every setting, commands and permissions, land protection and troubleshooting. Building from source and contributing are covered in the developer guide.

License & Credits

• Timberella is released under the MIT License, Copyright (c) 2025-2026 kroet.net. Releases before 2.0.0 were published under the Apache License 2.0; kroet.net additionally makes them available under the MIT License.
• The MIT License covers the code, not the name: forks should use a different plugin name and must not suggest they are the official Timberella.
• Includes TurtleLib by kroet.net (MIT) and bStats Metrics (MIT); MiniMessage and Gson are provided by Paper. All libraries and their licenses are listed in THIRD_PARTY_LICENSES.md, and the license texts ship inside the jar.
• Parts of this plugin and its documentation were produced with AI assistance and reviewed by the maintainer before release.