Shaderboard

模组

· 作者 TheCSDev

一个 Minecraft 模组,通过命名绑定将客户端记分板值暴露给后处理光影。

0 本站下载 0 关注 更新于 1 周前

需要前置:TCDCommons API

最新 2.4.0+fn-26.3 · 26.3 · Fabric / NeoForge

一键开服(送7天)

Shaderboard

Shaderboard 允许原版资源包后处理光影通过 命名绑定(named bindings) 读取客户端记分板数值。

绑定在光影的 JSON 文件(即定义其 Passes 的文件)中声明。该模组会将每个绑定转换为一个真正的 GLSL uniform block 并附带 GPU 缓冲区,并在每一帧用实时的记分板数值重写这些缓冲区。随后,光影可以按需使用这些数值。

注意: 此模组适用于原版的 /posteffect 命令光影。它不针对 Iris 和 Optifine 等模组的光影。


声明绑定

在 后处理 JSON 文件的根层级添加 "shaderboard:bindings" 数组,位于 "targets" 和 "passes" 旁边。以下是一个示例:

{
	"targets": { ... },
	"passes": [ ... ],

	"shaderboard:bindings":
	[
		{
			"uniform_name": "u_SteveScore",
			"type": "shaderboard:scoreboard_objective",
			"objective": "example_1",
			"target": { "type": "player", "name": "Steve" }
		}
	]
}

参数说明:

  • uniform_name - 绑定所创建的 GLSL uniform block 的名称。
  • type - 绑定类型。即绑定暴露的信息类型。

当 type 为 shaderboard:scoreboard_objective:

  • objective - 记分板目标名称。
  • target - 定义要绑定哪个目标的分值。
    • type - 要绑定的目标类型;本地玩家的分值(local_player)、特定玩家的分值(player)、最高分值(top_player),或固定大小的分值数组(array)。
    • name - 当 type 为 player 时,此附加字段定义“哪位玩家”。

注意: 这仅仅是众多可能性中的一个示例;从传递分值数组到传递其他客户端信息等等。请参阅 wiki 以获取更多信息。


在 GLSL 中读取绑定的值

重要: 记分板分值是服务端的数据,默认情况下不会同步给客户端。为解决此问题,请使用以下两种解决方案之一:

  1. /scoreboard objectives setdisplay ... - 使原版游戏通过将目标在屏幕上视觉显示来将目标的数值同步给客户端。
  2. /scoreboard objectives shaderboard:sync ... (v2.4.0+) - 此模组在后端同步目标数值给客户端的方法,无需使用 setdisplay。需要在服务端安装此模组。

每个绑定的 uniform_name 都会成为一个 layout(std140) uniform block。其内容由绑定的 值类型 定义。标量记分板目标会产生单个 int:

layout(std140) uniform u_TopScore { int topScore; };
layout(std140) uniform u_SortedScoresAZ { int sortedScores[16]; };

void main()
{
	//基础输出颜色
	fragColor = texture(InSampler, texCoord);

	//...在此处随意使用 'topScore' 和 'sortedScores'...
}

快速演示

此模组包含一个 ID 为 shaderboard:example_1 的示例 /posteffect。您可以按顺序使用以下命令进行尝试:

/posteffect add @p shaderboard:example_1

/scoreboard objectives add example_1 dummy "Example 1"
/scoreboard objectives setdisplay sidebar example_1

/scoreboard players set @p example_1 123
/scoreboard players set Steve example_1 456

此示例光影从 example_1 目标读取记分板数值,并以二进制条纹的形式渲染在屏幕上。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源