渲染

WARNING

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

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

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

HUD 与世界渲染每帧绘制文字、矩形、纹理和世界空间调试线。物品渲染标记从服务端脚本让客户端在世界中显示轻量物品模型。后处理效果注册、启用和清除全屏 shader 效果。提供预设 shader 以快速调用。

如何选择

客户端脚本需要每帧绘制内容时，使用 HUD 与世界渲染。服务端脚本想让客户端看到临时物品模型、但不生成真实实体时，使用 物品渲染标记。需要模糊、染色、灰度或自定义全屏 shader 时，使用 后处理效果。