Скачать SmartNPCs
Выберите нужную версию Minecraft для загрузки готового .JAR-файла с GitHub Releases или скачайте полный исходный код проекта.
SmartNPCs заменяет стандартное поведение мобов трёхслойным искусственным интеллектом. Боты имитируют моторику мыши, рассчитывают упреждение через 9D-фильтр Калмана, адаптируются к вашему стилю боя с помощью цепей Маркова и Thompson Sampling, строят 3D A* паркур-маршруты и объединяются во фракции.
В клиент встроена полноценная 3D-студия с импортом Bedrock-моделей (.geo.json), GPU Compute скиннингом на OpenGL 4.3, 3D-кистью, редактором квестов, кинематографическими диалогами и компиляцией скриптов на лету.
Выберите нужную версию Minecraft для загрузки готового .JAR-файла с GitHub Releases или скачайте полный исходный код проекта.
Требования среды и пошаговый сценарий спавна и настройки вашего первого персонажа.
SmartNPCs разработан под Minecraft 1.21.5 на загрузчике Fabric и языке Kotlin (JVM 21). Все инструменты настройки доступны во вкладке креатива «Кастомные NPC» (smartnpc:npc_tab).
| Компонент | Требуемая версия / путь |
|---|---|
| Minecraft / Loader | 1.21.5 / Fabric Loader 0.16.14+ |
| Fabric API / Kotlin | 0.128.2+1.21.5 / 1.13.3+kotlin.2.1.21 |
| Скины и плащи (.png) | mods/NPCs_mod/skins/ и mods/NPCs_mod/capes/ |
| Конфиги графов и 3D-моделей | config/smartnpc/ (behavior_graph.json, custom_entities/, animations/) |
| Данные мира (пресеты, квесты, фракции, скрипты) | saves/<Мир>/NPC_mod/ (Presets/, dialogues/, quests/, factions/, Scripts/) |
Полный справочник всех 8 предметов креатива, глобальных хоткеев и команд экономики.
Весь функционал мода управляется внутри игры без ручного редактирования JSON-файлов. Каждый инструмент отвечает за свою подсистему мира, а глобальные редакторы открываются горячими клавишами.
| Инструмент / Клавиша | ID / Сочетание | Назначение и управление |
|---|---|---|
| Создатель NPC | smartnpc:npc_spawner | ПКМ по блоку — спавн NPC; ПКМ по NPC — редактирование; Shift + ПКМ — Инспектор NPC. |
| Спавнер пресетов | smartnpc:preset_spawner | ПКМ по воздуху или Shift + ПКМ — выбор/редактирование/удаление пресетов карты; ПКМ по блоку — спавн выбранного пресета. |
| Настройщик взаимодействия | smartnpc:bot_interaction_tuner | ПКМ по Боту — выбрать бота; ПКМ по зелёным блокам/сущностям — привязать/отвязать; ПКМ по воздуху — окно весов вероятностей. |
| Инструмент квестов | smartnpc:quest_wand | ПКМ — список квестов мира и переход в графовый редактор этапов. |
| Инструмент PVP-зон | smartnpc:pvp_zone_wand | ПКМ по блокам — расстановка вершин полигона (≥ 3 точки, замыкание кликом по 1-й точке); ПКМ внутри — настройки; Shift + ПКМ — сброс черновика. |
| Жезл мирной зоны | smartnpc:safe_zone_wand | Замыкание полигона SafeZone (не пересекает PVP-зоны); ПКМ внутри — запреты и строгий дресс-код. |
| Инструмент зон спавна | smartnpc:npc_spawn_zone_wand | Замыкание полигона спавна; ПКМ внутри — лимит NPC, таймер деспавна, пул пресетов и шанс случайных игроков. |
| Инструмент POI | smartnpc:poi_wand | ПКМ по блоку — создать/настроить точку интереса (приоритеты паркура, ближнего и дальнего боя, длительность). |
| Глобальный редактор | Ctrl + N | Движение, Бой, Профессии, Фракции, Скрипты и Создатель Сущностей (3D-студия). |
| AI Debugger | Ctrl + G | Телеметрия PLAYER-NPC, 3D-путь, луч цели, FOV-конус, логи действий/причин, камера наблюдения и Follow. |
| Журнал странника | J | Текущая фракция и повышение рангов, активные квесты, доска контрактов Bounty и 3D-трекер цели. |
Трансформации, 41 слот экипировки, вероятностный лут в слотах и система яиц-пресетов.
Левая панель главного меню gui_main едина для всех трёх типов ИИ (BOT, PLAYER, MOB) и позволяет гибко управлять внешностью, трансформацией, инвентарём и сохранением шаблонов.
Когда выбирать каждый тип сущности и какие вкладки доступны в редакторе.
SmartNPCs разделяет сущности на три специализированных класса, чтобы мирные жители не тратили ресурсы на боевой анализ, а бойцы-игроки и боссы использовали собственные движки поведения.
| Тип ИИ | Назначение | Ключевые возможности и вкладки |
|---|---|---|
| BOT (entity_NPC_Bot) | Сюжетные NPC, торговцы, стражи, жители поселений | Не деспавнится. Роли: NONE, TRADER (4 вкладки × 90 слотов, CR/бартер/скупка/лимиты), GUARD (точка охраны, радиус 4–64 бл., персональные боевые настройки под каждый EntityType). Позы (Стоит/Сидит/Лежит/Танцует + .json-анимации), слежение взглядом, окружение (m_b_environment), Диалоги, Лидер фракции, Скрипт. |
| PLAYER (entity_NPC_Player) | Автономные «живые» игроки на сервере | Трёхслойный мозг e_p_Brain: 18 ползунков характера, 8 PVP-навыков, 5 сопротивлений, сытость/регенерация, 3D A* паркур, походы в группах, обмен лутом, реакция на кражу опыта, POI, 9D Калман + Марков + Thompson Sampling, автоподбор/дроп лута и система обиды Bounty. |
| MOB (entity_NPC_Mob) | Кастомные монстры и мировые боссы | Ранги NORMAL и BOSS (автоматический красный Боссбар в радиусе 64 бл. и 80% сопротивления откидыванию). Выбор модели (Зомби, Скелет, Крипер, Снеговик, Свинья, Иссушитель, Эндер-Дракон, Херобрин или кастомная 3D-модель), способности, скорости, напрыгивание с проверкой пропастей, паттерны Осмотра/Сближения/Отступления и Скрипт. |
Как работает цикл тика PLAYER-NPC от рефлексов до квантования поворота мыши.
У сущностей типа PLAYER полностью отключены ванильные MoveControl, LookControl и JumpControl. Вместо них каждый серверный тик работает конвейер e_p_Brain.tickPhysics(), который рассчитывает прямые вводы клавиатуры (inputForward, inputStrafe, inputSprint, inputSneak, inputJump) и передаёт их в e_p_Motor.
События урона, обнаружения врага, блокировки пути и столкновения с препятствием обрабатываются асинхронно через корутинный канал e_p_AiScope с последующим применением в основном серверном потоке.
Настройка весов, синергии, переходов и внутренних свойств всех 20 модулей поведения.
Нажмите Ctrl + N, чтобы открыть редактор графов поведения (gui_GraphConfigScreen). Конфигурация сохраняется в config/smartnpc/behavior_graph.json и автоматически синхронизируется с сервером и клиентами.
В центре экрана находится хаб Locomotion (веса походки: Прыжок, Спринт, Прыжок+Спринт, Присед, Ходьба, Ходьба+Присед). Вокруг расположены карточки модулей: в каждой задаются общий вес, минимальная и максимальная длительность (m / M в секундах), свойства или внутренние действия, веса синергии с другими модулями и вероятности следующего перехода («Вызов»).
| Граф | Модули и их назначение |
|---|---|
| Движение (8 модулей) | environment (осмотр сундуков/бочек, крафт, редстоун, рыбалка, срез травы на бегу, салют в компании ≥ 5 NPC), traveler (одиночные и групповые походы по 2–3 бота с выносливостью и формацией), lootTrade (обмен фейк-лутом с напарником, бросание колб опыта, реакция на кражу игроком), poi (тренировка на точках интереса), troll (троллинг вокруг игроков), Habits (смена слотов, АФК, оглядывание), SocialInteraction (приседания и приветствия с другими ботами), water (плавание и лодки). |
| Бой (12 модулей) | HUMAN_PVP_PRESSURE (агрессивный Boids-прессинг и криты), ROD_COMBO (удочка/снежок + врыв), KITING_RESET (кайт с флик-выстрелами и лечением), FLINT_IGNITE (крафт и поджог огнивом с упреждением), BOW_FAKE (ложное натяжение лука), SHIELD_BAIT_AXE (байт щита и слом топором), FAKE_HEAL (байт яблоком), CORNER_BAIT (засада за углом), AERIAL_AMBUSH (прыжок с высоты и удар булавой), RANGED_FLANK (фланговый обстрел), COBWEB_BRAWL (выход из паутины), COBWEB_PERIMETER_ABUSE (удержание паутины на дистанции). |
W-Tap, автокрафт в бою, 9D-фильтр Калмана, цепи Маркова, Thompson Sampling и тепловые карты.
Боевой контроллер comb_Combat реализует ключевые механики современного Minecraft PVP: точный тайминг ударов по атрибуту ATTACK_SPEED, криты в фазе падения (Δy < -0.001), W-Tap и S-Tap сброс спринта, Jump-Reset при получении урона, автоматическую экипировку тотема бессмертия в левую руку, отключение щита топором на 100 тиков, взрывные зелья лечения/урона и Boids-разделение союзников.
Если для тактики не хватает предмета (удочки, лука, огнива, лодки или верстака), Crafting_Manager автоматически крафтит его из досок, брёвен, палок, нитей, кремня и железа прямо из инвентаря NPC.
Двухуровневый поиск пути, обучение на срывах и визуальная отладка поведения в реальном времени.
Навигация loc_PathPlanner работает асинхронно в корутинах и автоматически выбирает движок в зависимости от приоритета ситуации: фоновый pathfinder_Fast (2.5D-сетка, куча 8192 узла) или боевой pathfinder_Advanced (3D A* до 262 144 узлов с 10-битной маской свойств каждого блока — проходимость, вода, лестницы, двери, паутина, песок душ, заборы, опасности).
В 3D A* встроены баллистические прыжки через пропасти до 4 блоков и диагональные прыжки 2×2 с проверкой чистоты коридора, DDA Line-of-Sight сглаживание, стеновой обход заборов (loc_StuckHandler) и модуль SA_JumpAnalytics, который запоминает неудачные прыжки и повышает штраф проблемного ребра.
Создание иерархических моделей костей, 12 встроенных шаблонов и назначение модели на NPC.
Откройте глобальный редактор (Ctrl + N) и нажмите кнопку «Создатель Сущностей» в правом верхнем углу. Редактор сохраняет проекты в config/smartnpc/custom_entities/<id>.json без перезапуска клиента.
В выпадающем списке «Сущность» доступны 12 готовых шаблонов с настроенными костями и анимациями: Стив, Зомби, Скелет, Крипер, Свинья, Житель, Слизень, Эндермен, Дракон Края, Снеговик, Древняя Чупакабра (10 голов, 15 рук, 10 ног) и Демон Прибежища.
Рисование прямо по граням 3D-модели, упаковщик RizomMaxRectsBinPacker и запекание PNG.
Вкладка «Текстурирование» (gui_TextureStudioScreen) содержит три подрежима: «Редактор UV», «Рисование» и «Наложение», а также переключатель разрешения атласа (16×16, 32×32, 64×64, 128×128, 256×256, 512×512) и кнопку «UV» для переключения между 3D-видом и 2D-развёрткой.
Таймлайн, кривые интерполяции, SSBO на 2048 костей, процедурные роли и crossfade состояний.
Вкладка «Анимирование» (gui_AnimationStudioScreen) позволяет создавать неограниченное число треков (idle, walk, sprint, attack, roar и др.) и настраивать плавные переходы между ними.
Создание ветвящихся графов диалогов, 12 ракурсов камеры и игровые действия.
Система диалогов привязывается к сущностям типа BOT на вкладке «Диалог» в gui_main. Файлы графов сохраняются в saves/<Мир>/NPC_mod/dialogues/<dialogueId>.json и могут переиспользоваться на нескольких ботах.
Настройка 360 торговых слотов, боевой охраны с поводком и расписания объектов бота.
Боты (entity_NPC_Bot) могут выполнять роль торговца, стража или жителя, взаимодействующего с блоками и сущностями в городе.
Экономика, иерархия рангов с налогами, карательные патрули и глобальная охота за головами.
Квесты, фракции, профессии и система розыска работают как единая RPG-экосистема, настраиваемая через Ctrl + N и Инструмент квестов.
Разметка территорий любой формы, дресс-код, управление популяцией и точки интереса.
Зоны в SmartNPCs задаются произвольными многоугольниками (≥ 3 вершины) с автоматическим расчётом вертикального диапазона (minY - 32 .. maxY + 32) и 3D-подсветкой границ, когда жезл находится в руке.
| Тип зоны | Цвет 3D-сетки | Правила и настройки |
|---|---|---|
| PVP-зона | Красный (черновик) / Зелёный (замкнута) | Разрешает свободный PVP между игроками и NPC без штрафа RetributionManager. Не может пересекать мирную зону. Настраивается шанс агрессии ИИ (0–100%). |
| Мирная зона (SafeZone) | Синий / Голубой | Запрещает PVP между игроками/NPC. Независимые тумблеры: полёт, спринт, сундуки/бочки, ломание/установка блоков, урон по мобам. Строгий дресс-код проверяет 4 слота брони и отталкивает нарушителей с экраном gui_DresscodeAlert. |
| Зона спавна | Бирюзовый | Поддерживает целевое число NPC (1–50) с интервалом деспавна (5–300 сек), пулом пресетов (случайное имя, случайный скин, разлёт статов statVariance) и процентом полностью случайных PLAYER-NPC. Автоматически очищает лишних и ушедших далеко ботов. |
| Точка интереса (POI) | Зелёный / Красный / Синий луч | Одиночный блок-маяк (до 3 NPC одновременно). Веса Паркура, Ближнего и Дальнего боя (0–100), требование брони и длительность пребывания (мин/макс сек). PLAYER-NPC сами выбирают наиболее подходящую POI по своему снаряжению. |
От написания в редакторе Ctrl + N до исполнения в памяти сервера.
Скрипты хранятся в папке мира saves/<Мир>/NPC_mod/Scripts/ с расширением .java (также поддерживается чтение .kts). Встроенный редактор открывается через Ctrl + N → «Скрипты» или через кнопку «Открыть Java Script Editor» на вкладке </> у любого бота/моба.
При первом запуске или изменении файла движок script_BytecodeCompiler оборачивает ваш код в класс CompiledScriptExecutable и компилирует его прямо в оперативной памяти через системный JavacTool (Java 21) в изолированный ScopedScriptClassLoader. Если сервер работает на JRE без компилятора JDK или в коде использован упрощённый синтаксис DSL, автоматически срабатывает встроенный DSL-интерпретатор.
Полный список объектов bridge, world, npc, player и target, доступных внутри скрипта.
При компиляции скрипта в тело метода execute() автоматически прокидываются готовые переменные: ServerLevel level, ScriptWorldAPI world, ScriptEntityAPI npc, ScriptEntityAPI player, ScriptEntityAPI target, long timeOfDay, boolean isNight, boolean isDay, boolean isRaining и объект bridge (ScriptBridgeScope).
| Метод / Свойство | Сигнатура | Описание |
|---|---|---|
| bridge.cooldown | (key, durationTicks) -> boolean | Проверяет и устанавливает перезарядку в тиках (20 тиков = 1 сек). Возвращает false, если кулдаун активен. |
| bridge.limitActive | (preset, max, radius) -> boolean | Возвращает true, если число живых NPC указанного пресета в радиусе меньше max. |
| bridge.spawnBanditHorde | (preset, count, radius) | Спавнит отряд NPC по пресету вокруг игрока/сущности (жёсткий потолок защиты от спама: до 8 вокруг). |
| bridge.launchFireworks | (count) | Запускает разноцветные фейерверки в точке события. |
| bridge.playSound | (soundId, volume, pitch) | Проигрывает звук в мире (например, "minecraft:block.bell.use", 1.0f, 0.9f). |
| bridge.broadcastMessage | (message) | Отправляет сообщение в глобальный чат всем игрокам сервера. |
| bridge.schedule | (delayTicks, () -> { ... }) | Откладывает выполнение блока кода на заданное количество тиков. |
| bridge.heal / damage / teleport | (amount) / (x, y, z) | Быстрые команды лечения NPC, нанесения урона цели и телепортации NPC. |
| world.* | setTime, setWeather, getBlock, setBlock, spawnParticle, executeCommand | Управление временем суток, погодой, блоками, частицами (flame, smoke, explosion, crit, heart, portal, flash) и серверными командами. |
| npc / player / target.* | exists, id, name, x/y/z, health, maxHealth, heal, damage, kill, teleport, setVelocity, addEffect, clearEffects, setTarget, setEquipItem | Полное чтение и изменение состояния привязанного NPC, вызвавшего игрока или текущей цели. |
Рабочие сценарии ночного рейда, отложенного салюта и боссовой фазы лечения.
Ниже приведены проверенные шаблоны, которые можно напрямую вставить в редактор скриптов и адаптировать под ваши пресеты из NPC_mod/Presets/.
// Срабатывает только ночью (13000..23000 тиков)
if (timeOfDay < 13000 || timeOfDay > 23000) return false;
// Перезарядка 5 минут (6000 тиков) и лимит не более 4 рейдеров в радиусе 48 блоков
if (!bridge.cooldown("night_raid_cd", 6000L)) return false;
if (!bridge.limitActive("bandit_raider", 4, 48.0)) return false;
bridge.broadcastMessage("Наступила полночь! Бандиты выходят на охоту...");
bridge.spawnBanditHorde("bandit_raider", 3, 32.0);
bridge.playSound("minecraft:entity.wolf.howl", 1.2f, 0.8f);
// Отложенная вторая волна эффектов через 2 секунды (40 тиков)
bridge.schedule(40L, () -> {
world.spawnParticle("flame", npc.getX(), npc.getY() + 1.5, npc.getZ(), 20, 0.15);
bridge.playSound("minecraft:block.bell.use", 1.0f, 0.85f);
});
return true;