GeckoMesh

GeckoMesh

为GeckoLib打造的一款高级、轻量级PolyMesh渲染库。将基岩版风格的几何体带到你的实体中——且零运行成本。

GeckoMesh 图标

GeckoMesh

一款为 GeckoLib 打造的高级轻量级 PolyMesh 渲染库。
为你的实体带来基岩版风格几何体 —— 且零运行时开销。

CurseForge Discord MIT 许可证 Minecraft 版本

什么是 GeckoMesh？

GeckoMesh 是一个面向开发者的兼容性库，它为基于 GeckoLib 的模组解锁了基岩版风格 PolyMesh 几何体。它直接挂钩模型烘焙管线，并将烘焙好的 PolyMesh 面直接附加到 GeckoLib 原生的 GeoBone 结构中 —— 因此你的自定义低多边形网格开箱即用，无需任何改造。

无论你是在构建一个新实体模组，还是扩展现有模组，GeckoMesh 都能静默高效地嵌入其中，并从一个库 JAR 中同时支持 Fabric、Forge 和 NeoForge。

功能特性

功能 详情
⚡ 零运行时开销 所有 PolyMesh 处理均在模型烘焙期间完成。无每帧性能成本。
🦎 GeckoLib 原生集成 烘焙后的 PolyMesh 几何体直接附加到 GeckoLib 的 GeoBone 列表中。
🔀 跨平台 单一代码库同时面向 Fabric、Forge 和 NeoForge。
📐 智能 UV 与法线计算 自动标准化 UV 坐标并计算平面着色面法线。
🧩 即插即用库 无需配置文件，无需注册。添加 JAR 即可工作。
📦 轻量级 JAR 体积极小。无臃肿内容，除 GeckoLib 外无多余依赖。

工作原理

GeckoMesh 使用一个自定义的 Mixin 拦截 GeckoLib 的骨骼构建阶段。当在模型 JSON 中检测到 PolyMesh 块时，该库的反序列化器便会启动，将网格几何体扁平化为一组 GeoCube 条目，并在管线继续之前将它们注入到骨骼中。最终得到的是 GeckoLib 原生渲染的完全烘焙几何体 —— 无需自定义渲染层，无需着色器技巧。

兼容性

平台 加载器版本 Minecraft 版本
🧵 Fabric Fabric Loader >= 0.14 1.20.1 → 1.21.11
⚒️ Forge Forge 47.x 1.20.1 → 1.21.11
🔷 NeoForge NeoForge 20.4.x 1.20.4 → 1.21.11

必需依赖： GeckoLib  |  Java： 17 或更高版本

安装方法

  1. 确保 GeckoLib 已针对你的加载器和 Minecraft 版本安装。
  2. 从 文件 标签页下载适用于你平台的 GeckoMesh JAR：
    • geckomesh-fabric-1.20.1-1.21.11-1.0.0.jar
    • geckomesh-forge-1.20.1-1.21.11-1.0.0.jar
    • geckomesh-neoforge-1.20.4-1.21.11-1.0.0.jar
  3. 将下载的 JAR 放入你的 .minecraft/mods 文件夹中。
  4. 启动游戏 —— GeckoMesh 会自动注册。无需任何配置。

面向开发者

GeckoMesh 主要是一个库模组。如果你正在构建一个使用 GeckoLib 的模组，并希望发布基于 PolyMesh 的几何体，只需在模组元数据中将 GeckoMesh 声明为依赖即可。你模型 JSON 中的所有 PolyMesh 块都会被自动识别。

该库提供了一个简洁的 Mixin 插件 API 和一个 JSON 工具类（MixinJsonUtil），用于高级用法。源码和示例可在下方链接的仓库中找到。

致谢

  • 作者： Bay4lly
  • 许可证： MIT
  • 灵感来源： Bernie-G 与 GeckoLib 团队制作的 GeckoLib

💬 加入 Discord  |  📦 CurseForge  |  🐱 GitHub

 

Blockbench Meshy 插件的 GeckoMesh 分支：

https://raw.githubusercontent.com/Bay4lly/geckomeshy/main/geckomeshy.js

 

安装步骤：