
BlackTimber 是一款专为 Minecraft Java Edition 编写的智能伐木插件,从底层开始构建以适配 Folia。只需击碎一根原木,整棵树便会在一瞬间倒下,并由你手中的斧头自动收集。木屋、树屋以及手工建造的树木将永远不会被触碰。无需安装任何额外依赖:没有库插件,没有数据库,也无需进行任何设置。
功能特性
经典的伐木插件会砍伐所有由原木构成的物体,这使其在基地附近成为一种隐患。BlackTimber 仅砍伐自然生成的树木,并且在移除任何额外的原木之前,它会先验证一棵树是否为野生状态。

只有当以下三项检查均确认树木为野生状态时,一簇原木才会倒下:
- 天然树叶。 野生树叶的
persistent(持久性)属性为 false。如果一团叶子中没有任何非持久性树叶,则被视为建筑并予以保留。
- 放置的原木。 系统会记住玩家放置的每一根原木。只要有一根原木是玩家放置的,整棵树就会受到保护。
- 附属结构。 与原木接触的木板、楼梯、台阶、栅栏、墙或玻璃会将该簇原木标记为玩家建筑。
为何选择它
- 保护建筑。 在基地附近挥动斧头时,不会误删墙壁、地板或树屋。
- 高效且原生支持 Folia。 伐木操作在与原木所在的区域线程绑定的线程上运行,大规模伐木分散到多个刻中执行,且从不使用传统调度器。
- 独立运行。 无外部依赖,无数据库,因此无需安装或维护任何额外组件。
游戏内菜单
每位玩家都可以为自己切换三个开关,设置按玩家单独保存。

管理员可以实时调整十八项设置,更改后直接写入配置文件,无需重载。

树叶掉落奖励通过拖放编辑器手动配置。

要求
- Folia 或 Paper
26.1.2(api-version: 26.1)。
- Java
25。
命令与权限
| 命令 |
权限 |
/blacktimber 打开你的菜单 |
blacktimber.use |
/blacktimber on / off / toggle / leaves / pickup / status |
blacktimber.use |
/blacktimber admin 打开管理面板 |
blacktimber.admin |
/blacktimber reload |
blacktimber.admin |
blacktimber.use 默认对所有玩家开放,blacktimber.admin 默认对操作员开放。
遥测与隐私
BlackTimper 每十五分钟报告一次匿名使用统计数据:包括一个随机服务器 ID、在线玩家数量以及软件名称和版本字符串。不存储任何 IP 地址,从未发送任何玩家名称或 UUID,且数据无法关联到任何个人。这些数据是匿名且聚合的,其理念与 bStats 相同。若希望完全退出,可在 config.yml 中设置 telemetry: false。完整披露请参阅 TELEMETRY.md。
链接
完整文档位于 docs.cebi.tr;配置参考、源代码和问题追踪器均在 GitHub 上提供。

BlackTimber is a smart tree felling plugin for Minecraft Java Edition, written from the
ground up for Folia. Break a single log and the whole tree comes down in one motion,
gathered with the axe in your hand. Wooden houses, tree houses and hand built trees are
never touched. There is nothing to install alongside it: no library plugin, no database,
no setup.
What it does
Classic timber plugins fell anything made of logs, which makes them a liability near a
base. BlackTimber fells only what nature grew, and it proves a tree is wild before a single
extra log is removed.

A cluster of logs comes down only when all three checks agree it is wild:
- Natural leaves. Wild leaves are
persistent = false. A cluster with none is treated
as a build and left alone.
- Placed logs. Every log a player places is remembered. One placed log protects the
whole tree.
- Attached structures. Planks, stairs, slabs, fences, walls or glass touching the logs
mark the cluster as a build.
Why you want it
- It protects builds. A stray swing near your base will not delete a wall, a floor or a
tree house.
- It is fast and Folia native. Felling runs on the region thread that owns the log, large
fells are spread across ticks, and the legacy scheduler is never used.
- It is self contained. No external dependencies and no database, so there is nothing to
install or maintain alongside it.
In game menus
Every player flips three switches for themselves, saved per player.

Admins tune eighteen settings live, written straight to config with no reload.

Bonus leaf loot is built by hand in a drag and drop editor.

Requirements
- Folia or Paper
26.1.2 (api-version: 26.1).
- Java
25.
Commands and permissions
| Command |
Permission |
/blacktimber open your menu |
blacktimber.use |
/blacktimber on / off / toggle / leaves / pickup / status |
blacktimber.use |
/blacktimber admin open the admin panel |
blacktimber.admin |
/blacktimber reload |
blacktimber.admin |
blacktimber.use defaults to everyone, blacktimber.admin defaults to operators.
Telemetry and privacy
BlackTimber reports anonymous usage stats every fifteen minutes: a random server id, the
online player count, and the software and version strings. No IP address is stored, no
player names or UUIDs are ever sent, and nothing is linked to any person. The data is
anonymous and aggregate, in the same spirit as bStats. Opt out completely with
telemetry: false in config.yml. Full disclosure is in
TELEMETRY.md.
Links
A full write up lives at docs.cebi.tr; the
configuration reference, the source code and the issue tracker are on
GitHub.
评论 0
登录后参与评分
还没有评论,来抢沙发吧