棍木

棍木

一个可以隐藏方块的我的世界模组

Gunwood

Gunwood 是一款 Minecraft 性能和可见性优化模组，专为大型机械区域、复杂装饰建筑及"机械动力"工厂设计。

它添加了一套"透明喷涂"系统：玩家可使用喷涂器给方块涂上"透明漆"，使其在正常视野下隐藏，并尽可能跳过客户端渲染。当玩家佩戴 Gunwood 护目镜时，隐藏的方块会重新显现。

Gunwood 不会删除方块，也不仅仅是替换透明纹理。其目标是通过尽可能跳过已喷涂方块的渲染来减少不必要的渲染工作。

功能

  • 使用喷涂器喷涂方块以隐藏它们
  • 使用刮刀移除透明漆
  • 佩戴 Gunwood 护目镜可重新看见隐藏的方块
  • 使用选择工具一次性喷涂或刮除大面积区域
  • 让已喷涂方块可透光
  • 可配置耐久度、选择范围、覆盖距离及兼容性选项
  • Shift 扩展物品提示文本
  • 支持 Curios，可将护目镜佩戴在头部饰品栏

跳过渲染以提升 FPS

Gunwood 建立在一条简单的理念之上：如果玩家不需要看到某个复杂方块，客户端应尽可能避免渲染它。

Gunwood 不仅仅是将方块视觉透明化，而是尝试跳过它们的渲染路径。这可以减轻客户端在包含大量复杂方块区域中的渲染压力。

这对于以下场景尤其有用：

  • 大型"机械动力"工厂
  • 传动轴、齿轮、水车和风车结构
  • 复杂装饰建筑
  • 隐藏的机械装置
  • 只需偶尔检查的内部机械结构

实际 FPS 提升取决于您的硬件、光影、资源包、模组列表和世界布局。Gunwood 不保证在每种场景下都有固定的 FPS 提升，但其设计目的是减少不必要的渲染工作。

原生"机械动力"兼容

Gunwood 包含对"机械动力"的专用兼容，包括支持：

  • 机械动力方块和外壳
  • 传动轴、齿轮、水车和运动部件
  • 基于飞轮的动态渲染
  • 风车轴承和机械轴承等结构

这使得 Gunwood 在优化大型机械动力工业区域的视觉负载时尤为实用。

Sodium 与光影兼容

Gunwood 包含对 Sodium 区块渲染管线的兼容，即使 Sodium 替换了 Minecraft 的原版区块渲染器，已喷涂方块仍能保持隐藏。

Gunwood 也会尝试在光影环境下正确运行，减少隐藏方块在特殊渲染通道中仍然可见的情况。

FTB Ultimine 兼容

Gunwood 支持 FTB Ultimine/连锁式操作：

  • 使用喷涂器连锁喷涂
  • 使用刮刀连锁刮除
  • 使用选择工具进行区域操作

这使得管理大面积喷涂区域变得更加方便，无需逐个编辑方块。

物品

喷涂器

为方块喷涂透明漆。 未选择区域时，喷涂单个方块或 FTB 连锁目标。使用 Gunwood 选择工具后，喷涂所选区域。

刮刀

移除透明漆。 手持时，会显示附近已喷涂方块和当前选择。支持单方块刮除、区域刮除和 FTB 连锁刮除。

Gunwood 护目镜

让玩家重新看见已喷涂隐藏的方块。 如果安装了 Curios，护目镜也可佩戴在 Curios 头部饰品栏。

选择工具

创建和调整 Gunwood 选择。 提供类似"机械动力"超级胶水的选择体验，包括可见轮廓、鼠标滚轮调整大小和快速清除选择。

配置

Gunwood 提供带有双语注释的易读配置文件。玩家和服务器管理员可配置：

  • 喷涂器和刮刀的耐久度
  • 每次成功使用的耐久消耗
  • 最大选择体积
  • 批量操作限制
  • 透光行为
  • Sodium/机械动力/装置兼容性开关
  • 覆盖渲染范围
  • 轮廓颜色
  • 高级 Shift 提示文本

兼容性

支持的环境：

  • Minecraft 1.21.1
  • NeoForge

可选兼容：

  • Sodium
  • 机械动力
  • Flywheel
  • FTB Ultimine
  • Curios API
  • 常见光影配置

Sodium、机械动力、FTB Ultimine 和 Curios 均为可选项。Gunwood 可在没有它们的情况下运行。

备注

  • Gunwood 不会移除方块。
  • 佩戴 Gunwood 护目镜可重新看见已喷涂方块。
  • 性能提升因场景而异。
  • 对于大型整合包或光影密集的配置，建议先在备份世界中测试。

鸣谢

Gunwood 的选择工具交互设计灵感来自"机械动力"的超级胶水工具。

部分兼容和交互逻辑参考了"机械动力"模组的源代码实现。

"机械动力"由 The Create Team / The Creators of Create 开发。 机械动力的代码基于 MIT 许可证授权，其素材保留所有权利。 本项目不包含也不分发"机械动力"的素材。

Gunwood 由作者开发，在代码建议、调试支持、文档草拟和实现规划方面得到了 AI 工具的协助。

最终实现、测试、平衡、整合决策以及发布准备均由作者完成并审核。

Gunwood 的选择工具交互灵感来自"机械动力"的超级胶水工具，其机械动力/Flywheel 兼容性参考了机械动力/Flywheel 的源码结构实现。