舒尔克先生

舒尔克先生

允许将物品附加到潜影盒盖子上显示,以便更好地管理物品栏。

概述

MrShulker 最初是对(据推测已废弃的)Shulker+ 模组的重新实现。

该模组允许玩家使用铁砧消耗 1 点经验将物品附加到潜影盒上。附加的物品随后会显示在潜影盒的盖子上。

MrShulker 与 Shulker+ 向后兼容。如果你要从曾安装过 Shulker+ 的世界迁移,则需要在迁移时安装 MrShulker,数据才能保留下来。

特性

  • MrShulker 的主要功能是将物品附加到潜影盒上用于展示。
  • 1.3.0 版本在 tnoctua 的帮助下引入了通过蹲下使用来给潜影盒染色的功能。
  • MrShulker Flat GUI View Companion 资源包提供了俯视 GUI 视图。
  • 1.4.0 版本引入了客户端配置选项,可设置在不同显示场景中使用的盖子物品缩放比例。
  • 1.4.0 版本引入了服务端配置选项,可启用或禁用特定的模组功能。
  • 1.4.0 版本引入了为单个潜影盒设置盖子物品缩放比例的功能。
  • 1.4.0 版本引入了管理这些设置的命令。

需求与依赖

MrShulker 需要在服务端安装才能发挥作用。 并不要求所有玩家都在客户端安装 MrShulker,但只有安装了才能在客户端显示盖子物品。

自 1.4.0 起,MrShulker 需要 Fabric-Api。

命令

命令根据其影响范围(是否影响整个服务器,还是仅影响单个玩家的个人偏好)分为两大组。

mrshulker

mrshulker 是所有服务端命令的根命令。每个子命令都有三种操作模式:set(设置)、query(查询)和 reset(重置)。

allow_dyeing

控制玩家是否可以通过蹲下使用来给潜影盒染色。

mrshulker [set|query|reset] allow_dyeing [true|false]

allow_per_shulker_scaling

控制玩家是否可以为单个潜影盒设置缩放比例。

mrshulker [set|query|reset] allow_per_shulker_scaling [true|false]

custom_scale

设置、显示或重置玩家主手中潜影盒所使用的自定义缩放比例。

mrshulker [set|query|reset] custom_scale #.#

mrshulker_display

mrshulker_display 是客户端命令的根命令。同样,每个命令都有三种操作模式:set、query 和 reset。

scale

scale 子命令管理在不同显示场景中使用的整体缩放比例。大多数支持的 display_context 与官方 ItemDisplayContext 类型一致:

  • firstperson_lefthand
  • firstperson_righthand
  • fixed:当潜影盒展示在物品展示框中时使用。
  • ground:当潜影盒作为掉落物展示时使用。
  • gui:当潜影盒在 GUI 中任意位置展示时使用:物品栏、快捷栏等。
  • head:当潜影盒展示在盔甲架的头部时使用。
  • none:我不知道这个用在什么地方。
  • thirdperson_lefthand
  • thirdperson_righthand

列表中新增了两个特殊的 display_context:

  • block:当潜影盒放置在世界中时使用。
  • default:当当前显示场景没有配置特定设置时使用。

初始状态下已为 default 和 gui 场景配置了设置。

在 set 模式下,display_context 和 scale 是必填参数。

mrshulker_display set scale [display_context] #.#

在 query 和 reset 模式下,display_context 参数是可选的。如果指定,命令将显示或重置该 display_context;如果省略,则对所有已配置的 display_context 执行操作。

mrshulker_display query scale [display_context]
mrshulker_display query scale

reset 会移除指定 display_context 的缩放比例,如果该场景是 default 或 gui,则恢复其原始值。

mrshulker_display reset scale [display_context]
mrshulker_display reset scale

show_custom_scales

show_custom_scales 设置控制是否显示单个潜影盒的缩放比例,还是始终使用 display_context 的缩放比例。

mrshulker_display [set|query|reset] show_custom_scales [true|false]

盖子物品缩放

在存在多个可用选项的情况下,MrShulker 按以下方式确定使用哪个缩放比例:

  • 单个潜影盒的 custom_scale
    • 如果潜影盒设置了 custom_scale,且 allow_per_shulker_scales 和 show_custom_scales 均为 true,则使用该 custom_scale。
  • 当前 ItemDisplayContext 的 display_context 缩放比例
    • 如果当前 ItemDisplayContext 配置了缩放比例,则使用它。
  • 'default' display_context 所设置的值
    • 如果上述两项均未选中,则使用始终存在的 'default' 值作为回退。