Dimension Viewer

一个高度可自定义的服务端 Minecraft 模组，用于从玩家列表查看玩家当前所在的世界。

现已支持 Fabric、Forge 和 NeoForge！

Fabric 版本需要 Fabric API（CurseForge 或 Modrinth）

兼容性

Dimension Viewer 应当兼容所有世界。在某些情况下，由于使用 modid 来判断世界来自哪个模组，悬停时显示的模组名称可能格式不正确。

修改玩家列表名称格式（甚至常规显示名称）的模组很可能会与本模组产生冲突，但目前我一时想不出可以用哪些模组来测试。如果你发现任何问题，请提交问题！谢谢！

功能

模组添加的世界现在可以单独设置颜色。

1.4.0 版本新增

现在可以为世界名称设置别名，让你能够按世界修改显示的名称。

2.1.0 版本新增

无需修改配置文件，使用斜杠命令即可配置本模组！

配置

通过修改配置文件，你可以按世界更改文本的颜色*，允许在聊天消息中显示世界，并更改世界的整体格式，支持使用 Minecraft 文本格式，如下划线、粗体和斜体字体。

配置文件位于 (Neo)Forge 的 [Server Folder]/config/dimensionviewer-common.toml 或 Fabric 的 [Server Folder]/config/dimensionviewer.json。

所做的任何更改都会在配置文件保存后立即生效。
示例配置见下方：

示例配置与设置

设置及其作用

listFormat – 字符串
用于在玩家列表或聊天名称中显示世界的格式。它支持一些用于调整布局的标记。
%d – 世界（必需）
%i – 斜体
%b – 粗体
%u – 下划线
%s – 删除线
%o – 混淆文本
%% – 字面量 %
% 后的任何字符都会被解释为标记并被移除，因此如果你想在名称中显示百分号，请使用 %%
dimensionPosition – 字符串
设置世界相对于玩家名称显示的位置。
PREPEND – 在玩家名称之前
APPEND – 在玩家名称之后
defaultColor – 字符串
设置当 PER_DIM_COLOR 为 false，或为未在 MODDED_DIMS 中定义的自定义世界时使用的默认字体颜色
接受所有原版文本颜色：DARK_RED、RED、GOLD、YELLOW、DARK_GREEN、GREEN、AQUA、DARK_AQUA、DARK_BLUE、BLUE、LIGHT_PURPLE、DARK_PURPLE、WHITE、GRAY、DARK_GRAY、BLACK
也接受在 CUSTOM_COLORS 中定义的任意自定义颜色名称
名称必须为大写
overworldColor、netherColor 和 endColor – 字符串
当 perDimColor 设为 true 时，用于更改原版维度的颜色
接受与 defaultColor 相同的输入
perDimColor – 布尔值
用于启用各维度独立着色。禁用后，所有维度都会显示为 DEFAULT_COLOR 中定义的相同颜色
dimInChatName – 布尔值
用于切换是否在玩家发送聊天消息时，于其名称中显示所在维度
关闭后，玩家的聊天名称不受影响，只有玩家列表中的名称会显示玩家当前所在的维度
enableAliases – 布尔值
用于切换是否使用自定义维度名称。
启用后，任何与 DIM_ALIASES 中条目匹配的维度，都会将显示名称替换为对应的别名。
moddedDimensions – 字符串数组
用于更改模组自定义维度的颜色
格式为 modid:dim_id color
例如，将暮色森林设为金色可写作 twilightforest:twilight_forest GOLD
dimensionAliases – 字符串数组
用于为指定维度设置自定义名称
格式为 modid:dim_id New Name（允许包含空格）
例如，若要将 Overworld 替换为 The Grasslands，可使用 minecraft:overworld The Grasslands
如果 ENABLE_ALIASES 为 false，则不会生效
[VERSION 2.0.0+] 别名中允许使用标记（参见 listFormat）
使用 minecraft:overworld %b%d 可仅将主世界文本加粗
customColors [VERSION 2.0.0+] – 字符串数组
用于以 HEX 或 RGB 格式定义自定义字体颜色。
十六进制颜色格式为 COLOR_NAME #HEX，RGB 颜色格式为 COLOR_NAME r000 g000 b000。
颜色名称必须为大写
十六进制数必须为 6 个字符。目前不支持截断的十六进制值，也不支持带 Alpha 值的十六进制值。
例如，自定义粉色十六进制颜色可写作 HOT_PINK #C62F75
另一个例子，自定义紫色 RGB 颜色可写作 FUTURE_PURPLE r152 g154 b255

(Neo)Forge 示例

(Neo)Forge 配置文件为每项设置都附有注释，并列出了该设置可用的选项。

#自定义设置
[customization]
#当 perDimColorPath 为 false 时，用于维度字体的颜色。
#（如果进入的是模组维度，此颜色将作为回退使用）
fontColor = "DARK_AQUA"
#维度别名的全局开关。需要在下方设置别名。
enableAliases = true
#使用占位符在标签列表中显示维度时使用的格式：
#    %d - 维度名称
#    %i - 斜体
#    %b - 粗体
#    %u - 下划线
#    %o - 混淆字体
#    %s - 删除线
listFormat = "%i<%d>"
#维度应放置在玩家名称之前还是之后
#允许的值：PREPEND、APPEND
dimensionPosition = "APPEND"
#每个维度是否应有自己的颜色？
perDimColor = true

#按维度自定义
[customization.dimension]
    #用于主世界的颜色
    #允许的值：DARK_RED、RED、GOLD、YELLOW、DARK_GREEN、GREEN、AQUA、DARK_AQUA、DARK_BLUE、BLUE、LIGHT_PURPLE、DARK_PURPLE、WHITE、GRAY、DARK_GRAY、BLACK
    overworldColor = "DARK_GREEN"
    #用于下界的颜色
    #允许的值：DARK_RED、RED、GOLD、YELLOW、DARK_GREEN、GREEN、AQUA、DARK_AQUA、DARK_BLUE、BLUE、LIGHT_PURPLE、DARK_PURPLE、WHITE、GRAY、DARK_GRAY、BLACK
    netherColor = "DARK_RED"
    #用于末地的颜色
    #允许的值：DARK_RED、RED、GOLD、YELLOW、DARK_GREEN、GREEN、AQUA、DARK_AQUA、DARK_BLUE、BLUE、LIGHT_PURPLE、DARK_PURPLE、WHITE、GRAY、DARK_GRAY、BLACK
    endColor = "FUTURE_PURPLE"

#聊天相关自定义
[customization.chat]
    #是否将用户当前维度添加到聊天消息中？
    dimInChatName = true
    #在聊天中添加悬停效果，显示是哪个模组添加了该维度
    #需要将 'dimInChatName' 设置为 true
    chatDimHover = true

#模组维度自定义
[customization.modded]
    #用于替代原始维度 ID 的别名列表。
    #使用格式 'modid:dim_id 新名称'。
    #例如，要将 'Overworld' 替换为 'Grasslands'，应使用 'minecraft:overworld Grasslands'
    dimensionAliases = ["minecraft:the_end ULTIMA THULE"]
    #模组维度资源 ID 和颜色的列表，格式为 "modid:dim_id color"
    #例如，金色的暮色森林应为 "twilightforest:twilight_forest GOLD"
    #如果颜色无效将抛出异常
    #允许的值：DARK_RED、RED、GOLD、YELLOW、DARK_GREEN、GREEN、AQUA、DARK_AQUA、DARK_BLUE、BLUE、LIGHT_PURPLE、DARK_PURPLE、WHITE、GRAY、DARK_GRAY、BLACK
    moddedDimensionIds = ["twilightforest:twilight_forest GOLD"]

#额外自定义
[customization.extra]
    #可在此处定义自定义颜色。
    #使用格式 'COLOR_NAME #HEX' 或 'COLOR_NAME r000 g000 b000'
    #如果同名的自定义颜色已存在，服务器将拒绝最新的一个。
    #名称必须为大写，且只能包含字母和下划线。
    custom_colors = ["HOT_PINK #C62F75", "FUTURE_PURPLE r152 g154 b255"]

Fabric 配置

由于必须手动编写保存和加载函数，Fabric 配置的存储和布局与 (Neo)Forge 配置文件不同。所有设置项都相同，但遗憾的是没有注释。
这是我将来会尝试改变的事情。

{
  "listFormat": "%i<%d>",
  "dimensionPosition": "APPEND",
  "defaultColor": "HOT_PINK",
  "overworldColor": "DARK_GREEN",
  "netherColor": "FUTURE_PURPLE",
  "endColor": "HOT_PINK",
  "perDimColor": true,
  "dimInChatName": true,
  "chatDimHover": true,
  "enableAliases": true,
  "moddedDimensions": ["twilightforest:twilight_forest GOLD"],
  "dimensionAliases": ["minecraft:overworld %bThe Grasslands", "minecraft:the_nether %u%d", "minecraft:the_end %oEnd"],
  "customColors": ["HOT_PINK #C62F75", "FUTURE_PURPLE r152 g154 b255"]
}

更新日志

查看更新日志

版本 2.1.0

新增斜杠命令！
现在大多数（甚至可能是全部）设置都可以通过斜杠命令修改，无需打开配置文件！
修复了某些模组 ID 的问题

版本 2.0.0

现已支持 Fabric！
现已支持自定义 RGB 和十六进制字体颜色！
简化了格式配置
维度别名现在支持标记，可将特定维度名称设为粗体、斜体或两者兼有！

版本 1.4.0

新增维度别名支持！（自定义维度名称）

版本 1.3.1

修复了一个正则表达式错误，该错误会导致带下划线的模组 ID 无效。

版本 1.3.0

新增单独设置模组维度颜色的功能！
将命令 ‘refreshPlayerList’ 改为 ‘refreshplayerlist’，使其更符合原版命令的格式。

版本 1.2.0

首次发布！

（我不记得为什么从 1.2.0 开始了……）

Dimension Viewer

截图

介绍

Dimension Viewer

兼容性

功能

配置

设置及其作用

更新日志

常见问题

Dimension Viewer 支持哪些 Minecraft 版本？

Dimension Viewer 怎么安装？

评论