适用于 Minecraft 1.20.1, 1.21.1 的 Dynamic Trees 模组

项目目标

在尊重 Minecraft 图形风格化的前提下，创造更具动态感、美观、有趣且自然的树木，同时坚持精简的项目范围，保持简单。

我们的核心价值是：

• 与 Minecraft 的美学风格沉浸式融合
• 保持项目范围精简
• 性能影响最小化
• 以模组兼容性为核心

也试试 Dynamic Trees Plus！

特性

一棵生长中的树是由带根土壤、树枝和树叶方块组成的多方块结构，相比原版 Minecraft 的树木结构有许多进步。树的形成始于一颗种子。这颗种子既可以像原版树苗一样手动种下，也可以留在合适位置的地面上时有机会自行种植。随后树从树苗开始生长，随着时间缓慢增大体型，最终长成完全成熟的树。之后可以在树的基部将其砍倒，一次性收获所有木材。

树木

• 随着时间从种子逐步生长为成熟树木。
• 以大致模仿现实世界树木的自然方式生长，往往以独特而可信的方式生长。
• 以自然的方式绕过障碍物生长。
• 并非只是换皮，而是每个树种使用不同的算法生长。
• 生长速度和成熟尺寸取决于生物群系、温度和降雨量。
• 随机掉落种子，种子有可能自行种植。
• 不会在黑暗中生长。未连接到外层树枝或缺乏光照的树叶会死亡。没有树叶的外层树枝会缓慢腐烂。
• 会在黑暗的地方死亡并腐烂（某些树种腐烂时会生成蘑菇）。
• 在树叶方块上行走缓慢且会下陷。摔落到树叶上可防止摔落伤害并摧毁树叶。
• 原版水果（苹果和可可豆）拥有各自的自定义树种以将其区分开。（苹果是橡树的变种，可可是丛林木的变种）
• 细树枝可以像梯子一样攀爬。
• 树木拥有自定义音效，用于砍伐、落地、落到水面或修剪。
• 树木落地时树叶上会产生粒子效果。

成熟的橡树

带根土壤

• 为树木提供养分，并会随时间耗尽
• 施加骨粉会提高土壤肥力，并允许树木生长超过其成熟状态
• 施加各种酿造药水可产生不同效果（见下一节）
• 当对土壤或最底部的树干方块施加作用物质时，整棵树上会产生特殊效果粒子
• 可以使用比较器来感应土壤肥力水平

药水

• 生物炭基底：用于酿造的基础树木药水
• 枯竭药水：完全耗尽土壤，使树木停止生长
• 萌发药水：完全施肥于树木，然后使其生长更快，直到肥力耗尽
• 转化药水：将现有的动态树转变为另一种树种
• 巨化药水：将树转变为其巨型变种（如果有）。默认情况下适用于云杉和丛林树。

种子

• 取代原版树苗
• 从树上随机掉落（可配置）
• 如果放置在森林中的泥土/草方块/灰化土方块上，且其上方天空视野清晰，则可以自行种植（可配置）

树苗（上排：橡树、云杉、白桦、丛林。下排：金合欢、深色橡树、绯红菌、诡异菌）及其各自的种子。

兼容性

• 原版树木正常运作。
• 可以禁用世界生成，以允许原版树木仍然生成。
• 生长中的树木的所有掉落物都是原版树叶、木棍和原木。树枝在生存模式下无法获得。剪刀只能获得原版树叶。
• 木材和树叶使用原版纹理，使其对资源包友好。
• 种子可以用原版树苗和泥土桶合成，反之亦然。
• 火的蔓延和燃烧速度与原版树木火灾相同。

季节系统

Dynamic Trees 为其树木完整实现了季节系统，默认与 Serene Seasons 兼容。树木会响应气候并相应地减缓/停止生长。水果也有特定的收获季节和开花季节。有关水果及其偏好季节的完整列表，请访问 wiki。

此系统至少需要一个季节模组才能激活。

如果附加内容默认尚不兼容，它们也可以集成季节系统。

森林

• 随着树木掉落种子，森林边界会扩散。
• 当树木彼此靠近时，它们会争夺阳光，长得比开阔地的树木更高更细。这会产生森林树冠效果。
• 树冠会阻挡天空光照，形成黑暗森林，使怪物在白天也能生成，树苗也无法茁壮成长。
• 在某些树种的黑暗森林树冠下，泥土或草方块会形成灰化土。灰化土旨在模拟森林落叶层的外观。

橡树林的边缘

平原旁的橡树林

稀疏分布着金合欢的稀树草原

海岸附近的针叶林，其后是巨型针叶林

茂密森林中细长的白桦树

高大丛林树的树冠形成光线昏暗的森林地面

一片阴沉的绯红森林，旁边是较小的诡异森林

采伐

• 在树的基部砍伐将放倒整棵树
• 较粗的树枝需要更长时间采伐
• 可以整枝从树上移除，而不影响树的主体
• 采伐会产出原版原木和木棍，其数量按树或树枝中木材的总体积计算
• 斧头上的时运附魔实际上很有用，可以增加原木产量
• 工具会按采伐的原木数量损耗耐久（可配置）
• 如果外层树枝未受损，树叶被破坏后会重新长出
• 树木被采伐时会倒下（可配置）

林地法杖

林地法杖是一种多功能工具，旨在创造模式中使用（无法合成）。在最基本的用法中，它可以用来复制一棵树。用该法杖右键点击任何动态树以提取其 JoCode。接下来，右键点击合适的土壤以重新创建相同的树。树还会根据玩家朝向旋转。如果玩家在潜行时用法杖右键点击一棵树，则只会复制树种，JoCode 保持不变。

通过这种方式，例如你可以创建一棵形状像高大丛林树的金合欢树。

林地法杖的另一个功能是，从树上提取的任何 JoCode 也会作为文本复制到系统剪贴板。这使玩家能够轻松地与他人分享树木模型。

Dynamic Trees Plus

Dynamic Trees Plus 是 Dynamic Trees 模组的扩展，专属于 1.16.5 及以上版本，旨在添加其他不适合本模组范围的植被的动态版本，例如仙人掌和巨型蘑菇。

恶地生物群系中的巨人柱仙人掌（Dynamic Trees Plus 1.16.5 或更高版本的功能）

树木包

树木包是 Dynamic Trees 中实现的类似数据包的 JSON 系统，允许完全自定义动态树和你的世界，它们是任何附加内容的支柱，也是用户和整合包制作者的强大工具。

树木包能做什么？

• 修改任何树的属性，例如生长速度、尺寸、树叶方块、树叶类型、生长形状、树干粗细、掉落物等等！
• 使用任何方块作为基础创建全新的树。
• 创建自定义水果和豆荚。
• 为任何树添加自定义特性，例如藤蔓、开花树叶。
• 即使没有编程知识的人也易于学习和使用。

有关树木包的更多信息和指南，请访问 https://github.com/DynamicTreesTeam/DynamicTrees/wiki/Tree-Packs 或加入我们的 discord。

模组兼容性

附加内容

附加内容是使用 Dynamic Trees API 以更模块化和可维护的方式将模组树木纳入其中的模组。这避免了基础 Dynamic Trees 模组的臃肿，后者只包含原版 Minecraft 树木。以下是 DynamicTreesTeam 和其他模组作者开发的附加内容当前列表。有关这些模组能够提供哪些树木的信息，请参阅它们各自的项目页面。

• 有关附加内容的完整列表，请访问 https://github.com/DynamicTreesTeam/DynamicTrees/wiki

兼容的模组

这些模组的功能与 Dynamic Trees 良好融合，兼容性显著或已明确提供。不在此列表中的模组不一定不兼容。

• Create：树木切割机可与动态树配合使用
• Distant Horizons：树木在 LOD 区块中按预期渲染。
• Better Foliage：树叶方块将按预期增强（不适用于树干圆角功能）
• Better Beginnings：无法徒手砍倒树木，工具按预期工作。
• Passable Leaves / Passable Foliage：安装此模组后，动态树的树叶变得可穿过。
• No Tree Punching：树木成功无法被拳打，祝你好运！

如前所述，实现季节的模组会与 Dynamic Trees 的季节系统兼容。

• Serene Seasons
• Better Weather：自 1.16+ 的 0.10.0 Beta 23 起

不兼容的模组

• Applied Energistics 2：陨石生成会破坏动态生成的树木。
• Tree Chopper：已知会导致崩溃或使树木不掉落任何东西。
• Liquid Luck：已知安装此模组后，动态树不会掉落原木和木棍。
• Cave Biomes API：对区块生成的更改会使树木生成不正确

项目范围

项目范围

范围内功能的示例

• 树木，且仅限树木。
• 提供原版树木的高级生长版本
• 零到最小配置。应使用合理的设置或默认值开箱即用
• 为其他模组开发者提供接口，以通过附加内容、新树木、效果、生物和其他内容扩展模组。如果你需要钩子，请告诉我 :)
• 响应季节变化
• 在适当时与其他流行模组实现兼容
• 风格化不应偏离 Minecraft 美学。方块模型的所有部分都应由长方体棱柱组成，每个面都对齐到 1/16 米（标准 Minecraft 纹理像素）

范围外功能的示例

• 原版 Minecraft 中未实现的树种（例如 Forestry、Pam's Harvestcraft、Natura、Biomes O' Plenty 中的树种）。如需与这些兼容，请参阅附加内容部分。
• 生物实体、怪物和/或粒子（树人、松鼠、猴子、萤火虫等）
• 水果（原版 Minecraft 树木水果产品除外：苹果、可可豆）
• 地牢战利品（对本模组毫无意义）
• 树村、村民和/或贸易站
• 秋千或其他通常挂在树上的小装置
• 魔法、能量系统、经验掉落、附魔
• 工具和/或服饰（在生存模式中，管理工具可能可以）
• 嫁接
• 树木遗传学和/或授粉，例如 Forestry 中的
• 自动肥料、探测器或任何与树交互的机器

此类功能永远不会被实现。我并不是说这些是坏主意或不好玩，但它们确实超出了这个项目旨在实现的范围。

希望实现范围外功能的人欢迎在单独的扩展或兼容模组中这样做。流行的模组往往会经历范围蔓延和功能膨胀。最终你会得到喷气背包、金属矿石树、彩虹猫、燃烧的超级死亡仙人掌剑，以及 15 种苦力怕。我不会允许这种情况发生。

技术细节

技术细节

底层机制

树木生长使用树叶的元胞自动机算法与树干和树枝的树枝网络逻辑相结合。不使用方块实体渲染。渲染使用 BakedModels 完成，以便在大量树节点时获得更好的性能。树叶仅通过 updateTick() 更新，因此区块重新渲染的频率不会超过原版作物。使用 DropCreator 接口来创建种子掉落物和其他物品。其他模组可以注册新的掉落创建器，以扩展现有或新的树木行为。世界生成使用自适应增量点画（AIS）的自定义变体，使用泊松圆盘分布以实现高质量且不重叠的树木放置。季节数据可在此处获取

许可证、权限和整合包

特此授予在任何整合包或服务器中使用此模组的权限。请不要在我已经告诉你可以在你的整合包中使用该模组之后，还来请求许可，这很烦人。署名会很好，但我不要求。未经提供 CurseForge 下载链接和我的许可，你不得将此模组重新发布到其他网站。我有没有提到你有权限在你的整合包中使用此模组？……很好！你在认真听！