SlashBlade JS

SlashBlade JS - это аддон, который работает как мост между популярным оружейным модом Slashblade: Resharped и скриптовым фреймворком KubeJS. Если вы когда-нибудь играли с Слэшблейдом, то знаете, что там крутая система аниме-мечей с заточкой, счетчиком убийств и душами (ProudSoul). Но проблема в том, что добавить свой собственный клинок или изменить крафт ванильными способами было той еще болью - требовалось писать полноценный Java-мод. Этот мод для Майнкрафт решает проблему, давая в руки разработчикам серверов и сборок удобные инструменты для скриптинга.

Что умеет SlashBlade JS?

По факту, аддон открывает доступ к внутренним механикам Slashblade: Resharped через KubeJS. Вы можете в пару строк скрипта создать уникальный меч со своей моделью, текстурой, уроном и специальными эффектами. А еще - настроить сложные рецепты, где для крафта потребуется меч с определенным счетчиком убийств или уровнем заточки.

Вот готовый пример того, как это выглядит в коде:

javascript // priority: 0

/* Server Side */

// Когда Slashblade проверяет состояние заряда: если не заряжен, тратим 10 ProudSoul для активации SlashBladeJSEvents.powerBlade(event => { let state = BladeState.of(event.blade) let proudsoul = state.proudSoulCount if (!event.isPowered() && proudsoul >= 10) { state.setProudSoulCount(proudsoul - 10) event.setPowered(true) } event.user.tell("ProudSoul: " + proudsoul) // Уведомляем игрока о текущем значении ProudSoul })

// Кастомный рецепт для Slashblade ServerEvents.recipes(event => { event.recipes.slashblade.slashblade_shaped_recipe("slashblade:slashblade", [ "ABA", "CSC", "ABC" ], { "S": SlashBladeIngredient.of( SlashBladeRequestDefinition.name("slashblade:fox_black") // Требуемый базовый меч .killCount(233) // Требование к счетчику убийств .proudSoul(114514) // Требование к душам .refineCount(10) // Требование к заточке .addEnchantment(SBEnchantmentDefinition.of("minecraft:power", 2)) // Требование к зачарованию .build() // Не забываем про .build() ), "A": "minecraft:golden_apple", // Остальные материалы (как в ванильных рецептах) "B": "#forge:bones", "C": "minecraft:cake", }, "slashblade:fox_white"/* ID результата */) })

// Создаем свой меч ServerEvents.highPriorityData(event => { let customBlade = SBSlashBladeDefinition.of("kubejs:test_blade", // ID вашего меча SBRenderDefinition.newInstance() // Свойства рендера .effectColor(2039347) // Цвет эффекта (hex RGB в десятичном виде) .standbyRenderType(SBCarryType.DEFAULT) // Положение в ножнах .modelName("kubejs/model/named/test_blade.obj") // Путь: ./kubejs/assets/kubejs/model/named/test_blade.obj .textureName("kubejs/model/named/test_blade.png") // Путь: ./kubejs/assets/kubejs/model/named/test_blade.png .build(), // Не забываем про .build() SBPropertiesDefinition.newInstance() .maxDamage(666) // Максимальная прочность .baseAttackModifier(999) // Базовый урон .slashArtsType("slashblade:void_slash") // Спецудар .addSpecialEffect("slashblade:wither_edge") // Спецэффект .defaultSwordType([SBSwordType.FIERCEREDGE, SBSwordType.BEWITCHED]) // Типы клинка .build(), // Не забываем про .build() [ // Стандартные зачарования SBEnchantmentDefinition.of("minecraft:power", 5), SBEnchantmentDefinition.of("minecraft:unbreaking", 10) ] )

// Регистрируем в игре
event.addJson("kubejs:slashblade/named_blades/test_blade.", SBSlashBladeDefinition.toJSON(customBlade))

})

Разбор механик

В коде выше показаны три главные фичи, которые открывает SlashBlade JS:

1. События (Events). Блок powerBlade перехватывает момент, когда игрок пытается зарядить меч. Скрипт проверяет души и если их хватает - тратит 10 штук на активацию. Так можно балансировать мощные клинки на сервере.
2. Крафты с условиями. Обычный верстак Minecraft тут не подойдет. Вы можете сделать рецепт, где ключевым ингредиентом выступает другой меч Слэшблейд, но не простой, а прокачанный. В примере для крафта белого лиса нужен черный с 233 убийствами, 10 заточкой и зачарованием на Силу. Это идеальная механика для RPG-сборок модов.
3. Генерация нового оружия. Через SBSlashBladeDefinition вы создаете клинок с нуля. Задаете путь к OBJ-модели, текстуре, прописываете урон, прочность, спецудары (вроде void_slash) и даже выдаете стандартные чары. Все это генерируется в JSON на лету.

Важные нюансы

• Зависимости: Для работы аддона обязательно нужны KubeJS и сам Slashblade: Resharped. Без них скрипты просто не запустятся.
• Пути к ассетам: Обратите внимание на строки modelName и textureName. Файлы моделей (.obj) и текстуры (.png) должны лежать строго в папке ./kubejs/assets/kubejs/model/named/. Если путь указан неверно, вместо красивого меча в игре появится фиолетово-черный квадрат.
• Не забывайте про .build(): В скриптах KubeJS часто нужно закрывать цепочку методов вызовом .build(). Забудете - скрипт сломается, и консоль заспамит ошибками.

Скачайте мод SlashBlade JS, если планируете делать кастомное оружие для своей сборки или сервера. Это сэкономит кучу времени на написании Java-кода и даст гибкость в настройке баланса прямо во время работы сервера.