⚔ UpSword — Заточка мечей с шансами и стихиями
GUI-система улучшения оружия для Paper/Spigot 1.20.x — 1.21+
════════════════════════════════════
О ПЛАГИНЕ
UpSword добавляет на ваш сервер полноценную механику "заточки" мечей — как в популярных ММО и RPG-проектах. Игроки прокачивают меч через удобное GUI-меню, тратя на это настраиваемые предметы (не деньги — только вещи, что удобно для выживания и экономик без Vault). Каждая попытка улучшения — это риск: успех, сохранение уровня, откат назад или полное разрушение меча, с шансами, которые вы полностью настраиваете под баланс своего сервера.
На высоких уровнях заточки меч может случайно получить одну постоянную стихию — Огонь, Лёд или Яд — которая будет проявляться в бою на регулярной основе. Никакой магии внутри кода — все шансы, стоимости и эффекты лежат в открытых YAML-конфигах.
════════════════════════════════════
ВОЗМОЖНОСТИ
• GUI-меню заточки — открывается зажатием Shift + ПКМ прямо с мечом в руке, без лишних команд для игроков
• Оплата только предметами — никакого Vault, никакой завязки на баланс. Любой ваш кастомный предмет (с текстурой, лором, чарами) можно зарегистрировать как ингредиент прямо из руки одной командой
• Гибкая стоимость по уровням — на каждый уровень заточки можно назначить произвольное количество разных предметов сразу (например, +9 требует пыль заточки + осколок незерита + чешую дракона одновременно)
• Полностью настраиваемые шансы — 4 исхода на каждый уровень: успех, провал с сохранением, откат на уровень ниже, полное разрушение меча. Сумма всегда должна быть 100%, а плагин сам это проверяет
• До 10 уровней заточки (настраивается) — урон меча растёт в процентах от базового, применяется прямо в бою, без порчи ванильных характеристик оружия
• Случайные стихийные атрибуты — Огонь , Лёд ❄ и Яд ☠. На одном мече может закрепиться не больше ОДНОЙ стихии, с небольшим шансом при удачной заточке начиная с нужного уровня
• Гарантированное срабатывание раз в N ударов — если стихия закрепилась, она сработает не "рандомно иногда", а чётко каждый настроенный удар (например, каждый 3-й), это тоже настраивается в конфиге для каждой стихии отдельно
• Огонь с обходом огнестойкости — стихия "Яростное пламя" наносит урон каждую секунду, игнорируя зелье/эффект огнестойкости цели (но не броню и не защитные зачарования — честно, без читерства)
• Исходный Lore меча сохраняется — если ваш меч уже имеет описание от другого плагина (кастомные RPG-характеристики, лор, название), заточка ДОПИСЫВАЕТ информацию снизу, а не стирает её
• 3 языка из коробки — русский, украинский, английский. Все сообщения через MiniMessage (современный формат цветов и градиентов)
• Звуки и частицы — на каждый исход заточки настраиваются свои звук и партикл
• Валидация конфигов — при команде reload плагин проверяет все конфиги на согласованность (сумма шансов = 100%, уровень 1 без отката и т.д.) и НЕ применит битый конфиг, пока вы не исправите ошибку — старые настройки просто останутся работать
════════════════════════════════════
УСТАНОВКА
1. Скачайте .jar и положите в папку plugins/ вашего Paper-сервера (1.20.x — 1.21+, Java 17+)
2. Перезапустите сервер — плагин создаст все конфиги в plugins/UpSword/
3. Зарегистрируйте предметы, которые будут тратиться на заточку (встаньте с предметом в руке):
/upsword register sharpness_dust
4. Назначьте стоимость для нужных уровней:
/upsword setcost 1 sharpness_dust 1
/upsword setcost 5 sharpness_dust 3
/upsword setcost 5 netherite_shard 1
5. Настройте шансы в chance-upgrade.yml и стихии в attributes-up.yml под баланс вашего сервера
6. Примените изменения без рестарта:
/upsword reload
Готово! Игроки открывают меню, зажав Shift + ПКМ с мечом (по умолчанию — алмазный или незеритовый) в руке.
════════════════════════════════════
КОМАНДЫ
/upsword register <имя> upsword.admin Регистрирует предмет из руки как ингредиент заточки
/upsword setcost <ур.> <имя> <кол-во> upsword.admin Назначает/обновляет стоимость уровня
/upsword removecost <ур.> <имя> upsword.admin Убирает предмет из стоимости уровня
/upsword listcost <ур.> upsword.admin Показывает текущую стоимость уровня
/upsword reload upsword.admin Перезагружает конфиги с валидацией
ПРАВА
• upsword.use — открытие меню заточки (по умолчанию есть у всех игроков)
• upsword.admin — доступ ко всем административным командам (по умолчанию только у операторов)
════════════════════════════════════
КОНФИГУРАЦИЯ (7 файлов)
• config.yml — язык, список типов мечей для улучшения, звуки/частицы на каждый исход
• items.yml — база зарегистрированных предметов-ингредиентов (заполняется командой, руками лезть не нужно)
• levels.yml — стоимость (список предметов) и прирост урона для каждого уровня
• chance-upgrade.yml — шансы успеха/провала/отката/поломки на каждый уровень (сумма = 100%)
• attributes-up.yml — стихии: с какого уровня доступны, шанс закрепления, раз во сколько ударов срабатывают
• gui.yml — оформление меню: слоты, тайтл, кнопка улучшения, заполнитель
• languages/ru.yml, ua.yml, en.yml — все сообщения плагина, поддержка MiniMessage-разметки
════════════════════════════════════
ЧАСТЫЕ ВОПРОСЫ
Урон точно не исчезает после первой же заточки?
Нет — модификатор урона применяется прямо в бою поверх уже посчитанного ванильного урона меча (базовый урон + зачарования + крит), а не через подмену атрибутов в NBT предмета. Базовые характеристики меча остаются нетронутыми.
Могут ли быть две стихии на одном мече?
Нет, максимум одна на весь "срок службы" меча. Если она однажды выпала — новых попыток закрепить другую уже не будет.
Что будет с моим кастомным описанием меча (лор от другого плагина)?
Оно сохранится. Плагин один раз запоминает исходный Lore предмета и просто дописывает информацию об уровне заточки снизу — ничего не удаляется.
Можно ли улучшать не только алмазные/незеритовые мечи?
Да, список типов мечей (allowed-swords) настраивается в config.yml — можно добавить любой тип меча или убрать ненужный.
════════════════════════════════════
UpSwordTest — бесплатная демо-версия
Хотите протестировать плагин перед покупкой полной версии? Специально для этого есть UpSwordTest — точная копия функционала UpSword без единого урезания механик.
Чем отличается от полной версии:
• Функционал заточки, GUI, стихии, конфиги — на 100% идентичны полной версии
• Плагин работает ровно 30 минут с момента первой установки на сервер
• По истечении времени плагин автоматически и мягко отключает себя штатным способом Bukkit (как ручная выгрузка через /plugman), без порчи миров, инвентарей игроков или других плагинов
• В момент отключения в чат всем игрокам и в консоль отправляется объявление: "Пробный период UpSword закончен!"
• Отсчёт не сбрасывается перезапуском сервера — метка времени первой установки хранится в отдельном читаемом YAML-файле (plugins/UpSwordTest/trial-data.yml) и переживает рестарты и переустановку jar-а
Зачем это нужно:
Чтобы вы могли за 30 минут реально пощупать плагин на своём сервере — открыть меню, покрутить шансы, попробовать заточить пару мечей, посмотреть стихии в бою — прежде чем принимать решение о покупке полной версии. Никакого урезанного "лайт"-функционала, никакой обфускации: файл с меткой времени открытый, всё честно и прозрачно.
════════════════════════════════════
ПОДДЕРЖКА
Автор: DiStudio
По вопросам, багам и предложениям — пишите в личные сообщения или оставляйте отзыв под ресурсом.
GUI-система улучшения оружия для Paper/Spigot 1.20.x — 1.21+
════════════════════════════════════
О ПЛАГИНЕ
UpSword добавляет на ваш сервер полноценную механику "заточки" мечей — как в популярных ММО и RPG-проектах. Игроки прокачивают меч через удобное GUI-меню, тратя на это настраиваемые предметы (не деньги — только вещи, что удобно для выживания и экономик без Vault). Каждая попытка улучшения — это риск: успех, сохранение уровня, откат назад или полное разрушение меча, с шансами, которые вы полностью настраиваете под баланс своего сервера.
На высоких уровнях заточки меч может случайно получить одну постоянную стихию — Огонь, Лёд или Яд — которая будет проявляться в бою на регулярной основе. Никакой магии внутри кода — все шансы, стоимости и эффекты лежат в открытых YAML-конфигах.
════════════════════════════════════
ВОЗМОЖНОСТИ
• GUI-меню заточки — открывается зажатием Shift + ПКМ прямо с мечом в руке, без лишних команд для игроков
• Оплата только предметами — никакого Vault, никакой завязки на баланс. Любой ваш кастомный предмет (с текстурой, лором, чарами) можно зарегистрировать как ингредиент прямо из руки одной командой
• Гибкая стоимость по уровням — на каждый уровень заточки можно назначить произвольное количество разных предметов сразу (например, +9 требует пыль заточки + осколок незерита + чешую дракона одновременно)
• Полностью настраиваемые шансы — 4 исхода на каждый уровень: успех, провал с сохранением, откат на уровень ниже, полное разрушение меча. Сумма всегда должна быть 100%, а плагин сам это проверяет
• До 10 уровней заточки (настраивается) — урон меча растёт в процентах от базового, применяется прямо в бою, без порчи ванильных характеристик оружия
• Случайные стихийные атрибуты — Огонь , Лёд ❄ и Яд ☠. На одном мече может закрепиться не больше ОДНОЙ стихии, с небольшим шансом при удачной заточке начиная с нужного уровня
• Гарантированное срабатывание раз в N ударов — если стихия закрепилась, она сработает не "рандомно иногда", а чётко каждый настроенный удар (например, каждый 3-й), это тоже настраивается в конфиге для каждой стихии отдельно
• Огонь с обходом огнестойкости — стихия "Яростное пламя" наносит урон каждую секунду, игнорируя зелье/эффект огнестойкости цели (но не броню и не защитные зачарования — честно, без читерства)
• Исходный Lore меча сохраняется — если ваш меч уже имеет описание от другого плагина (кастомные RPG-характеристики, лор, название), заточка ДОПИСЫВАЕТ информацию снизу, а не стирает её
• 3 языка из коробки — русский, украинский, английский. Все сообщения через MiniMessage (современный формат цветов и градиентов)
• Звуки и частицы — на каждый исход заточки настраиваются свои звук и партикл
• Валидация конфигов — при команде reload плагин проверяет все конфиги на согласованность (сумма шансов = 100%, уровень 1 без отката и т.д.) и НЕ применит битый конфиг, пока вы не исправите ошибку — старые настройки просто останутся работать
════════════════════════════════════
УСТАНОВКА
1. Скачайте .jar и положите в папку plugins/ вашего Paper-сервера (1.20.x — 1.21+, Java 17+)
2. Перезапустите сервер — плагин создаст все конфиги в plugins/UpSword/
3. Зарегистрируйте предметы, которые будут тратиться на заточку (встаньте с предметом в руке):
/upsword register sharpness_dust
4. Назначьте стоимость для нужных уровней:
/upsword setcost 1 sharpness_dust 1
/upsword setcost 5 sharpness_dust 3
/upsword setcost 5 netherite_shard 1
5. Настройте шансы в chance-upgrade.yml и стихии в attributes-up.yml под баланс вашего сервера
6. Примените изменения без рестарта:
/upsword reload
Готово! Игроки открывают меню, зажав Shift + ПКМ с мечом (по умолчанию — алмазный или незеритовый) в руке.
════════════════════════════════════
КОМАНДЫ
/upsword register <имя> upsword.admin Регистрирует предмет из руки как ингредиент заточки
/upsword setcost <ур.> <имя> <кол-во> upsword.admin Назначает/обновляет стоимость уровня
/upsword removecost <ур.> <имя> upsword.admin Убирает предмет из стоимости уровня
/upsword listcost <ур.> upsword.admin Показывает текущую стоимость уровня
/upsword reload upsword.admin Перезагружает конфиги с валидацией
ПРАВА
• upsword.use — открытие меню заточки (по умолчанию есть у всех игроков)
• upsword.admin — доступ ко всем административным командам (по умолчанию только у операторов)
════════════════════════════════════
КОНФИГУРАЦИЯ (7 файлов)
• config.yml — язык, список типов мечей для улучшения, звуки/частицы на каждый исход
• items.yml — база зарегистрированных предметов-ингредиентов (заполняется командой, руками лезть не нужно)
• levels.yml — стоимость (список предметов) и прирост урона для каждого уровня
• chance-upgrade.yml — шансы успеха/провала/отката/поломки на каждый уровень (сумма = 100%)
• attributes-up.yml — стихии: с какого уровня доступны, шанс закрепления, раз во сколько ударов срабатывают
• gui.yml — оформление меню: слоты, тайтл, кнопка улучшения, заполнитель
• languages/ru.yml, ua.yml, en.yml — все сообщения плагина, поддержка MiniMessage-разметки
════════════════════════════════════
ЧАСТЫЕ ВОПРОСЫ
Урон точно не исчезает после первой же заточки?
Нет — модификатор урона применяется прямо в бою поверх уже посчитанного ванильного урона меча (базовый урон + зачарования + крит), а не через подмену атрибутов в NBT предмета. Базовые характеристики меча остаются нетронутыми.
Могут ли быть две стихии на одном мече?
Нет, максимум одна на весь "срок службы" меча. Если она однажды выпала — новых попыток закрепить другую уже не будет.
Что будет с моим кастомным описанием меча (лор от другого плагина)?
Оно сохранится. Плагин один раз запоминает исходный Lore предмета и просто дописывает информацию об уровне заточки снизу — ничего не удаляется.
Можно ли улучшать не только алмазные/незеритовые мечи?
Да, список типов мечей (allowed-swords) настраивается в config.yml — можно добавить любой тип меча или убрать ненужный.
════════════════════════════════════
UpSwordTest — бесплатная демо-версия
Хотите протестировать плагин перед покупкой полной версии? Специально для этого есть UpSwordTest — точная копия функционала UpSword без единого урезания механик.
Чем отличается от полной версии:
• Функционал заточки, GUI, стихии, конфиги — на 100% идентичны полной версии
• Плагин работает ровно 30 минут с момента первой установки на сервер
• По истечении времени плагин автоматически и мягко отключает себя штатным способом Bukkit (как ручная выгрузка через /plugman), без порчи миров, инвентарей игроков или других плагинов
• В момент отключения в чат всем игрокам и в консоль отправляется объявление: "Пробный период UpSword закончен!"
• Отсчёт не сбрасывается перезапуском сервера — метка времени первой установки хранится в отдельном читаемом YAML-файле (plugins/UpSwordTest/trial-data.yml) и переживает рестарты и переустановку jar-а
Зачем это нужно:
Чтобы вы могли за 30 минут реально пощупать плагин на своём сервере — открыть меню, покрутить шансы, попробовать заточить пару мечей, посмотреть стихии в бою — прежде чем принимать решение о покупке полной версии. Никакого урезанного "лайт"-функционала, никакой обфускации: файл с меткой времени открытый, всё честно и прозрачно.
════════════════════════════════════
ПОДДЕРЖКА
Автор: DiStudio
По вопросам, багам и предложениям — пишите в личные сообщения или оставляйте отзыв под ресурсом.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
UpSwordTest is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 8 times (via Spigot). Download it and open it directly in the game.