Dimension Viewer - Dimension Viewer 维度查看器

Dimension Viewer

一个高度可自定义的服务端 Minecraft 模组，可在玩家列表中查看玩家当前所处的维度。

> 现在支持 Fabric、Forge 和 NeoForge！

>

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

兼容性

Dimension Viewer 应该兼容所有维度。但在某些情况下，悬停时显示的模组名称可能格式不正确，因为该模组使用 modid 来判断某个维度来自哪个模组。

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

功能特性

现在可以为模组添加的维度单独设置颜色。

1.4.0 版本新增

现在可以为维度名称设置别名，从而修改每个维度显示的名称。

2.1.0 版本新增

无需修改配置文件，也可以通过斜杠命令配置模组！

配置

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

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

所做的任何更改都会在保存配置文件后立即生效。

下面是一个配置示例：

配置示例与设置说明

设置项及其作用

• listFormat - 字符串
• 用于在玩家列表或聊天名称中显示维度的格式。它支持一些 token 来调整布局。
• %d - 维度（必需）
• %i - 斜体
• %b - 粗体
• %u - 下划线
• %s - 删除线
• %o - 混淆文本
• %% - 字面量 %
• % 后面的任意字符都会被解释为 token 并移除，所以如果你想在名称中使用百分号，请使用 %%
• dimensionPosition - 字符串
• 设置维度显示在玩家名称的哪个位置。
• PREPEND - 位于玩家名称之前
• APPEND - 位于玩家名称之后
• defaultColor - 字符串
• 当 PERDIMCOLOR 为 false，或某个未在 MODDED_DIMS 中定义的自定义维度出现时，设置要使用的默认字体颜色
• 接受任意原版文本颜色：DARKRED, RED, GOLD, YELLOW, DARKGREEN, GREEN, AQUA, DARKAQUA, DARKBLUE, BLUE, LIGHTPURPLE, DARKPURPLE, 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
• 例如，金色的 Twilight Forest 可写作 twilightforest:twilight_forest GOLD
• dimensionAliases - 字符串数组
• 用于为指定维度显示自定义名称
• 使用格式 modid:dim_id New Name（允许空格）
• 例如，要将 Overworld 替换为 The Grasslands，可使用 minecraft:overworld The Grasslands
• 如果 ENABLE_ALIASES 为 false，则不会生效
• [VERSION 2.0.0+] 允许在别名中使用 token（见 listFormat）
• 例如让主世界文本仅显示为粗体：minecraft:overworld %b%d
• customColors [VERSION 2.0.0+] - 字符串数组
• 用于以 HEX 或 RGB 格式定义自定义字体颜色。
• 使用格式 COLORNAME #HEX 表示十六进制颜色，或 COLORNAME r000 g000 b000 表示 RGB 颜色。
• 颜色名称必须为全大写
• 十六进制数必须为 6 位长度。目前不支持截断形式的十六进制值，也不支持带 alpha 的十六进制值。
• 例如，一个自定义粉色十六进制颜色可以写作 HOT_PINK #C62F75
• 另一个例子，一个自定义紫色 RGB 颜色可以写作 FUTURE_PURPLE r152 g154 b255

(Neo)Forge 示例

(Neo)Forge 配置文件中为每个设置项以及该设置项可用的有效选项都附带了注释。

#Customization Settings
[customization]
#The color to use for the dimension font if perDimColorPath is false.
#(In the event of a modded dimension being entered, this color will be used as a fallback)
fontColor = "DARK_AQUA"
#Global toggle for dimension aliases. Requires aliases to be set below.
enableAliases = true
#Format that will be used to display the dimension in the tab list with the use of tokens:
#    %d - Dimension Name
#    %i - Italic font
#    %b - Bold font
#    %u - Underline font
#    %o - Obfuscated font
#    %s - Strikethrough font
listFormat = "%i"
#Whether the dimension should be placed before or after the player name
#Allowed Values: PREPEND, APPEND
dimensionPosition = "APPEND"
#Should each dimension have its own color?
perDimColor = true

#Per-Dimension Customization
[customization.dimension]
    #Color to use for the Overworld
    #Allowed Values: 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"
    #Color to use for the Nether
    #Allowed Values: 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"
    #Color to use for the End
    #Allowed Values: 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"

#Chat-related Customization
[customization.chat]
    #Should a users' current dimension be added to chat messages?
    dimInChatName = true
    #Add a hover effect in chat that will display which mod added the dimension
    #Requires 'dimInChatName' to be set to true
    chatDimHover = true

#Modded Dimension Customization
[customization.modded]
    #A list of aliases to use instead of the original dimension ID.
    #Uses the format 'modid:dim_id New Name'.
    #For example, to replace 'Overworld' with 'Grasslands' you would use 'minecraft:overworld Grasslands'
    dimensionAliases = ["minecraft:the_end ULTIMA THULE"]
    #A list of modded dimension resource IDs and a color in the format of "modid:dim_id color"
    #For example, Twilight Forest in Gold would be "twilightforest:twilight_forest GOLD"
    #Will throw an exception if the color is not valid
    #Allowed Values: 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"]

#Extra Customization
[customization.extra]
    #Custom colors can be defined here.
    #Uses the format 'COLOR_NAME #HEX' or 'COLOR_NAME r000 g000 b000'
    #If a custom color of the same name already exists the server will reject the newest one.
    #The name must be uppercase and can only contain letters and underscores.
    custom_colors = ["HOT_PINK #C62F75", "FUTURE_PURPLE r152 g154 b255"]

Fabric 配置

由于 Fabric 配置文件的保存与加载功能需要手动编写，因此其存储和布局方式与 (Neo)Forge 配置文件不同。设置项本身完全相同，只是遗憾的是没有注释。

这是我未来会尝试改进的地方。

{
  "listFormat": "%i",
  "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"]
}

更新日志

查看更新日志

Version 2.1.0

• 添加了斜杠命令！

• 大多数（如果不是全部）设置现在都可以通过斜杠命令更改，无需进入配置文件！

• 修复了某些 modid 的问题

Version 2.0.0

• 现在支持 Fabric！

• 现在支持自定义 RGB 和 Hex 字体颜色！

• 简化了格式配置

• 维度别名现在支持 token，可让特定维度显示为粗体、斜体，或两者同时使用！

Version 1.4.0

• 添加了对维度别名的支持！（自定义维度名称）

Version 1.3.1

• 修复了一个正则表达式 bug，该问题会导致带下划线的 modid 无效。

Version 1.3.0

• 添加了对单独为模组维度着色的支持！

• 将命令 refreshPlayerList 更改为 refreshplayerlist，以更贴近原版命令风格。

Version 1.2.0

• 初始发布！

（我也不记得为什么我是从 1.2.0 开始的……）