渲染

WARNING

渲染功能仅适用于 Fabric/NeoForge 客户端。Paper 是纯服务端平台，不支持客户端渲染。

Katton 的客户端渲染 API 覆盖逐帧回调、HUD 绘制、世界空间辅助绘制、镜头演出、服务端驱动的物品渲染标记，以及全屏后处理效果。

实体渲染器属于自定义实体注册流程，不放在本章节展开。模型层、动画实体渲染器和关键帧回调见 注册 / 实体教程 与 EntityRenderer API。

HUD 与世界渲染每帧绘制文字、矩形、纹理和世界空间调试线。物品渲染标记从服务端脚本让客户端在世界中显示轻量物品模型。后处理效果注册、启用和清除全屏 shader 效果。提供预设 shader 以快速调用。镜头演出与世界特效编排镜头路径、粒子、几何效果和服务端触发的时间线。

如何选择

客户端脚本需要每帧绘制内容时，使用 HUD 与世界渲染。需要镜头控制、粒子、几何和时间线时，使用镜头演出与世界特效。服务端脚本需要显示临时物品模型时，使用物品渲染标记。需要模糊、染色、灰度或自定义全屏 shader 时，使用后处理效果。