Dimension Viewer

Средство просмотра измерений

Настраиваемый серверный мод Minecraft для просмотра того, в каком измерении в данный момент находятся игроки, из списка вкладок.

Теперь поддерживается Fabric, Forge и NeoForge!

Версия Fabric требует Fabric API (CurseForge или Modrinth)

Совместимость

Средство просмотра измерений должно быть совместимо со всеми измерениями. В некоторых случаях имя мода, отображаемое при наведении, имеет неправильный формат из-за использования модида для определения того, из какого мода взято измерение.

Моды, которые вносят изменения в формат имени списка вкладок (или даже обычное отображаемое имя), скорее всего, вызовут проблемы с этим модом, но на данный момент я не могу придумать, с чем можно было бы протестировать. Если вы обнаружите какие-либо проблемы, пожалуйста, оставьте проблему! Спасибо!

Особенности

Модифицированные размеры теперь можно раскрашивать независимо.

Новое в версии 1.4.0

Имена измерений теперь можно связать с чем-то другим, что позволяет вам изменять имя, отображаемое для каждого измерения.

Новое в версии 2.1.0

Настройте мод, не трогая конфиг-файл слэш-командами!

Конфигурация

Изменяя файл конфигурации, вы можете изменить цвет* текста для каждого измерения, разрешить отображение измерения в сообщениях чата и изменить общий формат измерения с возможностью использовать форматирование текста Minecraft, такое как подчеркивание, жирный шрифт и курсив.

Файл конфигурации находится по адресу [Server Folder]/config/dimensionviewer-common.toml для (Neo)Forge или [Server Folder]/config/dimensionviewer.json для Fabric.

Любые внесенные изменения будут применены сразу после сохранения файла конфигурации. Ниже приведен пример конфигурации:

Примеры конфигураций и настроек

Настройки и что они делают

---

• 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 - логическое значение

• Used to enable individual dimension colouring. Disabling this will display all dimensions the same colour as defined in DEFAULT_COLOR

• dimInChatName - Boolean

  • Used to toggle showing the dimension in a players name when sending chat messages
  • When turned off, the players chat name will be unaffected and only the tab list name will show the players current dimension

• enableAliases - Boolean

  • Used to toggle whether custom dimension names should be used.
  • When enabled, any dimensions that match items in DIM_ALIASES will have their display names swapped for the aliased name.

• moddedDimensions - Array of Strings

  • Used to change the colors of custom modded dimensions
  • Uses the format modid:dim_id color
  • For example, Twilight Forest in Gold would be twilightforest:twilight_forest GOLD

• dimensionAliases - Array of Strings

  • Used to show a custom name for a given dimension
  • Uses the format modid:dim_id New Name (Spaces allowed)
  • For example, to replace Overworld with The Grasslands you would use minecraft:overworld The Grasslands
  • Has no effect if ENABLE_ALIASES is false
  • [VERSION 2.0.0+] Allows the use of tokens in the alias (see listFormat)
    • Make only the overworld text bold with minecraft:overworld %b%d

• customColors [VERSION 2.0.0+] - Array of Strings

  • Used to define custom font colors in either HEX format or RGB format.

• Uses the format COLOR_NAME #HEX for hexadecimal colours or COLOR_NAME r000 g000 b000 for RGB colors.

  • The name of the color must be UPPERCASE
  • Hexadecimal numbers must be 6 characters long. Truncated hex values and hex w/ alpha values are not supported at this moment.
  • For example, a custom pink hex color would be HOT_PINK #C62F75
  • Another example, a custom purple RGB color would be FUTURE_PURPLE r152 g154 b255

(Neo)Forge Example

The (Neo)Forge configuration file contains comments for every setting and the valid options available for the setting.

#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<%d>"
#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 Configuration

The Fabric configuration is stored and laid out differently to the (Neo)Forge configuration file due to having to write the saving and loading functions manually. Everything is the same in terms of settings, but there are no comments, unfortunately. This is something that I will try to change in the future.

{
  "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

• Добавлены косые команды!
• Большинство (если не все) настроек теперь можно изменить, не заходя в файл конфигурации, с помощью слэш-команд!
• Исправлена проблема с некоторыми модами

Версия 2.0.0

• Теперь поддерживает Fabric!
• Теперь поддерживает пользовательские цвета шрифтов RGB и Hex!
• Упрощена конфигурация формата
• Псевдонимы измерений теперь поддерживают токены, позволяя выделять определенные измерения жирным шрифтом, курсивом или и тем, и другим!

Версия 1.4.0

• Добавлена поддержка псевдонимов измерений! (Названия пользовательских размеров)

Версия 1.3.1

• Исправлена ошибка регулярного выражения, из-за которой модификаторы с подчеркиванием недействительны.

Версия 1.3.0

• Добавлена поддержка раскраски отдельных размеров мода!
• Changed command 'refreshPlayerList' to 'refreshplayerlist' to fit better with vanilla command styling.

Version 1.2.0

• Initial release!
(I can't remember why I started at 1.2.0...)