Easy NPC

🗣 Easy NPC (Bundle)

Easy NPC предоставляет упрощённую систему для создания собственных NPC с диалогами, торговлей и взаимодействиями для создателей карт, RPG, приключенческих серверов, модпаков и других модов.

Этот проект — Easy NPC Bundle, удобный пакет для лаунчеров, который автоматически устанавливает необходимые модули Easy NPC.

Этот набор не содержит сами модули Easy NPC.

📦 Обзор установки

Easy NPC разделён на несколько модулей. Набор существует, чтобы упростить установку через лаунчеры, поддерживающие автоматическое разрешение зависимостей.

Вариант A: установка через лаунчер (рекомендуется)

• Установите Easy NPC Bundle

• Ваш лаунчер автоматически установит необходимые модули:

  • Easy NPC Core
  • Easy NPC Config UI (инструменты настройки и необходимое сетевое взаимодействие)

Вариант B: ручная установка или скопированные модпаки

Если вы устанавливаете моды вручную или копируете модпак между инстансами, убедитесь, что необходимые модули на месте:

• Easy NPC Core
• Easy NPC Config UI

Совет: при передаче или копировании модпака копируйте всю папку mods/, чтобы все необходимые jar-файлы были включены.

Вступительное видео и обзор (на английском)

▶YouTube · плеер загрузится по нажатию

✨ Возможности

• Простые NPC с диалогами, торговлей и взаимодействиями
• Простая настройка для создателей карт, серверов и RPG-окружений
• Настраиваемые действия с параметрами отладки
• Поддержка торговли с настраиваемыми предложениями и условиями
• Настройка скинов с поддержкой имени игрока и URL
• Рассчитан как на серверное, так и на клиентское окружение
• Поддержка API и интеграция с другими модами

📦 Интеграция с модами

Armourer's Workshop

Базовая интеграция с Armourer's Workshop для использования скинов из библиотеки.

Epic Fight Mod

Встроенная поддержка Epic Fight включена начиная с Easy NPC 6.4.x. Дополнительный мод для интеграции не требуется.

[Immersive Melodies][immersive-melodies]

Базовая интеграция с Immersive Melodies для использования музыкальных инструментов.

Использование

Создайте NPC с помощью соответствующего яйца призыва или через команду summon.

Используйте предустановленные команды /easy_npc или жезл настройки NPC, чтобы открыть графический интерфейс. GUI позволяет настраивать диалоги, торговлю, скины, действия и другие параметры NPC прямо в игре.

Большинство взаимодействий и настроек можно выполнять прямо в игре без редактирования файлов или перезапуска сервера.

⬆️ Обновление

Пожалуйста, обязательно ознакомьтесь с руководством по обновлению перед обновлением до новой версии.

ℹ️ Почему больше нет jar-in-jar сборки

В старых версиях использовалась схема jar-in-jar для объединения нескольких модулей Easy NPC в один файл.

Этот подход вызывал ряд технических проблем:

• Дублирование ID модов при отдельной установке модулей
• Конфликты загрузки классов и неоднозначные источники модов
• Несовместимости, когда в качестве зависимости требовался только Easy NPC Core
• Повышенная сложность сопровождения и поддержки

Современные лаунчеры уже обеспечивают разрешение зависимостей. Использование этого механизма даёт более чистую и предсказуемую конфигурацию и позволяет обновлять модули Easy NPC независимо.

ℹ️ Дополнительная информация

Пожалуйста, ознакомьтесь с вики для получения дополнительной информации.

🐛 Сообщения о проблемах, багах, крашах или запросы функций

Пожалуйста, сообщайте о проблемах и запросах функций по ссылке на issues. Я рад помочь вам.

🫶 Поддержите меня

Если вам нравится использовать мои творения, подумайте о поддержке моей разработки! ☕️ Пожертвования через Ko-fi чрезвычайно помогают, но не обязательны (мои моды бесплатны и с открытым исходным кодом!). Каждый вклад помогает мне продолжать создавать моды в свободное время, покрывая расходы на программное обеспечение, сервисы, оборудование и немного пиццы или дополнительный Spezi.

⚖️ Лицензия

MIT LICENSE применяется только к коду в этом репозитории. Изображения, модели и другие ресурсы явно исключены.