更好的草

更好的草

该模组使草覆盖山丘和斜坡上砖块的侧面,而不是留下一片裸露的泥土。

生活质量

HiWire - BetterGrass

让草覆盖山坡和斜坡上草方块的侧面,而不是留下一圈裸露泥土的模组。

示例图片 1

预览视频

特性

  • 更好的草方块侧面 - 在地形向下阶梯的地方,草方块会呈现完整的草侧面,而不是每个斜坡上都有一圈泥土边缘
  • 所有草种类 - 适用于全部七种草系:普通、繁茂、干燥、寒冷、阳光、潮湿和枯萎
  • 落叶土壤同样适用 - 落叶层也获得相同处理,并与草连成一片连续表面
  • 修复草混合 - 修正了不同草种类之间的过渡,在原版中它们会同时向两个方向混合并在同一边缘叠加两层遮罩
  • 修复阳光草 - 修复了一个原版 bug:阳光草无法被染色,导致其混合部分固定为一种绿色,与草、泥土和石头都不协调
  • 建造时即时生效 - 你放置的草在符合条件时会立即变为完整形态,挖掘方块时周围方块也会立刻更新
  • 自动运行 - 无需运行命令,无需预先处理世界;玩家探索时地形会自动转换

为什么需要这个模组?

Hytale 其实已经自带了这套美术资源。每个草方块都有一个 _Full 对应版本,其侧面使用草纹理,而不是带边缘的泥土纹理,世界生成会在少数区域定义中手动放置这些变体。但在游戏过程中没有任何机制切换成这些变体,所以阶梯状的山坡每一层都显示一圈泥土带,而不是连续的草坡。

BetterGrass 只是把已有的东西连接起来。

在实现过程中发现了两个原版资源 bug,模组也一并修复:

  • 草种类会同时向两个方向混合。 每种草变体都属于同一个方块组,因此"混合到其他草"和"混合到同类草"是同一条指令。两个相邻方块各自把边缘绘制到对方身上,在同一条接缝上叠加了两层遮罩。
  • 阳光草无法被染色。 它是唯一一个自带烘焙颜色纹理且关闭了染色的草系,所以它的混合部分无论遇到什么都是固定的同一种绿色。

需求

  • Hytale 或 Hytale 服务器
  • Java 25

安装

使用 CurseForge 应用

安装模组最简单的方式是使用 CurseForge 应用,它会自动处理安装和更新。

手动安装

  1. 下载模组 JAR 文件
  2. 将其放入 mods 目录:
    • Windows: %appdata%\Hytale\UserData\Mods
    • Mac: ~/Library/Application Support/Hytale/UserData/Mods
    • Linux (Flatpak): ~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/UserData/Mods
    • 专用服务器: 服务器目录下的 /mods 文件夹
  3. 重启游戏或服务器

由于 Hytale 在单人和多人模式下内部都使用服务器,该模组在两种模式下均可工作。

只有服务器或世界主机需要安装该模组。连接到模组服务器的玩家无需安装任何东西即可看到改进后的草。

工作原理

当一个草方块的每个暴露侧面斜下方都是草时,它就会切换为完整草变体——这正是阶梯状山坡的情况。

转换在三个位置发生,因此无需手动运行任何东西:

时机 内容
区块加载时 在区块发送给任何人之前,内部会先完成转换,因此变化是看不见的
区块变为活动状态时 完成边缘部分的转换,这需要相邻区块才能决定
你放置或破坏方块时 周围的草立即更新

现有世界会在玩家探索时自动转换。新生成的地形在生成时已转换完毕。

对我的世界安全吗?

该模组改变的是真实方块,而不仅仅是外观,因为 Hytale 的方块纹理是按方块类型区分的,且渲染器无法被模组修改。在这里这样做是安全的,原因有三:

  • 两个变体都继承自同一个父方块,因此材质、分组、工具和掉落物完全相同。任何对方块类型有反应的东西都无法区分它们。
  • 模组拒绝转换任何两半掉落物不同的方块对,因此未来 Hytale 更新中的资源更改不会把转换变成物品复制漏洞。
  • 规则是单向的。完整草方块永远不会被转换回去,因为它可能是玩家特意合成并放置的。

命令

命令 描述 执行者 权限
/bettergrass BetterGrass 的根命令 任意 hiwire.bettergrass.command.bettergrass
/bettergrass enabled [true|false] 查看或设置是否运行转换 仅玩家 hiwire.bettergrass.command.bettergrass.enabled
/bettergrass explain <x> <y> <z> 解释某个方块为何转换或未转换 仅玩家 hiwire.bettergrass.command.bettergrass.explain

示例

检查转换是否正在运行:

/bettergrass enabled

关闭转换。已转换的方块保持不变:

/bettergrass enabled false

查明某个方块为何仍有泥土侧面:

/bettergrass explain -956 136 160

explain 会报告方块的每一面:旁边是什么、是否遮挡了该面、斜下方是什么,以及最终判定。它也会输出到服务器日志。

草混合

原版允许草种类同时向两个方向混合,因此两种类型之间的接缝会同时带上双方的边缘。BetterGrass 为每个草系分配独立的方块组和单一的混合方向,遵循游戏已有的优先级:

寒冷 > 繁茂 > 阳光 > 干燥 > 枯萎 > 潮湿 > 普通草

每种类型只向低于它的类型混合,而不向高于它的类型混合,因此每条边界恰好只有一条边缘。普通草、枯萎草和潮湿草之间也会互相混合,而原版完全不会这样做。

来自草系之外并混合到草上的方块——雪、泥、落叶层、苔藓、冰——在所有草类型上仍然有效。

自定义

模组更改的所有内容都以普通资源文件形式存放在 JAR 内的 Server/Item/Items/Soil/Grass 下。你自己的资源包如果覆盖了相同文件,则会优先使用,因此无需重新构建即可更改混合顺序或任何单个纹理。

从源码构建

./gradlew build

编译后的模组 JAR 位于 mod/build/libs/。

在 Hytale 更新后重新生成资源覆盖:

python3 tools/generate_grass_overrides.py \
    --assets /path/to/HytaleAssets/Server/Item/Items \
    --out    mod/src/main/resources/Server/Item/Items \
    --textures-out mod/src/main/resources/Common/BlockTextures

添加 --verify 可在不写入任何内容的情况下检查已发布的文件是否为最新版本。覆盖文件是原版资源的副本,仅改动了两个字段,因此每当 Hytale 更新这些文件时都需要重新生成。

许可证

MIT License

Copyright (c) 2026 HiWire Studio

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

支持

  • 作者: HiWire-Nick