← Все статьи

Как сделать кастомное оружие: урон, скорость атаки и вид, который узнают игроки

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

Проверено на версиях: 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,08
Длинный мечРовный и понятный7 / 1,6+6 / −2,411,2
Боевой молотМедленный, тяжёлый, наказывающий11 / 0,8+10 / −3,28,8
Ритуальный посохВ основном реквизит3 / 1,2+2 / −2,83,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.

Как выбрать базовый предмет

/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={}. В экономике сервера это убирает причину его менять, так что оставьте это для редких наград.

Зачарования работают поверх?

Да. Острота и остальные прибавляются к изменённому урону; какие из них не сочетаются, перечислено в статье о несовместимости.

Как сбалансировать несколько видов оружия?

Сведите их в одну таблицу с уроном, скоростью и уроном в секунду, а потом проверьте каждое в одном и том же бою. Табличная версия и ощущение в игре с первого раза совпадают редко.