https://github.com/hrobasti/timberella-plugin
Tree capitator / cutting / felling, leaves decay and replanting abilities. Completely configurable.
https://github.com/hrobasti/timberella-plugin
gaming minecraft papermc plugin server server-side
Last synced: 2 months ago
JSON representation
Tree capitator / cutting / felling, leaves decay and replanting abilities. Completely configurable.
- Host: GitHub
- URL: https://github.com/hrobasti/timberella-plugin
- Owner: hrobasti
- License: apache-2.0
- Created: 2025-11-20T13:52:33.000Z (7 months ago)
- Default Branch: default
- Last Pushed: 2026-04-12T13:52:22.000Z (2 months ago)
- Last Synced: 2026-04-12T15:18:41.491Z (2 months ago)
- Topics: gaming, minecraft, papermc, plugin, server, server-side
- Language: Java
- Homepage:
- Size: 12.4 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Timberella 🌲
Drop-in quality-of-life plugin for Paper 26.1.x 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.1, 26.1.1, or 26.1.2 (Spigot/vanilla forks 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-.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. The async watcher keeps configs + locales synced, and every reload revalidates permissions, caches, and message bundles.
## Everyday tips
- Use `sneak-mode` to 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`; set `update-check.notify-console-always-shown` true if you still want “no update” provider summaries every cycle, and leave `update-check.filter-by-server-version` true 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.
## 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.md` and the packaged `licenses/` folder.
- Parts of this plugin and documentation were produced with AI assistance (e.g., GitHub Copilot) and reviewed by the maintainer before release.