PrimeItems Premium - создай кастомные предметы

Осталось загрузок за 24 часа: 2

PrimeItems — кастомные зачарования и предметы для прогресса и фарма

PrimeItems PREMIUM 1.0:

ОБЩАЯ ИНФОРМАЦИЯ
Основные характеристики
Название: PrimeItems
Версия: 1.0.0
Автор: PrimeItems Team
Лицензия: MIT
Язык: Java 8+
Совместимость с версиями Minecraft
Поддерживаемые версии
Минимальная версия: 1.16.5
Максимальная версия: 1.20.4
Рекомендуемая версия: 1.19.4+
API и платформы
Bukkit API: 1.16.5+
Spigot: 1.16.5+
Paper: 1.16.5+
Purpur: 1.16.5+
Tuinity: 1.16.5+
ava
Минимальная версия: Java 8
Рекомендуемая версия: Java 11+
Поддерживаемые архитектуры: x64, ARM64
ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ
Создание простого предмета
items:
magic_sword:
name: "§6§lМагический меч"
material: "DIAMOND_SWORD"
lore:
- "§7Легендарный меч с магическими свойствами"
- "§a+50% урона к мобам"
- "§e+25% шанс критического удара"
glow: true
activation: "MAINHAND"
effects:
STRENGTH:
enabled: true
value: 5
CRITICAL:
enabled: true
value: 2
Создание брони с защитой
items:
guardian_armor:
name: "§b§lДоспех стража"
material: "DIAMOND_CHESTPLATE"
lore:
- "§7Доспех древнего стража"
- "§c-30% получаемого урона"
- "§a+Регенерация 3"
glow: true
activation: "CHESTPLATE"
effects:
DAMAGE_REDUCTION:
enabled: true
value: 30
REGENERATION:
enabled: true
value: 3
Создание инструмента с эффектами
items:
ultimate_pickaxe:
name: "§e§lУльтимативная кирка"
material: "NETHERITE_PICKAXE"
lore:
- "§7Кирка с максимальной эффективностью"
- "§a+Автоплавка руды"
- "§e+Удвоение дропа"
- "§b+Магнетизм"
glow: true
activation: "MAINHAND"
effects:
AUTO_SMELT:
enabled: true
value: 1
DOUBLE_DROP:
enabled: true
value: 100
MAGNETISM:
enabled: true
value: 1
Создание предмета с кастомной текстурой
items:
custom_head:
name: "§d§lКастомная голова"
material: "PLAYER_HEAD"
lore:
- "§7Голова с уникальной текстурой"
glow: true
activation: "HELMET"
texture-id: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv..."
effects:
NIGHT_VISION:
enabled: true
value: 1
ТЕХНИЧЕСКАЯ ИНФОРМАЦИЯ
Версия API
Bukkit API: 1.16.5+
Зависимости: Нет
Совместимость: Bukkit, Spigot, Paper
Основные классы
PrimeItemsPlugin - главный класс плагина
ConfigManager - управление конфигурацией
EffectManager - управление эффектами
ItemManager - создание предметов
CustomEnchantmentManager - кастомные зачарования
MobHeadManager - головы мобов
Система эффектов
Проверка каждые 20 тиков (1 секунда)
Поддержка всех типов активации
Автоматическое применение/удаление эффектов
Поддержка процентных и постоянных эффектов
Производительность
Асинхронные обновления: Да
Размер кэша: 1000 элементов
Интервал очистки: 300 секунд (5 минут)
Максимум эффектов на игрока: 50

КОНФИГУРАЦИЯ
Структура файла config.yml
# Основные настройки
settings:
debug-mode: false
effect-check-interval: 20
max-effects-per-player: 50

# Настройки эффектов
effects:
update-interval: 20
max-effects-per-player: 50
enable-potion-effects: true
enable-enchantments: true

# Настройки производительности
performance:
async-updates: true
cache-size: 1000
cleanup-interval: 300

# Настройки безопасности
security:
max-item-effects: 10
prevent-duplicate-effects: true
validate-config: true

# Кастомные предметы
items:
# Здесь определяются ваши предметы
Как правильно создавать предметы
Базовая структура предмета
items:
item_id: # Уникальный идентификатор предмета
name: "§6§lНазвание предмета" # Отображаемое имя с цветами
material: "DIAMOND_SWORD" # Материал предмета
lore: # Описание предмета
- "§7Описание предмета"
- "§7Вторая строка"
glow: true # Эффект свечения
activation: "MAINHAND" # Тип активации
texture-id: "base64_texture_id" # Только для PLAYER_HEAD
effects: # Эффекты предмета
EFFECT_TYPE:
enabled: true
value: 5
Типы активации предметов
Тип активации Описание Где работает
INVENTORY В инвентаре В любом слоте инвентаря
MAINHAND В правой руке В правой руке игрока
OFFHAND В левой руке В левой руке игрока
HELMET На голове В слоте шлема
CHESTPLATE На груди В слоте нагрудника
LEGGINGS На ногах В слоте поножей
BOOTS На ступнях В слоте ботинок
HOTBAR В хотбаре В слотах 0-8
Материалы предметов
Оружие:

DIAMOND_SWORD - Алмазный меч
NETHERITE_SWORD - Незеритовый меч
BOW - Лук
CROSSBOW - Арбалет
TRIDENT - Трезубец
Инструменты:

DIAMOND_PICKAXE - Алмазная кирка
NETHERITE_PICKAXE - Незеритовая кирка
DIAMOND_AXE - Алмазный топор
DIAMOND_SHOVEL - Алмазная лопата
DIAMOND_HOE - Алмазная мотыга
Броня:

DIAMOND_HELMET - Алмазный шлем
DIAMOND_CHESTPLATE - Алмазный нагрудник
DIAMOND_LEGGINGS - Алмазные поножи
DIAMOND_BOOTS - Алмазные ботинки
Специальные:

PLAYER_HEAD - Голова игрока (для кастомных текстур)
STICK - Палочка
BOOK - Книга
ENCHANTED_BOOK - Зачарованная книга
Цветовые коды
Код Цвет Пример
§0 Черный §0Текст
§1 Темно-синий §1Текст
§2 Темно-зеленый §2Текст
§3 Темно-бирюзовый §3Текст
§4 Темно-красный §4Текст
§5 Фиолетовый §5Текст
§6 Золотой §6Текст
§7 Серый §7Текст
§8 Темно-серый §8Текст
§9 Синий §9Текст
§a Зеленый §aТекст
§b Бирюзовый §bТекст
§c Красный §cТекст
§d Розовый §dТекст
§e Желтый §eТекст
§f Белый §fТекст
§l Жирный §lЖирный
§m Зачеркнутый §mЗачеркнутый
§n Подчеркнутый §nПодчеркнутый
§o Курсив §oКурсив
§r Сброс §rОбычный
КОМАНДЫ ПЛАГИНА
Основные команды
/primeitems [reload|give|list|effects]
Описание: Основная команда плагина
Права: primeitems.use
Алиасы: pi, prime
Подкоманды:

reload - перезагрузка конфигурации
give <игрок> <предмет> - выдача предмета
list - список всех предметов
effects - показать активные эффекты
/giveprimeitem <игрок> <предмет> [количество] [уровень_эффектов]
Описание: Выдача кастомных предметов
Права: primeitems.give
Алиасы: gpi, giveprime
Примеры:

/giveprimeitem Player magic_talisman
/giveprimeitem Player lucky_pickaxe 5
/giveprimeitem Player magic_talisman 1 3
/primeenchant <игрок> <зачарование> [уровень]
Описание: Применение зачарований к предметам
Права: primeitems.enchant
Алиасы: enchantitem, addenchant, penchant
Примеры:

/primeenchant Player sharpness 5
/primeenchant Player bloodthirst 3
/primeenchant Player fire_aspect 2
/givemobhead <моб> [игрок]
Описание: Выдача голов мобов
Права: primeitems.givemobhead
Алиасы: gmh, mobhead
Примеры:

/givemobhead zombie
/givemobhead creeper PlayerName
/reloadprimeitems
Описание: Перезагрузка плагина
Права: primeitems.admin
Алиасы: rpi, reloadprime
Команды для разработчиков
/testenchant <зачарование> [уровень]
Описание: Тестирование кастомных зачарований
Права: primeitems.test
/simpletest <зачарование> [уровень]
Описание: Простое тестирование зачарований
Права: primeitems.test
/checkenchants
Описание: Проверка количества зачарований
Права: primeitems.admin
ЭФФЕКТЫ И ЗАЧАРОВАНИЯ
Основные эффекты
Эффект Описание Диапазон значений
FALL_DAMAGE_IMMUNITY Защита от урона при падении 0-100%
DAMAGE_REDUCTION Снижение получаемого урона 0-100%
DOUBLE_DROP Удвоение дропа 0-100% шанс
REGENERATION Регенерация 1-10 уровень
FIRE_RESISTANCE Огнестойкость 1-10 уровень
SPEED Скорость 1-10 уровень
JUMP_BOOST Прыгучесть 1-10 уровень
NIGHT_VISION Ночное зрение 1-10 уровень
WATER_BREATHING Водное дыхание 1-10 уровень
STRENGTH Сила 1-10 уровень
DAMAGE_IMMUNITY Полная защита от урона 0-100%
EXPERIENCE_BOOST Увеличение опыта Множитель
FOOD_RESTORATION Восстановление голода -
EXPLOSION_PROTECTION Защита от взрывов 0-100%
INVISIBILITY Невидимость 1-10 уровень
DOUBLE_DROP_MULTIPLIER Множитель добычи 2-20x
FARMER_EXP_BOOST Фармер - бонус опыта 1-5x
Эффекты зелий
Эффект Описание Диапазон значений
THORNS Шипы 1-5 уровень
POISON Отравление 1-5 уровень
BLINDNESS Слепота 1-5 уровень
SLOWNESS Замедление 1-5 уровень
RESISTANCE Сопротивление 1-5 уровень
MINING_FATIGUE Усталость 1-5 уровень
NAUSEA Тошнота 1-5 уровень
HUNGER Голод 1-5 уровень
WEAKNESS Слабость 1-5 уровень
LEVITATION Левитация 1-5 уровень
LUCK Удача 1-5 уровень
UNLUCK Неудача 1-5 уровень
DOLPHINS_GRACE Милость дельфина 1-5 уровень
HERO_OF_THE_VILLAGE Герой деревни 1-5 уровень
CONDUIT_POWER Сила проводника 1-5 уровень
SLOW_FALLING Медленное падение 1-5 уровень
BAD_OMEN Плохое предзнаменование 1-5 уровень
GLOWING Свечение 1-5 уровень
SATURATION Насыщенность 1-5 уровень
ABSORPTION Поглощение 1-5 уровень
WITHER Иссушение 1-5 уровень
INSTANT_DAMAGE Моментальный урон 1-5 уровень
INSTANT_HEALTH Исцеление 1-5 уровень
HASTE Спешка 1-5 уровень
Кастомные зачарования
Зачарования для инструментов
Зачарование Описание Уровни Цель
MAGNETISM Магнетизм - лут попадает в инвентарь 1 Инструменты
DRILL Бур - ломает территорию 3×3×1 или 3×3×2 1-2 Кирки
MEGA_DRILL Мега-бур - ломает территорию 5×5×2 1 Кирки
AUTO_SMELT Автоплавка - переплавляет руду 1 Кирки
EXPERIENCED Опытный - 10-30% больше опыта с руды 1-3 Кирки
INDESTRUCTIBLE Неразрушимость - запрещает использование при прочности <10 1 Все
LUMBERJACK Дровосек - 50-128 блоков за удар 1-3 Топоры
DELICATE Деликатный - не ломает невыросшие растения 1 Мотыги
FARMER Фермер - до 80% больше культур 1-4 Мотыги
PLANTING Посев - 5-20% шанс посадки 1-4 Мотыги
Зачарования для оружия
Зачарование Описание Уровни Цель
CRUSHER Крушитель - 10-70% урона боссам 1-7 Мечи
DESTROYER Разрушитель - 12.5-25% быстрее ломает броню 1-2 Мечи
CRITICAL Критический - 10-20% шанс +15% урона 1-2 Мечи
RICH Богач - до 40% больше монет с мобов 1-5 Мечи
HOMING Самонаводка - наводит трезубец на игрока 1-4 Трезубцы
STUNNING Оглушение - 5% шанс дебаффов 1-2 Луки
POISON_WEAPON Отрава - 7.5% шанс тошноты при критическом ударе 1-3 Мечи
PERSISTENCE Упорство - 2-8% уменьшение дебаффов от стрел 1-3 Броня
DIVINE_TOUCH Божье Касание - ломает любые блоки, включая спавнеры 1 Инструменты
RETURN Возвращение - 3-9% шанс возврата урона 1-3 Мечи
Зачарования для брони
Зачарование Описание Уровни Цель
PERSISTENCE Упорство - 2-8% уменьшение дебаффов от стрел 1-3 Броня
LIVING_ARMOR Живая броня - восстанавливает 1% прочности при шаге 1-3 Броня
MIRROR_SHIELD Зеркальный щит - отражает 25% урона 1-2 Щиты
BIO_ADAPTATION Биоадаптация - снижает урон от одного типа мобов 1-3 Броня
PHANTOM_ARMOR Фантомная броня - невидимость на 3 сек после урона 1 Броня
Зачарования для луков и стрел
Зачарование Описание Уровни Цель
HOMING_ARROW Гоминг - корректирует траекторию к цели 1-2 Луки
SPLIT_SHOT Сплит-шот - стрела разделяется на 3 1 Луки
RETURN_SHOT Обратный выстрел - стрела возвращается к стрелку 1 Луки
TELEPORT_ARROW Стрела-телепорт - телепортация к месту попадания 1 Луки
LIGHT_ARROW Световая стрела - освещает область на 10 сек 1 Луки
POISON_TIP Ядовитый наконечник - яд на 5 сек 1-3 Стрелы
EXPLOSIVE_ARROW Стрела-взрыв - взрывается при попадании 1-2 Луки
FREEZE_ARROW Стрела-заморозка - замораживает цель и воду 1 Луки
Специальные зачарования
Зачарование Описание Уровни Цель
GEOLOGIST Геологоразведчик - подсвечивает редкие руды в радиусе 8 блоков 1 Кирки
ENERGY_SAVER Энергосбережение - уменьшает износ на 50% 1-3 Все
FARMER_LUCK Удача фермера - больше семян/урожая 1-3 Мотыги
VAMPIRISM_FT Вампиризм ФТ - регенерация каждые 2.5-0.625 секунды 1-3 Мечи
VAMPIRE Вампир - шанс исцеления при ударе 1-3 Мечи
EXPLOSIVE_MINING Взрывная добыча - шанс добыть блоки взрывом 1-5 Кирки
RAGE Гнев - больше урона за недостающее здоровье 1-5 Мечи
THUNDER Гром - шанс ударить молнией 1-5 Мечи
DOUBLE_STRIKE Двойной удар - шанс двойного урона 1-2 Мечи
BLOODTHIRST Кровожадность - восстановление 1 сердца при убийстве 1-3 Мечи
ГОЛОВЫ МОБОВ
Доступные мобы
Враждебные мобы
zombie - Зомби
skeleton - Скелет
creeper - Крипер
spider - Паук
enderman - Эндермен
witch - Ведьма
blaze - Блейз
ghast - Гаст
slime - Слайм
magma_cube - Магма куб
wither_skeleton - Визер скелет
wither - Визер
piglin - Пиглин
piglin_brute - Пиглин брут
zombified_piglin - Зомбифицированный пиглин
hoglin - Хоглин
zoglin - Зоглин
strider - Страйдер
endermite - Эндермит
shulker - Шалкер
ender_dragon - Дракон края
phantom - Фантом
warden - Страж
Мирные мобы
cow - Корова
pig - Свинья
chicken - Курица
sheep - Овца
horse - Лошадь
wolf - Волк
cat - Кот
parrot - Попугай
panda - Панда
fox - Лиса
bee - Пчела
dolphin - Дельфин
turtle - Черепаха
axolotl - Аксолотль
goat - Коза
frog - Лягушка
allay - Эллей
camel - Верблюд
sniffer - Сниффер
Водные мобы
squid - Кальмар
glow_squid - Светящийся кальмар
guardian - Страж
elder_guardian - Древний страж
drowned - Утопленник
cod - Треска
salmon - Лосось
pufferfish - Рыба-фугу
tropical_fish - Тропическая рыба
Нейтральные мобы
iron_golem - Железный голем
snow_golem - Снежный голем
villager - Житель
wandering_trader - Странствующий торговец
pillager - Разбойник
vindicator - Защитник
evoker - Призыватель
vex - Векс
ravager - Разоритель
Использование
# Выдача головы себе
/givemobhead zombie

# Выдача головы другому игроку
/givemobhead creeper PlayerName
ПРАВА ДОСТУПА
Основные права
Право Описание По умолчанию
primeitems.use Основное использование true
primeitems.admin Административные функции op
primeitems.give Выдача предметов op
primeitems.list Просмотр списка предметов true
primeitems.effects Просмотр активных эффектов op
primeitems.enchant Применение зачарований op
primeitems.test Тестирование зачарований op
primeitems.givemobhead Выдача голов мобов op
primeitems.givemobhead.others Выдача голов мобов другим игрокам op
primeitems.bypass Обход ограничений плагина op
primeitems.* Все права плагина op
Настройка прав в permissions.yml
# Пример настройки прав
groups:
default:
permissions:
- primeitems.use
- primeitems.list
vip:
permissions:
- primeitems.use
- primeitems.list
- primeitems.givemobhead
admin:
permissions:
- primeitems.*

УСТРАНЕНИЕ НЕПОЛАДОК
Частые проблемы
Плагин не загружается
Проверьте версию Java (нужна 8+)
Проверьте версию сервера (нужна 1.16.5+)
Проверьте логи на ошибки
Предметы не работают
Проверьте конфигурацию в config.yml
Убедитесь что предметы правильно настроены
Проверьте права доступа игроков
Эффекты не применяются
Проверьте тип активации предмета
Убедитесь что предмет находится в правильном слоте
Проверьте логи на ошибки
Зачарования не работают
Проверьте совместимость зачарования с предметом
Убедитесь что зачарование зарегистрировано
Проверьте права доступа
Логи и отладка
Включение режима отладки
settings:
debug-mode: true
Проверка статуса плагина
/plugins
/primeitems list
/checkenchants
Просмотр активных эффектов
/primeitems effects
ПОДДЕРЖКА
Получение помощи
Проверьте эту документацию
Проверьте логи сервера
Обратитесь к разработчикам
Отчеты об ошибках
При сообщении об ошибке укажите:

Версию Minecraft
Версию сервера (Paper/Spigot)
Версию Java
Логи ошибок
Шаги для воспроизведения
Обновления
Следите за обновлениями плагина
Делайте резервные копии конфигурации
Тестируйте на тестовом сервере