English
ArmItemCustomizer

ArmItemCustomizer is a client-side Minecraft Fabric mod developed by ArmDev that allows players to customize the visual size of individual items directly on the client.

The mod includes a built-in profile system, support for regular Minecraft items and custom server items, configurable keybinds, and per-item scaling.

ArmItemCustomizer is especially useful on servers that use custom weapons, talismans, totems, spheres, player heads, artifacts, custom models, and items containing modified NBT or Data Components.

No server-side plugin is required.

Main Features

Profiles

ArmItemCustomizer allows you to create multiple independent profiles.

For example:

• HolyWorld
• FunTime
• ReallyWorld
• Vanilla
• any other server or game mode

Each profile can contain its own tracked items and individual scale settings.

Only the currently selected profile is used, which makes it easy to keep settings from different servers separated.

---

Individual Item Scaling

Every tracked item can have its own independent scale.

For example:

• Netherite Sword — x2
• Custom Talisman — x5
• Custom Sphere — x7.5
• Totem — x3
• Pickaxe — x1.5

Changing the size of one item does not affect other tracked items.

Scale values can be changed using:

• + and − buttons;
• holding + or − for continuous adjustment;
• clicking the scale field and entering an exact value manually.

Decimal values are supported, such as:

1.25, 2.5, 3.75, 7.5.

---

Adding Items

Items can be added to the active profile in several ways.

From the GUI

You can add:

• the item currently held in your hand;
• items from your inventory;
• individual items directly to the selected profile.

Using a keybind

ArmItemCustomizer adds its own keybind category inside Minecraft controls:

ArmItemCustomizer

You can assign a key to the Add Item action.

Then simply:

1. open your inventory, chest, or another container screen;
2. hover over the item you want to track;
3. press the assigned key.

The item will immediately be added to the currently active profile.

The mod also displays chat notifications, for example:

ArmItemCustomizer > Item added: Fire Talisman

---

Standard Minecraft Items

Regular Minecraft items can be tracked using their item ID.

Examples:

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

This means that normal items can still be recognized even if secondary properties change, such as:

• durability;
• enchantments;
• stack count;
• other non-essential properties.

---

Custom Server Item Support

ArmItemCustomizer is also designed to recognize custom server items that use:

• NBT;
• Data Components;
• Custom Data;
• Custom Model Data;
• Item Model;
• Player Profile / custom head textures;
• custom names;
• lore;
• other server-defined components.

This makes it possible to distinguish between multiple custom items that technically use the same vanilla base item.

For example, several different custom spheres may all be based on minecraft:player_head, while still being treated as separate items by ArmItemCustomizer.

This is useful for:

• custom spheres;
• talismans;
• custom totems;
• custom heads;
• artifacts;
• custom weapons;
• server-specific items with custom models.

---

Clean Item Names

The GUI displays readable item names instead of raw technical information.

Instead of showing something like:

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

or a long NBT/component string, ArmItemCustomizer displays:

Netherite Sword

For custom items, the server-provided custom name can be displayed, for example:

Fire Talisman

If a proper display name cannot be resolved, the mod can fall back to the item's Minecraft ID.

---

Built-in GUI

The ArmItemCustomizer interface can be opened using a configurable keybind.

Default key:

Right Shift

The GUI includes:

• profile list;
• active profile selection;
• profile creation;
• profile deletion;
• deletion confirmation;
• tracked item list;
• per-item removal;
• individual item scale controls;
• exact scale input;
• item adding tools.

The entire system is designed to be controlled through the GUI without manually editing configuration files.

---

Keybinds

ArmItemCustomizer creates its own control category instead of placing its keybinds inside Minecraft's generic Miscellaneous category.

Main keybinds include:

• Open ArmItemCustomizer
• Add Item

Both can be reassigned through Minecraft's standard control settings.

---

Automatic Saving

Your settings are saved automatically.

The mod stores:

• created profiles;
• currently active profile;
• tracked items;
• individual item scales;
• mod settings.

Your configuration remains available after restarting Minecraft.

---

Safe Custom Data Handling

Some servers or anti-cheat systems may hide, modify, or limit item information sent to the client.

ArmItemCustomizer is designed to handle incomplete item data safely.

If specific information is unavailable, the mod attempts to use other stable item properties instead of crashing the game.

---

Who Is This Mod For?

ArmItemCustomizer is useful for players who:

• play on anarchy servers;
• use servers with many custom items;
• want specific items to be easier to notice;
• want larger custom spheres, talismans, or weapons;
• want separate configurations for different servers;
• prefer a GUI instead of manually editing configuration files.

---

Supported Versions

Fabric versions are available for:

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

Developer: ArmDev
Platform: Fabric
Type: Client-side mod

Русский
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