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 damage, particles, and timing stay configurable.
- 🌱 Optional replant + soil checks keep forests alive.
- 🛡️ Species-aware limits (per-tree caps, radii, durability rules) stop griefing before it starts.
- 🔁 Live config + locale reloads merge new defaults automatically—no manual diffing.
- 🔔 Update checker (Modrinth + Hangar) and join reminders keep your fleet current.
- 🌐 MiniMessage-powered localization lets you style player + console feedback exactly the way you like.
Server requirements
- Paper 26.2
- Java 25 runtime
- Optional: a permissions plugin (LuckPerms, etc.) for fine-grained access to
/timberellacommands.
Setup in 3 steps
- Copy the latest
timberella-paper-<version>.jarintoplugins/. - Boot the server once—
config.yml,lang/, andleaf_mappings.ymlappear automatically. - Tweak
plugins/Timberella/config.yml(modules, safety caps, labels) and run/timberella reload.
That's it. The async watcher keeps configs + locales synced, and every reload revalidates permissions, caches, and message bundles.
Everyday tips
- Use
sneak-modeto decide when timbering should trigger (only sneaking, only not sneaking, or always). - Flip specific logs/woods/fences on or off in
categories.*. Unknown materials are ignored safely. - Watch the console after reloads: Timberella prints how many saplings, soils, and species are active plus any typos it auto-fixed.
- Update notifications surface in console and (optionally) to ops with
timberella.update.notify; setupdate-check.notify-console-always-showntrue if you still want "no update" provider summaries every cycle, and leaveupdate-check.filter-by-server-versiontrue so Modrinth/Hangar matches your server build.
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)
Missing keys fall back to English, and /timberella reload hot-reloads both config + language edits.
Need deeper guidance?
This README keeps things short on purpose. All developer and deep-dive documentation (config matrices, command charts, operations guides) lives in the project wiki. Start there whenever you need advanced workflows or contribution notes.
Milestones
Thank you for using my plugin!
- 25 active servers on 2025-11-25
- 50 active servers on 2025-12-06
- 100 active servers on 2025-12-25
- 200 active servers on 2026-01-24
- 300 active servers on 2026-07-18
More stuff
Check out my other projects:
Underwater Trees: Allows placing and growing tree saplings underwater, with optional lightning requirements override.
Get it!
PermaClicker: Simulates continuous left mouse button holding. Ideal for farming while AFK. Optionally suppresses the pause screen, allowing it to run in the background. Motion lock can be activated.
Get it!
License & Credits
- Timberella is released under the Apache License 2.0 (see
LICENSE). - Third-party components such as MiniMessage (MIT), Gson (Apache 2.0), Shadow (Apache 2.0), and bStats (MIT) ship with their respective notices inside
THIRD_PARTY_LICENSES.mdand the packagedlicenses/folder. - Parts of this plugin and documentation were produced with AI assistance (e.g., GitHub Copilot) and reviewed by the maintainer before release.
