Ръководство
Как да направиш собствени предмети с плъгин
Обновено на 18 октомври 2026 г.
Собствени мечове, жезли, ключове и инструменти са сред най-търсените функции в плъгините. Плъгинът не може да добави наистина нов предмет в играта, но може да вземе ванилен предмет, да му даде име, lore и скрит таг и да реагира, когато играчът го използва. Играчите влизат с обикновената игра, без нужда от модове.
Смени предметите със своите.
Генерирай това с CodexeСтъпка по стъпка
1.Изброй предметите
За всеки предмет: основният материал, показваното име, редовете lore и какво прави. „Огнен прът, наречен Fire Wand, който изстрелва огнено кълбо с десен клик, 5 секунди изчакване“ е завършен предмет.
2.Маркирай ги с PersistentDataContainer
Запази id като
fire_wandвPersistentDataContainerна предмета сNamespacedKey. Плъгинът разпознава предмета по този таг, а не по името, така че преименуването на наковалня не създава копие.3.Напиши способностите
Всяка способност е слушател на събития:
PlayerInteractEventза десни кликове,EntityDamageByEntityEventза удари,BlockBreakEventза инструменти. Добави изчакване за всеки играч и за всеки предмет.4.Реши как ги получават играчите
Админ команда
/give, рецепта за изработване, магазин, плячка от мобове или награди от сандъци (crates).5.Направи всичко настройваемо
Имена, lore, щети, изчаквания и рецепти в
config.yml, за да балансираш предметите без нова компилация.6.Компилирай и пробвай всеки предмет
Остави Codexe да компилира плъгина, влез в тестовия сървър с „Пробвай сега“, дай си всеки предмет и го използвай.
Защо таг, а не името
Проверката на показваното име или lore е класическата грешка: всеки играч с наковалня може да преименува пръчка на „Fire Wand“. PersistentDataContainer (Minecraft 1.14 и по-нови) пази върху предмета данни, които играчите не могат да редактират, и те оцеляват след рестарти, в сандъци и при размени, защото са част от предмета.
От 1.8 до 1.13 няма PersistentDataContainer; плъгините използват NBT чрез библиотека или скрит маркер в lore. Посочи версията в заявката и Codexe ще напише подхода, който тази версия поддържа.
Способностите и събитията зад тях
| Способност | Събитие | Бележки |
|---|---|---|
| Сила с десен клик | PlayerInteractEvent | Провери ръката, събитието се задейства по веднъж за всяка ръка |
| Допълнителни щети или ефекти при удар | EntityDamageByEntityEvent | Провери, че нападателят е играч, който държи предмета |
| Инструмент за копаене на площ | BlockBreakEvent | Спазвай плъгините за защита като WorldGuard |
| Пасивен ефект, докато предметът е в ръката | Повтаряща се задача или PlayerItemHeldEvent | Махни ефекта, когато предметът бъде прибран |
| Лък или снаряд | EntityShootBowEvent, ProjectileHitEvent | Маркирай снаряда, за да знаеш откъде идва |
Текстури и модели
Плъгинът променя какво прави предметът, а не как изглежда. За собствен външен вид трябва ресурсен пакет, който играчите изтеглят: на по-старите версии предметът носи число CustomModelData, което пакетът свързва с модел, а от 1.21.2 предметът може да сочи и към собствен модел чрез компонента item_model. Без пакет предметът изглежда като основния си материал със собствено име, което за много сървъри е напълно достатъчно.
Примерно описание
„Плъгин за Paper 1.21.4, наречен MagicItems. Три предмета, всеки маркиран с id в PersistentDataContainer: Fire Wand (огнен прът, десният клик изстрелва огнено кълбо, 5 s изчакване), Frost Blade (железен меч, ударите дават Slowness II за 3 s), Miner's Pick (диамантена кирка, чупи 3x3, но не в WorldGuard региони, където играчът не може да строи). /mi give <player> <item> за magicitems.admin. Рецепти с форма за всеки. Имената, lore, изчакванията и рецептите са в config.yml.“
Въпроси
Плъгин или мод за собствени предмети?
Плъгин, ако играчите трябва да влизат с обикновената игра: предметите са ванилни предмети с ново поведение. Мод, ако ти трябват наистина нови предмети или блокове със собствено изобразяване, които после всеки играч инсталира. Виж плъгин или мод.
Мога ли да използвам ItemsAdder или Nexo с него?
Плъгинът ти може да зависи от тях, но те са платени плъгини: тестовият сървър на Codexe не може да ги инсталира, затова плъгин, който изисква някой от тях, няма да се включи там. Безплатните зависимости от plugin.yml се инсталират на тестовия сървър вместо теб.
Спират ли да работят предметите след обновяване?
Предметите, маркирани с PersistentDataContainer, запазват тага си при обновявания на Minecraft. Способностите може да изискват нова компилация за новото API; виж обновяване на плъгин.
Направи своите собствени предмети
Този промпт се отваря готов за изпращане:
“Плъгин за Paper 1.21.4, наречен MagicItems, с три предмета, маркирани с PersistentDataContainer: Fire Wand (огнен прът, десният клик изстрелва огнено кълбо, 5 секунди изчакване), Frost Blade (железен меч, Slowness II за 3 секунди при удар), Miner's Pick (диамантена кирка, която копае 3x3). /mi give за magicitems.admin, рецепта с форма за всеки, имената, lore, изчакванията и рецептите са в config.yml.”
Генерирай това с Codexe