Водич
Како направити сопствене предмете плагином
Ажурирано 18. октобар 2026.
Сопствени мачеви, штапићи, кључеви и алати спадају у најтраженије функције плагина. Плагин не може да дода заиста нов предмет у игру, али може да узме vanilla предмет, да му име, lore и скривену ознаку и да реагује кад га играч користи. Играчи улазе са обичном игром, без модова.
Промени предмете по својој мери.
Генериши ово уз CodexeКорак по корак
1.Наведи предмете
За сваки предмет: основни материјал, приказано име, редове lore-а и шта ради. „Blaze штап под називом Fire Wand који десним кликом испаљује ватрену куглу, cooldown 5 секунди“ је комплетан предмет.
2.Означи их помоћу PersistentDataContainer-а
Сачувај id као што је
fire_wandуPersistentDataContainerпредмета узNamespacedKey. Плагин препознаје предмет по тој ознаци, а не по имену, па преименовање на наковњу не прави копију.3.Напиши способности
Свака способност је event listener:
PlayerInteractEventза десне кликове,EntityDamageByEntityEventза ударце,BlockBreakEventза алате. Додај cooldown по играчу и по предмету.4.Одлучи како их играчи добијају
Админ команда
/give, рецепт за израду, продавница, дропови мобова или награде из сандука.5.Учини све подесивим
Имена, lore, штета, cooldown-и и рецепти у
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 | Означи пројектил да би знао одакле је дошао |
Текстуре и модели
Плагин мења шта предмет ради, а не како изгледа. За сопствени изглед треба resource пак који играчи преузимају: на старијим верзијама предмет носи CustomModelData број који пак повезује са моделом, а од 1.21.2 предмет може да показује и на сопствени модел преко компоненте item_model. Без пака предмет изгледа као основни материјал са сопственим именом, што је за многе сервере сасвим у реду.
Пример описа
„Paper 1.21.4 плагин под називом MagicItems. Три предмета, сваки означен PersistentDataContainer id-јем: Fire Wand (blaze штап, десни клик испаљује ватрену куглу, cooldown 5 с), Frost Blade (гвоздени мач, ударци дају Slowness II на 3 с), Miner's Pick (дијамантски крамп, копа 3x3, али не у WorldGuard регионима где играч не може да гради). /mi give <player> <item> за magicitems.admin. Обликовани рецепти за сваки. Имена, lore, cooldown-и и рецепти у config.yml.“
Питања
Плагин или мод за сопствене предмете?
Плагин ако играчи треба да улазе са обичном игром: предмети су vanilla предмети са новим понашањем. Мод ако ти требају заиста нови предмети или блокови са сопственим приказом, који онда сваки играч инсталира. Погледај плагин или мод.
Могу ли да користим ItemsAdder или Nexo уз њега?
Твој плагин може да зависи од њих, али то су плаћени плагини: Codexe тест сервер не може да их инсталира, па се плагин који захтева неки од њих тамо неће укључити. Бесплатне зависности наведене у plugin.yml инсталирају се на тест сервер уместо тебе.
Да ли предмети престају да раде после ажурирања?
Предмети означени PersistentDataContainer-ом задржавају ознаку кроз Minecraft ажурирања. Способностима можда треба нови билд за нови API; погледај ажурирање плагина.
Направи своје предмете
Овај промпт се отвара спреман за слање:
“Paper 1.21.4 плагин под називом MagicItems са три предмета означена PersistentDataContainer-ом: Fire Wand (blaze штап, десни клик испаљује ватрену куглу, cooldown 5 секунди), Frost Blade (гвоздени мач, Slowness II на 3 секунде при ударцу), Miner's Pick (дијамантски крамп који копа 3x3). /mi give за magicitems.admin, обликовани рецепт за сваки, имена, lore, cooldown-и и рецепти у config.yml.”
Генериши ово уз Codexe