Dynamic Trees

项目目标

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

我们的核心价值是：

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

也试试 Dynamic Trees Plus！

特性

生长中的树是由生根土壤、树枝和树叶方块组成的多方块结构，相比原版 Minecraft 的树木结构有许多进步。树的形成始于种子。种子可以像原版树苗一样手工种植，或者如果留在合适位置的地面上，有几率自行种植。然后树从树苗开始生长，随着时间缓慢增大尺寸，最终长成完整大小的树。之后可以在树的基部将其砍倒，一次性收获所有木材。

树木

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

生根土壤

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

药水

• 生物炭基底：用于酿造的基底树药水
• 枯竭药水：完全耗尽土壤，使树木停止生长
• 繁茂药水：为树木完全施肥，随后使其生长更快，直至肥力耗尽
• 转化药水：将现有的动态树转变为另一种树种
• 巨化药水：将树木转化为其巨型变种（若可用）。默认适用于云杉和丛林树。

种子

• 取代原版树苗
• 由树木随机掉落（可配置）
• 若放置在森林中的泥土/草方块/灰化土上且上方天空无遮挡，可自行种植（可配置）

兼容性

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

季节系统

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

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

若附加模组默认不兼容，也可自行集成季节系统。

森林

• 随着树木掉落种子，森林线会向外扩展。
• 相邻的树木会争夺阳光，长得比开阔处的树木更高更细。这会产生森林树冠效果。
• 树冠遮挡天光，形成黑暗森林，白天可生成怪物，树苗无法茁壮成长。
• 某些树种的黑暗树冠下，泥土或草方块会形成灰化土。灰化土旨在模拟森林落叶层的外观。

采伐

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

林地法杖

林地法杖是一种多功能工具，专为创造模式设计（无法合成）。最基本的用法是复制树木。用法杖右键点击任意动态树木即可提取其 JoCode。接着右键点击合适的土壤即可重建相同的树木。树木还会根据玩家朝向旋转。如果玩家潜行时用法杖右键点击树木，则只会复制树种，JoCode 保持不变。

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

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

Dynamic Trees Plus

     Dynamic Trees Plus 是 Dynamic Trees 模组的扩展，仅限 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：树木成功变为不可拳击破坏，祝你好运！

如前所述，实现季节系统的模组将与动态树的季节系统兼容。

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

不兼容模组

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

项目范围

技术细节

许可证、权限与整合包

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