Проверено на версиях: Java Edition 1.20–26.3.
Числа за любым оружием ближнего боя
У игрока изначально 1 урона и скорость атаки 4. Оружие добавляет модификаторы сверху: ванильный железный меч даёт +5 к урону и −2,4 к скорости — отсюда его 6 урона и скорость 1,6. Чтобы бить на 7, добавьте 6; чтобы бить 1,6 раза в секунду, добавьте −2,4.
| Роль | Ощущается как | Урон / скорость | Модификаторы | Урон в секунду |
|---|---|---|---|---|
| Кинжал | Быстрый, лёгкий, давит темпом | 4 / 2,0 | +3 / −2,0 | 8 |
| Длинный меч | Ровный и понятный | 7 / 1,6 | +6 / −2,4 | 11,2 |
| Боевой молот | Медленный, тяжёлый, наказывающий | 11 / 0,8 | +10 / −3,2 | 8,8 |
| Ритуальный посох | В основном реквизит | 3 / 1,2 | +2 / −2,8 | 3,6 |
Урон в секунду — это урон, умноженный на скорость при полном заряде удара. Он показывает, почему молот, бьющий сильнее всех, не самое сильное оружие в долгом бою и почему его тяжёлые удары по-другому ощущаются на дуэли.
Свои модификаторы заменяют стандартные
Как только предмету заданы модификаторы атрибутов, встроенные пропадают. Алмазный меч, которому дали только +2 удачи, бьёт как пустая рука. Всегда задавайте и урон, и скорость, даже если хотели поменять что-то одно.
Используйте для этих двух модификаторов ID minecraft:base_attack_damage и minecraft:base_attack_speed — тогда подсказка покажет итог, «7 урона», как у ванильного меча; с любым другим ID она покажет «+6 к урону».
Один и тот же длинный меч в каждой версии
1.21.5 – 26.x: модификаторы — обычный список, у ID атрибутов нет префикса.
/give @p minecraft:iron_sword[minecraft:custom_name={text:"Guild longsword",italic:false},minecraft:attribute_modifiers=[{type:"minecraft:attack_damage",id:"minecraft:base_attack_damage",amount:6,operation:"add_value",slot:"mainhand"},{type:"minecraft:attack_speed",id:"minecraft:base_attack_speed",amount:-2.4,operation:"add_value",slot:"mainhand"}]] 1
1.21.2 – 1.21.4: список лежит внутри {modifiers:[…]}, а имя — строка JSON. В 1.21 – 1.21.1 ещё и типы атрибутов пишутся как minecraft:generic.attack_damage и minecraft:generic.attack_speed.
/give @p minecraft:iron_sword[minecraft:custom_name='{"text":"Guild longsword","italic":false}',minecraft:attribute_modifiers={modifiers:[{type:"minecraft:attack_damage",id:"minecraft:base_attack_damage",amount:6,operation:"add_value",slot:"mainhand"},{type:"minecraft:attack_speed",id:"minecraft:base_attack_speed",amount:-2.4,operation:"add_value",slot:"mainhand"}]}] 1
До 1.20.5: NBT с именем и UUID у каждого модификатора.
/give @p minecraft:iron_sword{display:{Name:'{"text":"Guild longsword","italic":false}'},AttributeModifiers:[{AttributeName:"generic.attack_damage",Name:"guild_damage",Amount:6,Operation:0,UUID:[I;1,1,1,1],Slot:"mainhand"},{AttributeName:"generic.attack_speed",Name:"guild_speed",Amount:-2.4,Operation:0,UUID:[I;1,1,1,2],Slot:"mainhand"}]} 1
1.20.5 – 1.20.6 посередине: компоненты как в 1.21, но каждому модификатору нужны uuid и name вместо id.
Как выбрать базовый предмет
- Меч или топор уже ведёт себя как оружие: у него есть прочность, он принимает боевые зачарования на наковальне, а топор выбивает поднятый щит.
- Палка, кость или огненный стержень годятся для реквизита и посохов, но у них нет прочности и они стакаются. Добавьте
max_stack_size=1иmax_damage: команду, которая делает предмет одновременно стакающимся и изнашиваемым, игра не примет. С 1.21.5 компонентweaponзадаёт, сколько прочности стоит каждый удар.
/give @p minecraft:stick[minecraft:max_stack_size=1,minecraft:max_damage=250,minecraft:weapon={item_damage_per_attack:1},minecraft:custom_name={text:"Ritual staff",italic:false},minecraft:attribute_modifiers=[{type:"minecraft:attack_damage",id:"minecraft:base_attack_damage",amount:2,operation:"add_value",slot:"mainhand"},{type:"minecraft:attack_speed",id:"minecraft:base_attack_speed",amount:-2.8,operation:"add_value",slot:"mainhand"}]] 1
Оружие, которое узнают
Если у двух видов оружия одна текстура, игроки будут их путать, какими бы ни были характеристики. Дайте каждому свою модель: с 1.21.4 предмет указывает на item definition через item_model (этот файл пишет конструктор item_model), раньше модель выбирало число CustomModelData через overrides пака. Короткое имя и одна строка лора о том, для чего оружие, сделают остальное.
Как скрыть строки характеристик
Для загадочной реликвии цифры в подсказке могут быть лишними. С 1.21.5 добавьте tooltip_display={hidden_components:["minecraft:attribute_modifiers"]}; в 1.20.5 – 1.21.4 положите show_in_tooltip:false внутрь attribute_modifiers; до 1.20.5 используйте HideFlags:2.
Частые вопросы
Можно сделать оружие неразрушимым?
Да, добавьте unbreakable={}. В экономике сервера это убирает причину его менять, так что оставьте это для редких наград.
Зачарования работают поверх?
Да. Острота и остальные прибавляются к изменённому урону; какие из них не сочетаются, перечислено в статье о несовместимости.
Как сбалансировать несколько видов оружия?
Сведите их в одну таблицу с уроном, скоростью и уроном в секунду, а потом проверьте каждое в одном и том же бою. Табличная версия и ощущение в игре с первого раза совпадают редко.