武器物品自定义器

武器物品自定义器

我是ArmDev的开发者和所有者。我创建模组来改善游戏体验，并帮助玩家将他们的想法变为现实。

杂项

English

ArmItemCustomizer

ArmItemCustomizer 是由 ArmDev 开发的客户端 Minecraft Fabric 模组，允许玩家直接在客户端自定义单个物品的视觉大小。

该模组包含内置的配置文件系统，支持原版 Minecraft 物品和自定义服务器物品、可配置的按键绑定，以及按物品单独设置缩放比例。

ArmItemCustomizer 在使用自定义武器、护符、图腾、球体、玩家头颅、神器、自定义模型以及包含修改过的 NBT 或 Data Components 的物品的服务器上尤为实用。

无需服务器端插件。

主要功能

配置文件

ArmItemCustomizer 允许你创建多个独立的配置文件。

例如：

  • HolyWorld
  • FunTime
  • ReallyWorld
  • Vanilla
  • 任何其他服务器或游戏模式

每个配置文件都可以包含自己跟踪的物品和单独的缩放设置。

只使用当前选中的配置文件，这使得将不同服务器的设置分开保存变得十分方便。

单个物品缩放

每个被跟踪的物品都可以拥有自己独立的缩放比例。

例如：

  • 下界合金剑 — x2
  • 自定义护符 — x5
  • 自定义球体 — x7.5
  • 图腾 — x3
  • 镐 — x1.5

更改一个物品的大小不会影响其他被跟踪的物品。

缩放值可以通过以下方式更改：

  • + 和 − 按钮；
  • 按住 + 或 − 进行连续调整；
  • 点击缩放字段并手动输入精确值。

支持小数值，例如：

1.25、2.5、3.75、7.5。

添加物品

可以通过多种方式将物品添加到当前活动的配置文件中。

从 GUI 添加

你可以添加：

  • 当前手持的物品；
  • 背包中的物品；
  • 直接将单个物品添加到所选配置文件中。

使用按键绑定

ArmItemCustomizer 在 Minecraft 控制设置中添加了自己的按键分类：

ArmItemCustomizer

你可以为 添加物品 操作分配一个按键。

然后只需：

  1. 打开背包、箱子或其他容器界面；
  2. 将鼠标悬停在你想要跟踪的物品上；
  3. 按下分配的按键。

该物品将立即被添加到当前活动的配置文件中。

模组还会显示聊天通知，例如：

ArmItemCustomizer > Item added: Fire Talisman

标准 Minecraft 物品

原版 Minecraft 物品可以通过其物品 ID 进行跟踪。

示例：

  • minecraft:netherite_sword
  • minecraft:diamond_pickaxe
  • minecraft:totem_of_undying

这意味着即使次要属性发生变化，普通物品仍然可以被识别，例如：

  • 耐久度；
  • 附魔；
  • 堆叠数量；
  • 其他非必要属性。

自定义服务器物品支持

ArmItemCustomizer 也旨在识别使用以下内容的服务器自定义物品：

  • NBT；
  • Data Components；
  • Custom Data；
  • Custom Model Data；
  • Item Model；
  • Player Profile / 自定义头颅纹理；
  • 自定义名称；
  • lore；
  • 其他服务器定义的组件。

这使得区分多个技术上使用相同原版基础物品的自定义物品成为可能。

例如，多个不同的自定义球体可能都基于 minecraft:player_head，但在 ArmItemCustomizer 中仍被视为不同的物品。

这对于以下内容非常有用：

  • 自定义球体；
  • 护符；
  • 自定义图腾；
  • 自定义头颅；
  • 神器；
  • 自定义武器；
  • 带有自定义模型的服务器特定物品。

简洁的物品名称

GUI 显示可读的物品名称，而不是原始技术信息。

不再显示类似：

translation{key='item.minecraft.netherite_sword'}

或冗长的 NBT/组件字符串，ArmItemCustomizer 显示：

Netherite Sword

对于自定义物品，可以显示服务器提供的自定义名称，例如：

Fire Talisman

如果无法解析出合适的显示名称，模组可以回退到物品的 Minecraft ID。

内置 GUI

ArmItemCustomizer 界面可以通过可配置的按键绑定打开。

默认按键：

右 Shift

GUI 包含：

  • 配置文件列表；
  • 活动配置文件选择；
  • 创建配置文件；
  • 删除配置文件；
  • 删除确认；
  • 已跟踪物品列表；
  • 单个物品移除；
  • 单个物品缩放控制；
  • 精确缩放输入；
  • 物品添加工具。

整个系统设计为通过 GUI 进行控制，无需手动编辑配置文件。

按键绑定

ArmItemCustomizer 创建了自己的控制分类，而不是将其按键绑定放在 Minecraft 通用的 Miscellaneous 分类中。

主要按键绑定包括：

  • 打开 ArmItemCustomizer
  • 添加物品

两者都可以通过 Minecraft 的标准控制设置重新分配。

自动保存

你的设置会自动保存。

模组存储：

  • 已创建的配置文件；
  • 当前活动的配置文件；
  • 已跟踪的物品；
  • 单个物品缩放；
  • 模组设置。

重启 Minecraft 后你的配置仍然可用。

安全的自定义数据处理

某些服务器或反作弊系统可能会隐藏、修改或限制发送到客户端的物品信息。

ArmItemCustomizer 旨在安全地处理不完整的物品数据。

如果特定信息不可用，模组会尝试使用其他稳定的物品属性，而不是使游戏崩溃。

这个模组适合谁？

ArmItemCustomizer 对以下玩家很有用：

  • 在无政府服务器上游玩；
  • 使用拥有大量自定义物品的服务器；
  • 希望特定物品更容易被注意到；
  • 希望更大的自定义球体、护符或武器；
  • 希望为不同服务器使用单独的配置；
  • 更喜欢使用 GUI 而不是手动编辑配置文件。

支持的版本

Fabric 版本适用于：

  • Minecraft 1.16.5
  • Minecraft 1.17.1
  • Minecraft 1.20.1
  • Minecraft 1.20.4
  • Minecraft 1.21.4
  • Minecraft 1.21.11

开发者： ArmDev 平台： Fabric 类型： 客户端模组

Русский

ArmItemCustomizer

ArmItemCustomizer — клиентский мод для Minecraft Fabric от ArmDev, предназначенный для индивидуальной настройки отображения предметов прямо на клиенте. Мод позволяет создавать отдельные профили, добавлять в них обычные и кастомные серверные предметы и задавать каждому предмету собственный масштаб.

ArmItemCustomizer особенно полезен для серверов с большим количеством уникальных предметов: кастомных мечей, талисманов, тотемов, сфер, голов, артефактов и других предметов с изменёнными NBT/Data Components. Мод работает полностью на стороне клиента и не требует установки плагина на сервер.

Основные возможности

Профили

В моде можно создавать несколько независимых профилей. Например:

  • HolyWorld
  • FunTime
  • ReallyWorld
  • Vanilla
  • любой другой сервер или режим

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

Это позволяет не смешивать настройки разных серверов между собой.

Индивидуальный масштаб каждого предмета

Главная функция ArmItemCustomizer — возможность изменять размер каждого добавленного предмета отдельно.

Например:

  • Незеритовый меч — x2
  • Кастомный талисман — x5
  • Сфера — x7.5
  • Тотем — x3
  • Кирка — x1.5

Размер одного предмета никак не влияет на остальные.

Масштаб можно менять несколькими способами:

  • кнопками + и −;
  • удержанием + или − для быстрого изменения;
  • нажатием на поле масштаба и ручным вводом точного значения.

Поддерживаются дробные значения, например:

1.25, 2.5, 3.75, 7.5.

Добавление предметов

Добавить предмет в активный профиль можно несколькими способами.

Через GUI

Можно добавить:

  • предмет из руки;
  • предметы из инвентаря;
  • отдельный предмет в выбранный профиль.

Через бинд

В настройках управления Minecraft присутствует отдельная категория:

ArmItemCustomizer

В ней можно назначить клавишу «Добавить предмет».

После этого достаточно:

  1. открыть инвентарь, сундук или серверное меню;
  2. навести курсор на нужный предмет;
  3. нажать назначенную клавишу.

Предмет автоматически будет добавлен в профиль, который сейчас выбран как активный.

После успешного добавления мод выводит сообщение в чат, например:

ArmItemCustomizer > Предмет добавлен: Огненный талисман

Работа с обычными предметами

Для стандартных предметов Minecraft мод может использовать их обычный ID.

Например:

  • minecraft:netherite_sword
  • minecraft:diamond_pickaxe
  • minecraft:totem_of_undying

Благодаря этому обычный меч продолжит определяться как тот же самый предмет даже после изменения:

  • прочности;
  • зачарований;
  • количества;
  • других второстепенных характеристик.

Поддержка кастомных серверных предметов

ArmItemCustomizer также предназначен для работы с предметами, которые сервер изменяет через:

  • NBT;
  • Data Components;
  • Custom Data;
  • Custom Model Data;
  • Item Model;
  • Player Profile / текстуры голов;
  • custom name;
  • lore;
  • другие серверные данные.

Это позволяет различать, например, несколько разных сфер, которые технически являются обычными player_head.

Мод старается использовать наиболее стабильные признаки предмета, чтобы разные кастомные предметы не определялись как один и тот же объект.

Это особенно важно для:

  • сфер;
  • талисманов;
  • кастомных тотемов;
  • голов;
  • артефактов;
  • серверного оружия;
  • уникальных предметов с собственными моделями.

Нормальные названия предметов

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

Например вместо:

translation{key='item.minecraft.netherite_sword'}

или длинного NBT-тега мод показывает:

Незеритовый меч

Для кастомных предметов используется их серверное название, например:

Огненный талисман

Если обычное название получить невозможно, мод может использовать ID предмета.

GUI

Интерфейс ArmItemCustomizer открывается отдельной назначаемой клавишей.

По умолчанию:

Right Shift

В интерфейсе доступны:

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

Интерфейс рассчитан на быстрое управление без необходимости редактировать конфиги вручную.

Управление

ArmItemCustomizer добавляет собственную категорию в настройках клавиш Minecraft.

Она не находится внутри стандартного раздела Разное / Misc.

Основные бинды:

  • Открыть интерфейс ArmItemCustomizer
  • Добавить предмет

Все клавиши можно изменить стандартным способом через настройки Minecraft.

Профили и сохранение

Все изменения сохраняются автоматически.

Сохраняются:

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

После перезапуска Minecraft повторно настраивать предметы не требуется.

Безопасная обработка кастомных данных

Серверы и античиты иногда не передают клиенту все данные предмета либо изменяют состав компонентов.

ArmItemCustomizer старается обрабатывать подобные ситуации безопасно.

Если необходимые данные недоступны, мод не должен приводить к падению клиента. Вместо этого предмет может быть пропущен или определён по доступным стабильным данным.

Для кого предназначен мод

ArmItemCustomizer подойдёт игрокам, которые:

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

Поддерживаемые версии

ArmItemCustomizer имеет версии для Fabric:

  • Minecraft 1.16.5
  • Minecraft 1.17.1
  • Minecraft 1.20.1
  • Minecraft 1.20.4
  • Minecraft 1.21.4
  • Minecraft 1.21.11

Автор: ArmDev Платформа: Fabric Тип: Client-side mod