关于模组
本模组将 Minecraft 原版 CPU 顶点变换管线卸载至 GPU 计算着色器执行。简单来说:Minecraft 在渲染实体模型时,CPU 需要逐顶点进行矩阵变换,这在实体密集的场景中会成为性能瓶颈。
AcceleratedRendering 拦截渲染调用,将几何数据构建为 GPU Mesh 并缓存,由 GPU 并行执行顶点变换,最后提交批量绘制调用——从而降低 CPU 侧开销。
加速范围
已加速:实体模型、实体阴影、世界中的掉落物和手持物品、方块模型(包括着色)、文字渲染(BakedGlyph / Font)、GUI 容器界面(填充、blits、槽位、字体、物品和高亮的批处理)。还提供对实体、方块实体和容器的选择性过滤功能,允许按需将特定类型排除出加速管线。
不可用:第一人称手部物品加速。完整的链路分析显示,在注入点处,视锥体矩阵和手部投影矩阵理论上应相互抵消,但实际渲染仍表现出透视拉伸。此路径已回退至 vanilla 渲染管线,等待未来的运行时调试。
模组兼容
已验证:Iris Shaders 1.8.8(带有专用计算着色器和扩展顶点格式支持)、ModernUI 3.12.0.3(文字、字形和轮廓的批处理渲染)、Sodium 0.6.13(编译时兼容)。
由于版本变更,兼容性代码已编写但尚未完全验证:ImmediatelyFast、Create、EMF(Entity Model Features)、GeckoLib 4.8、Touhou Little Maid、FTB Library、Trinkets、Tweakmore、Sophisticated Core。
配置
通过 ModMenu 打开游戏内配置屏幕,可独立切换每种渲染类型的加速开关,在加速和 vanilla 管线之间切换,调整 Mesh 收集和缓存策略,编辑过滤器白名单/黑名单,并控制各种兼容模组功能的运行行为。
已知问题
手部物品加速因矩阵拉伸目前不可用。 Tweakeroo Free Camera:快速切换自由摄像机(灵魂出窍)可能会在 GUI 批处理中偶尔触发 renderType 为 null 的 NPE。由于无法可靠复现,目前保持未修复状态。
致谢
本模组源自 Argon4W 的 NeoForge 原版,经过 ZhuRuoLing 的 Fabric 1.21.1 移植版和 Luna5ama 的 NeoForge 1.21.4 移植版迭代而来。Fabric 1.21.4 适配由 namelessgod2008 完成(AI 辅助)。根据 MIT License 发布。
注意:此版本为社区移植版。如果遇到任何问题,请向移植者(namelessgod2008)报告。请勿向原作者 Argon4W 报告。
About the Mod This mod offloads Minecraft's vanilla CPU vertex transformation pipeline to GPU compute shaders. In simple terms: vanilla Minecraft performs per-vertex matrix transformations on the CPU when rendering entity models, which becomes a performance bottleneck in entity-dense scenes.
AcceleratedRendering intercepts rendering calls, builds geometry data into GPU meshes and caches them, performs vertex transformations in parallel on the GPU, and finally submits batched draw calls — reducing CPU-side overhead.
Acceleration Scope Accelerated: entity models, entity shadows, dropped items and held items in the world, block models (including tinting), text rendering (BakedGlyph / Font), GUI container screens (batching of fills, blits, slots, fonts, items, and highlights). Also provides selective filtering for entities, block entities, and containers, allowing specific types to be excluded from the acceleration pipeline on demand.
Unavailable: first-person hand item acceleration. Full chain analysis shows that at the injection point, the frustum matrix and hand projection matrix should theoretically cancel each other out, but actual rendering still exhibits perspective stretching. This path has been reverted to the vanilla rendering pipeline, pending future runtime debugging.
Mod Compatibility Verified: Iris Shaders 1.8.8 (with dedicated compute shaders and extended vertex format support), ModernUI 3.12.0.3 (batched rendering for text, glyphs, and outlines), Sodium 0.6.13 (compile-time compatibility).
Compatibility code written but not yet fully verified due to version changes: ImmediatelyFast, Create, EMF (Entity Model Features), GeckoLib 4.8, Touhou Little Maid, FTB Library, Trinkets, Tweakmore, Sophisticated Core.
Configuration Open the in-game configuration screen via ModMenu to independently toggle acceleration for each render type, switch between accelerated and vanilla pipelines, adjust mesh collection and caching strategies, edit filter allow/block lists, and control the behavior of various compatibility mod features.
Known Issues Hand item acceleration is currently unavailable due to matrix stretching. Tweakeroo Free Camera: rapidly toggling Free Camera (soul departure) may trigger an occasional NPE in GUI batching where renderType is null. Cannot be reliably reproduced, so this remains unfixed for now. Credits This mod is derived from Argon4W's NeoForge original, iterated through ZhuRuoLing's Fabric 1.21.1 port and Luna5ama's NeoForge 1.21.4 port. The Fabric 1.21.4 adaptation was completed by namelessgod2008 (AI-assisted). Released under the MIT License.
Note: This version is a community port. If you encounter issues, please report them to the porter (namelessgod2008). Do not report them to the original author Argon4W.
关于模组
本模组将 Minecraft 原版的 CPU 顶点变换管线迁移至 GPU 计算着色器执行。简单来说:原版渲染实体模型时,CPU 需要逐顶点计算矩阵变换,实体密集场景下这会成为性能瓶颈。
AcceleratedRendering 拦截渲染调用后,将几何数据构建为 GPU Mesh 并缓存,由 GPU 并行完成顶点变换,最后统一提交批量绘制,从而降低 CPU 侧开销。
加速范围
已实现加速:实体模型、实体阴影、世界中的掉落物与手持物品、方块模型(含着色)、文字渲染(BakedGlyph / Font)、GUI 容器界面(填充、位块传输、槽位、字体、物品、高亮的批处理)。另提供实体、方块实体、容器的选择性过滤功能,可按需将特定类型排除出加速管线。
不可用:第一人称手部物品加速。经完整链路分析,注入点处 frustum 矩阵与手部投影矩阵理论上应相互抵消,但实际渲染仍存在透视拉伸,已回退至原版渲染路径,待后续运行时调试。
Mod 兼容
已适配 Iris Shaders 1.8.8(含专属计算着色器与扩展顶点格式支持)、ModernUI 3.12.0.3(文字、字形、轮廓的批处理渲染)、Sodium 0.6.13(编译时兼容)。以下 Mod 兼容代码已编写,因版本变动尚未全面验证:ImmediatelyFast、Create、EMF(Entity Model Features)、GeckoLib 4.8、Touhou Little Maid、FTB Library、Trinkets、Tweakmore、Sophisticated Core。
配置
通过 ModMenu 打开游戏内配置界面,可独立开关各渲染类型的加速、切换加速/原版管线、调整 Mesh 收集与缓存策略、编辑滤镜黑白名单、以及控制各兼容 Mod 功能的启停。
已知问题
手部物品加速因矩阵拉伸暂不可用。Tweakeroo Free Camera(灵魂出窍)快捷键切换瞬间,GUI 批处理中可能出现 renderType 为空的偶发 NPE,因无法稳定复现暂未修复。
本模组系从 Argon4W 的 NeoForge 原版经由 ZhuRuoLing 的 Fabric 1.21.1 移植和 Luna5ama 的 NeoForge 1.21.4 移植迭代而来,Fabric 1.21.4 适配由 namelessgod2008 完成(AI 辅助)。MIT 协议开源。
注意:本版本为社区移植,如有问题请向移植者(namelessgod2008)反馈,请勿向原作者 Argon4W 汇报。
下载 AcceleratedRendering-Ported
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AcceleratedRendering-Ported
下载 AcceleratedRendering-Ported
加速渲染 — Minecraft 26.1 移植版
Alpha · 状态与覆盖范围
English
1. 简介
Accelerated Rendering 是一个客户端渲染修改模组,它使用**计算着色器(compute shaders)**将顶点变换从 CPU 移至 GPU。
与其在每一帧都在 CPU 上将每个顶点乘以模型矩阵,该模组会一次性上传模型空间的顶点数据,缓存生成的网格,并在 GPU 上执行变换。对于重复绘制相同几何体(例如,许多相同的实体或掉落物)的情况,它们共享同一个缓存网格,仅通过每实例的数据(如变换、颜色、光照和叠加层)来区分。
本仓库是原版 Minecraft 1.21.4 模组到 Minecraft 26.1 的移植版本。
| Mod ID | acceleratedrendering |
| Version | 1.0.15-alpha |
| Environment | 仅限客户端 |
| License | MIT |
| Original author | Argon4W |
| Port author | namelessgod2008 |
2. 依赖项
| Component | Version |
|---|---|
| Minecraft | 26.1 |
| Fabric Loader | 0.19.5 或更高版本 |
| Java | 25 或更高版本 |
| Fabric API | 必需 |
| Forge Config API Port | 必需(用于配置界面) |
3. 为何该方法在 26.1 中依然适用
Minecraft 26.1 重写了其渲染架构,因此有必要明确指出:原版 26.1 仍然在 CPU 上执行顶点变换:
- 实体与方块实体 —
ModelPart.Cube.compile对每个立方体的每个顶点,在每一帧都调用matrix.transformPosition(...)。 - 物品 —
VertexConsumer.putBakedQuad对每个四边形的每个顶点都调用matrix.transformPosition(...)。
原版的顶点着色器仅应用相机旋转(gl_Position = ProjMat * ModelViewMat * vec4(Position, 1.0),其中 ModelViewMat 包含旋转但不包含平移)。因此,模型变换实际上已经烘焙到 CPU 上的顶点数据中了。
26.1 的原版代码中没有计算着色器、没有实例化顶点属性,也没有间接绘制或多重绘制功能。本模组的 GPU 端变换在原版的 Vanilla 中没有对应实现,因此该方法依然有效。
4. 已实现的功能
4.1 实体与方块实体渲染加速
通过 ModelPart 生成的模型几何体会被拦截,作为 GPU 网格进行缓存,并在 GPU 上进行变换。这涵盖了活体实体、其他实体,以及通过相同模型管线渲染的方块实体(例如箱子)。
- 网格缓存具有键值标识,使其能够跨帧保留。
- 绘制批处理层级复现了原版的
order(int)分组,使得盔甲、装饰和渲染层级保持正确的相对绘制顺序。
4.2 物品渲染加速
物品模型几何体(BakedQuad)会被缓存并在 GPU 上进行变换。
- 属于同一物品提交的四边形会被合并为每个
(tintIndex, lightEmission)组一个网格,而不是每个四边形一个网格。 - 每顶点法线在模型空间中烘焙;GPU 应用姿态法线矩阵,这在数学上等同于原版的
pose.transformNormal(quad.direction().getUnitVec3f())。 - 每实例的颜色、光照和叠加层在绘制时提供,因此单个缓存网格即可服务于所有实例。
4.3 实体阴影加速
实体阴影被路由至加速管线,而非原版写入器。阴影几何体、透明度和形状数据取自原版在提取阶段已计算出的值。
4.4 原版绘制顺序保留
26.1 分两个阶段渲染实体:一个仅记录数据的提交阶段,和一个写入顶点的渲染阶段。由于加速路径按批处理层级对几何体进行分组,原版的 order(int) 桶被映射到加速层级上,从而恢复原始的相对绘制顺序。
4.5 光影包兼容性 (Iris)
包含并启用了 Iris 兼容模块。它处理以下事项:
- 在缓冲区入口点解包 Iris 包装的
RenderType实例。 - 将加速输出重新路由至 Iris G-buffer。
- 支持阴影通道,以便阴影渲染使用其专属目标。
- 适配 Iris 1.11.x API 表面。
4.6 朝向剔除
每四边形朝向剔除功能作为一个程序分发器集成到核心绘制路径中,拥有独立的配置部分。
4.7 绘制方法
支持两种可选择的绘制方法:
- BASEVERTEX(默认)— 使用带有基础顶点偏移量的共享索引缓冲区。
- INDIRECT — 通过 mixin 桥接执行间接绘制,因为 26.1 的
RenderPassAPI 没有间接入口点。
4.8 配置
配置通过 Forge Config API Port 提供,由该库提供游戏内配置界面以及 Mod Menu 入口点。
配置部分包括:核心设置、加速实体渲染、加速物品渲染、过滤器、Iris 兼容性、剔除以及模组兼容性开关。
5. 此构建中未实现的功能
上游模组的以下部分在此 Alpha 版本中被排除在编译之外。源文件保留在仓库中,但未编译或注册。
5.1 物品渲染
- GUI 物品渲染 —
features/items/gui/**和features/items/mixins/gui/**(GUI 批处理、加速 blit / fill / gradient、字符串渲染)。 - 完整模型烘焙路径 —
ItemRendererMixin,ModelBlockRendererMixin,features/items/mixins/models/**,features/items/mixins/accessors/**。这些依赖于 26.1 中移除的类(ItemRenderer,BakedModel,SimpleBakedModel,MultiPartBakedModel,WeightedBakedModel),且在 26.1 架构中没有直接等效项。 - 方块/物品颜色辅助类 —
BlockLayerColors,ColorHelper,EmptyBlockColor,ItemLayerColors,IAcceleratedBakedModel。26.1 用方块染色源替换了方块颜色系统;此加速路径使用物品提交中携带的染色层级。
5.2 专用功能模组
完全排除,等待移植:
- GeckoLib (
features/geckolib) - FTB (
features/ftb) - Modern UI (
features/modernui) - Text rendering (
features/text) - Touhou Little Maid (
features/tlm) - Create (
features/create) - Entity Model Features (
features/emf) - Simple Bedrock Model (
features/simplebedrockmodel)
存在相应的配置项,但在这些模组被移植之前不会生效。
5.3 过滤器
features/filter/** 被排除,但 FilterType 枚举除外(因为配置模型依赖它)。存在过滤器配置项,但过滤逻辑未编译到此构建中。
5.4 模组兼容模块
已排除,等待移植:
- ImmediatelyFast
- TweakerMore
- Tweakeroo
- Xaero's Minimap / World Map
- Roughly Enough Items
- Trinkets
- Sophisticated Backpacks
- Forge Config API Port(兼容模块;库本身仍然需要)
5.5 其他杂项
InventoryScreenMixinParticleEngineMixin- NeoForge 辅助类(
ConfigScreen,IQuadTransformer,UnitTextureAtlasSprite)
5.6 纹理像素下载
TextureUtils.downloadTexture 在此构建中返回 null,因为在 26.1 中读取纹理像素需要一个 GpuDevice 命令编码器。当没有可用纹理时,剔除网格收集器会安全降级。
6. 已知限制
- Alpha 质量。 这是一个正在进行的移植工作;功能覆盖不完整,行为可能会在构建之间发生变化。
- 缺少 GUI 加速。 容器和菜单内的物品和文本渲染未加速。
- 间接绘制需要 mixin 桥接。 由于 26.1 的
RenderPass没有间接入口点,INDIRECT 绘制方法依赖于对命令编码器的 mixin。BASEVERTEX 方法是默认选项。 - 诊断信息当前已启用。 该构建会在游戏日志中打印带有
[AR-FRAME]前缀的每秒诊断计数器以及偶尔出现的[AR-SLOW]行。这些是临时的,将被移除。 - 性能特征未在此记录。 此 Alpha 版本不做任何性能声明。
7. 兼容性说明
- Sodium 和 Iris 在运行时被检测;兼容性 mixin 配置使用带有存在检查的插件,以便仅在安装了目标模组时才应用它们。
- 阴影加速 mixin 使用了更高的优先级,使其在 Sodium 自身的阴影处理之前运行,从而在其守卫条件满足时接管加速管线。
- 针对不存在的模组的 mixin 配置不会被注册,因此缺失的可选依赖不会导致崩溃。
8. 摘要表
| 区域 | 状态 |
|---|---|
| 实体 / 方块实体模型渲染 | 已实现 |
| 物品模型渲染 | 已实现 |
| 实体阴影 | 已实现 |
| 原版绘制顺序保留 | 已实现 |
| Iris / 光影包支持 | 已实现 |
| 朝向剔除 | 已实现 |
| 间接绘制 | 已实现(mixin 桥接) |
| 配置界面 | 已实现 |
| 物品 GUI 渲染 | 未实现 |
| 整体模型烘焙路径 | 未实现 |
| 文本渲染 | 未实现 |
| 过滤器 | 未实现 |
| GeckoLib / FTB / ModernUI / TLM / Create / EMF / SBM | 未实现 |
| 模组兼容模块(见 5.4) | 未实现 |
| 纹理像素下载 | 未实现 |
- GUI 物品渲染 ——
features/items/gui/**与features/items/mixins/gui/**(GUI 批处理、加速 blit / fill / gradient、字符串渲染)。 - 整模型烘焙路径 ——
ItemRendererMixin、ModelBlockRendererMixin、features/items/mixins/models/**、features/items/mixins/accessors/**。 这些依赖 26.1 已移除的类(ItemRenderer、BakedModel、SimpleBakedModel、MultiPartBakedModel、WeightedBakedModel),在 26.1 架构下没有直接对应物。 - 方块/物品着色辅助类 ——
BlockLayerColors、ColorHelper、EmptyBlockColor、ItemLayerColors、IAcceleratedBakedModel。26.1 已用 block tint source 取代旧的 方块着色体系;本加速路径改用物品提交自带的 tint layer。
5.2 独立功能模块
以下模块整体排除,待移植:
- GeckoLib(
features/geckolib) - FTB(
features/ftb) - Modern UI(
features/modernui) - 文本渲染(
features/text) - 车万女仆 TLM(
features/tlm) - Create(
features/create) - Entity Model Features(
features/emf) - Simple Bedrock Model(
features/simplebedrockmodel)
对应的配置项已经存在,但在这些模块移植完成前不会生效。
5.3 过滤器
features/filter/** 除 FilterType 枚举(配置模型依赖它)外整体排除。
过滤器配置项存在,但过滤逻辑未编入本版本。
5.4 模组兼容模块
以下兼容模块排除,待移植:
- ImmediatelyFast
- TweakerMore
- Tweakeroo
- Xaero's Minimap / Xaero's World Map
- REI(Reborn Items)
- Trinkets
- Sophisticated Backpacks
- Forge Config API Port(指其兼容模块;库本身仍然是必需的)
5.5 其它
InventoryScreenMixinParticleEngineMixin- NeoForge 辅助类(
ConfigScreen、IQuadTransformer、UnitTextureAtlasSprite)
5.6 纹理像素下载
本版本中 TextureUtils.downloadTexture 返回 null —— 26.1 读取纹理像素需要
GpuDevice 的 command encoder。在拿不到纹理时,剔除网格收集器会安全降级。
6. 已知限制
- Alpha 质量。 这是进行中的移植版本;功能覆盖不完整,行为可能随版本变化。
- 没有 GUI 加速。 容器与菜单内的物品、文本渲染未加速。
- INDIRECT 绘制依赖 mixin 桥接。 因为 26.1 的
RenderPass没有 indirect 入口, INDIRECT 方式依赖对命令编码器的 mixin。默认方式是 BASEVERTEX。 - 诊断代码当前处于开启状态。 本版本会向游戏日志每秒打印以
[AR-FRAME]为前缀的 诊断计数,并偶尔打印[AR-SLOW]。这些是临时代码,后续会移除。 - 本文档不涉及性能。 本 alpha 版本不对性能作任何声明。
7. 兼容性说明
- 运行时检测 Sodium 与 Iris;兼容用的 mixin 配置带有存在性判定插件,只有目标模组 已安装时才会应用。
- 阴影加速 mixin 使用了更高的 mixin 优先级,以便先于 Sodium 自身的阴影处理执行, 在守卫条件满足时由加速管线接管。
- 指向不存在模组的 mixin 配置不会注册,因此缺少可选依赖不会导致崩溃。
8. 状态总览
| 领域 | 状态 |
|---|---|
| 实体 / 方块实体模型渲染 | 已实现 |
| 物品模型渲染 | 已实现 |
| 实体阴影 | 已实现 |
| 原版绘制顺序还原 | 已实现 |
| Iris / 光影包支持 | 已实现 |
| 朝向剔除 | 已实现 |
| Indirect 绘制 | 已实现(mixin 桥接) |
| 配置界面 | 已实现 |
| 物品 GUI 渲染 | 未实现 |
| 整模型烘焙路径 | 未实现 |
| 文本渲染 | 未实现 |
| 过滤器 | 未实现 |
| GeckoLib / FTB / ModernUI / TLM / Create / EMF / SBM | 未实现 |
| 模组兼容模块(见 5.4) | 未实现 |
| 纹理像素下载 | 未实现 |
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
评论 0
登录后参与评分
还没有评论,来抢沙发吧