Smart NPCs

Make your world alive
Обзор мода
MINECRAFT FABRIC 1.21.5 • KOTLIN 2.1 & JVM 21

Живой мир, в котором NPC играют как настоящие люди

SmartNPCs заменяет стандартное поведение мобов трёхслойным искусственным интеллектом. Боты имитируют моторику мыши, рассчитывают упреждение через 9D-фильтр Калмана, адаптируются к вашему стилю боя с помощью цепей Маркова и Thompson Sampling, строят 3D A* паркур-маршруты и объединяются во фракции.

В клиент встроена полноценная 3D-студия с импортом Bedrock-моделей (.geo.json), GPU Compute скиннингом на OpenGL 4.3, 3D-кистью, редактором квестов, кинематографическими диалогами и компиляцией скриптов на лету.

3-Layer AI Калман 9D, Марков и Thompson Sampling
2048 костей OpenGL 4.3 Compute SSBO + 3D-кисть
3D A* Паркур Прыжки до 4 блоков и обучение на срывах
Javac JIT Компиляция .java/.kts скриптов в памяти
Видеопревью геймплея и 3D-студии 16:9 HD
00:00 / 00:00
Скриншоты из игры 4 сцены
FREE & OPEN SOURCE • GITHUB RELEASES

Скачать SmartNPCs

Выберите нужную версию Minecraft для загрузки готового .JAR-файла с GitHub Releases или скачайте полный исходный код проекта.

Версия Minecraft
Быстрый старт и Основы Start

Установка и создание первого NPC

Требования среды и пошаговый сценарий спавна и настройки вашего первого персонажа.

#установка#Fabric 1.21.5#быстрый старт#gui_main

SmartNPCs разработан под Minecraft 1.21.5 на загрузчике Fabric и языке Kotlin (JVM 21). Все инструменты настройки доступны во вкладке креатива «Кастомные NPC» (smartnpc:npc_tab).

  1. Установите Minecraft 1.21.5, Fabric Loader 0.16.14+, Fabric API 0.128.2+1.21.5 и Fabric Language Kotlin 1.13.3+kotlin.2.1.21 на Java 21 (для JIT-компиляции .java-скриптов рекомендуется JDK 21; на обычной JRE автоматически работает встроенный DSL-интерпретатор).
  2. Откройте инвентарь креатива, перейдите на вкладку «Кастомные NPC» и возьмите «Создатель NPC» (smartnpc:npc_spawner).
  3. Нажмите ПКМ по любому блоку: в мире появится новый NPC (по умолчанию тип BOT) и откроется главное окно настройки gui_main.
  4. В верхней части правой панели нажмите кнопку типа ИИ (BOT / PLAYER / MOB), задайте имя, цвет ника (HEX или RGB-колесо), скин/плащ или кастомную 3D-модель, разложите броню и оружие в 41 слот инвентаря и нажмите зелёную галочку «Сохранить».
КомпонентТребуемая версия / путь
Minecraft / Loader1.21.5 / Fabric Loader 0.16.14+
Fabric API / Kotlin0.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/)
Примечание: Чтобы посмотреть инвентарь и характеристики существующего NPC без открытия полного редактора, нажмите по нему Shift + ПКМ предметом «Создатель NPC» — откроется окно Инспектора (gui_ScreenInspector).
1 / 18
Быстрый старт и Основы Start

Инструменты, горячие клавиши и команды

Полный справочник всех 8 предметов креатива, глобальных хоткеев и команд экономики.

#инструменты#хоткеи#Ctrl+N#Ctrl+G#J#/money

Весь функционал мода управляется внутри игры без ручного редактирования JSON-файлов. Каждый инструмент отвечает за свою подсистему мира, а глобальные редакторы открываются горячими клавишами.

  • /balance или /money — показать текущий баланс валюты (CR).
  • /money pay <игрок> <сумма> — перевести средства другому игроку.
  • /money add <игрок> <сумма> и /money set <игрок> <сумма> — выдача и установка баланса (требуется уровень прав OP 2).
Инструмент / КлавишаID / СочетаниеНазначение и управление
Создатель NPCsmartnpc: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, таймер деспавна, пул пресетов и шанс случайных игроков.
Инструмент POIsmartnpc:poi_wandПКМ по блоку — создать/настроить точку интереса (приоритеты паркура, ближнего и дальнего боя, длительность).
Глобальный редакторCtrl + NДвижение, Бой, Профессии, Фракции, Скрипты и Создатель Сущностей (3D-студия).
AI DebuggerCtrl + GТелеметрия PLAYER-NPC, 3D-путь, луч цели, FOV-конус, логи действий/причин, камера наблюдения и Follow.
Журнал странникаJТекущая фракция и повышение рангов, активные квесты, доска контрактов Bounty и 3D-трекер цели.
2 / 18
Быстрый старт и Основы Start

Главное окно NPC, слоты с шансами и пресеты

Трансформации, 41 слот экипировки, вероятностный лут в слотах и система яиц-пресетов.

#gui_main#шансы слотов#пресеты#трансформация#вселение

Левая панель главного меню gui_main едина для всех трёх типов ИИ (BOT, PLAYER, MOB) и позволяет гибко управлять внешностью, трансформацией, инвентарём и сохранением шаблонов.

  • Имя и цвет: поле имени до 16 символов, HEX-код цвета (6 символов), кнопка «Цвет» (RGB-колесо gui_ColorWheelModal) и тумблер отображения ника над головой.
  • Трансформация (gui_Transformation): ползунок размера от -10 до +10 (реальный масштаб вычисляется по формуле 2^(scale / 10)), точные координаты спавна X/Y/Z, углы Yaw/Pitch/HeadYaw. Для BOT доступна кнопка «Управление» — вселение в бота в режиме спектатора с сохранением итоговой позиции.
  • Внешность: кнопка 3D-модели выбирает кастомный .json из 3D-студии; при выбранной кастомной модели появляется кнопка настройки состояний анимаций (Idle/Walk/Sprint + время входа/выхода crossfade); для ванильной модели доступны выбор скина и плаща из папок mods/NPCs_mod/.
  • Инвентарь (41 слот): слоты 0–3 — броня (шлем, нагрудник, поножи, ботинки), слот 4 — левая рука (щит/тотем), слоты 5–13 — хотбар (слот 5 — основная рука), слоты 14–40 — внутренний рюкзак.
  • Шансы предметов в слотах (gui_SlotChance): нажмите ПКМ по любому слоту инвентаря NPC, чтобы добавить до 13 вариантов предметов с диапазоном количества (min/max) и весами (нормализуются к 100%). При спавне или применении пресета предмет разыгрывается случайно. Настроенный слот обводится зелёной рамкой.
  • 9 быстрых пресетов экипировки (кнопки 1–9 под инвентарём): ЛКМ применяет пресет инвентаря и шансов слотов, ПКМ переводит слот в режим редактирования и открывает кнопку «Сохранить Пресет».
  • Создать яйцо (для PLAYER и MOB): сохраняет полную конфигурацию NPC в NPC_mod/Presets/<id>.json. Последующее редактирование пресета автоматически обновляет все связанные сущности с этим presetId во всех загруженных измерениях.
3 / 18
Быстрый старт и Основы Start

Три типа ИИ: BOT, PLAYER и MOB

Когда выбирать каждый тип сущности и какие вкладки доступны в редакторе.

#BOT#PLAYER#MOB#GUARD#TRADER#BOSS

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-модель), способности, скорости, напрыгивание с проверкой пропастей, паттерны Осмотра/Сближения/Отступления и Скрипт.
4 / 18
Искусственный интеллект и Навигация 3-Layer AI

Трёхслойный мозг e_p_Brain и человеческая моторика

Как работает цикл тика PLAYER-NPC от рефлексов до квантования поворота мыши.

#e_p_Brain#e_p_Motor#exec_Look#exec_Mech#exec_Correction

У сущностей типа PLAYER полностью отключены ванильные MoveControl, LookControl и JumpControl. Вместо них каждый серверный тик работает конвейер e_p_Brain.tickPhysics(), который рассчитывает прямые вводы клавиатуры (inputForward, inputStrafe, inputSprint, inputSneak, inputJump) и передаёт их в e_p_Motor.

События урона, обнаружения врага, блокировки пути и столкновения с препятствием обрабатываются асинхронно через корутинный канал e_p_AiScope с последующим применением в основном серверном потоке.

  • Layer 3 (Реактивный уровень — высший приоритет): react_Water (экстренное плавание к берегу, постановка и вождение лодки с подбором на суше), react_Eating (еда при голоде и золотое яблоко при HP < 55% в бою) и react_Targeting (зрение по FOV/дальности, проверка PVP/SafeZone, фракций, Bounty и чёрный список недосягаемой цели на 5 сек).
  • Layer 2 (Тактический уровень): граф поведения Graph_BehaviorRunner распределяет время между активными модулями движения или боя с учётом занятых каналов (MOVEMENT_VECTOR, LOOK_TARGET, ACTION_ANIMATION).
  • Layer 1 (Исполнительный уровень): exec_Correction (выпрыг из паутины, тушение огня рядом, коррекция полёта в паркуре, уступание дороги другим NPC и страховка от обрыва), exec_Mech (открытие дверей, калиток, люков, нажатие кнопок/рычагов и выход на нажимные плиты перед железными дверями) и exec_Look.
  • Моторика exec_Look: критическое демпфирование 0.82, ограничение поворота 400° за 20 тиков, квантование шага мыши 0.25°, микротремор кисти через таблицу SIN_LUT (1024 слота) и 16-тиковый кольцевой буфер задержки реакции с перерегулированием (overshoot) при резкой смене направления врага.
Примечание: Для экономии ресурсов сервера NPC с типом PLAYER переходят в спящий режим, если вокруг нет отслеживающих игроков (observingPlayersCount == 0) и не активен режим Follow.
5 / 18
Искусственный интеллект и Навигация 3-Layer AI

Граф поведения (Ctrl + N): Движение и Бой

Настройка весов, синергии, переходов и внутренних свойств всех 20 модулей поведения.

#Ctrl+N#Graph_Config#синергия#модули движения#модули боя

Нажмите 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 (удержание паутины на дистанции).
Примечание: Параметр «Макс. модулей в синергии» (1–6) в верхней панели ограничивает, сколько модулей с непересекающимися каналами могут работать одновременно.
6 / 18
Искусственный интеллект и Навигация 3-Layer AI

Боевая система и Самоанализ (SA_SelfAnalysis)

W-Tap, автокрафт в бою, 9D-фильтр Калмана, цепи Маркова, Thompson Sampling и тепловые карты.

#PVP#Kalman 9D#Markov#Thompson Sampling#Heatmap#Crafting

Боевой контроллер comb_Combat реализует ключевые механики современного Minecraft PVP: точный тайминг ударов по атрибуту ATTACK_SPEED, криты в фазе падения (Δy < -0.001), W-Tap и S-Tap сброс спринта, Jump-Reset при получении урона, автоматическую экипировку тотема бессмертия в левую руку, отключение щита топором на 100 тиков, взрывные зелья лечения/урона и Boids-разделение союзников.

Если для тактики не хватает предмета (удочки, лука, огнива, лодки или верстака), Crafting_Manager автоматически крафтит его из досок, брёвен, палок, нитей, кремня и железа прямо из инвентаря NPC.

  • KinematicKalman3D: 9-мерный фильтр Калмана [pos, vel, acc] с затуханием сопротивления воздуха 0.98^Δt и итеративным баллистическим расчётом точки перехвата для стрел и зелий.
  • OpponentMarkovTracker: марковская цепь 2-го порядка по 8 состояниям противника (IDLE, SPRINT_APPROACH, JUMP_CRIT, SHIELD_HOLD, STRAFE_ORBIT, RANGED_DRAW, EATING_HEAL, RETREAT_FLEE) с оценкой энтропии предсказуемости.
  • OnlineStrafeClusterTracker: анализирует частоту и ритм стрейфов соперника для упреждения.
  • Контекстный бандит Thompson Sampling (Beta(α, β) + UCB): по 7 контекстам дистанции и преимущества (CombatContextBin) бот запоминает эффективность каждой тактики против конкретного UUID игрока и делится знаниями через globalTargetKnowledge (до 512 профилей).
  • SA_TacticalHeatmap: записывает успешные и провальные точки с гауссовым ядром (σ² = 9), ищет высокие уступы для AERIAL_AMBUSH и динамически помечает зоны вокруг криперов и монстров как опасные.
7 / 18
Искусственный интеллект и Навигация 3-Layer AI

3D A* Паркур и AI Debugger (Ctrl + G)

Двухуровневый поиск пути, обучение на срывах и визуальная отладка поведения в реальном времени.

#pathfinder_Advanced#pathfinder_Fast#паркур#AI Debugger#Ctrl+G

Навигация 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, который запоминает неудачные прыжки и повышает штраф проблемного ребра.

  1. Нажмите Ctrl + G, чтобы открыть AI Debugger (debug_Screen) и выберите любого PLAYER-NPC в радиусе 64 блоков из списка слева.
  2. В правой панели включите нужные 3D-слои: 3D Path (маршрут с цветовой кодировкой ходьбы, прыжков, спринт-прыжков, плавания и лестниц), Target Ray (луч цели), Tactics 3D (точки отступления и уступы засады), FOV & Dist (конус зрения).
  3. Используйте кнопку Follow: ON, чтобы бот следовал за вами, Camera: ON — чтобы вселиться в камеру NPC с отображением его хотбара и тактики на HUD, или «Редакт. NPC» для мгновенного перехода в gui_main.
  4. Фильтруйте нижние журналы по уровням ALL / COMBAT / CORRECT / PATH: верхняя панель показывает действия NPC с привязкой [#ID], нижняя — причины принятия решений.
8 / 18
3D-Студия, Текстуры и Анимации OpenGL 4.3

Моделирование и импорт Bedrock (.geo.json)

Создание иерархических моделей костей, 12 встроенных шаблонов и назначение модели на NPC.

#EntityBuilder#Bedrock#.geo.json#ModelNode#шаблоны

Откройте глобальный редактор (Ctrl + N) и нажмите кнопку «Создатель Сущностей» в правом верхнем углу. Редактор сохраняет проекты в config/smartnpc/custom_entities/<id>.json без перезапуска клиента.

В выпадающем списке «Сущность» доступны 12 готовых шаблонов с настроенными костями и анимациями: Стив, Зомби, Скелет, Крипер, Свинья, Житель, Слизень, Эндермен, Дракон Края, Снеговик, Древняя Чупакабра (10 голов, 15 рук, 10 ног) и Демон Прибежища.

  1. Выберите шаблон за основу или загрузите существующий проект. Для импорта внешней модели Minecraft Bedrock положите файл <имя>.geo.json в папку config/smartnpc/custom_entities/ — парсер BedrockGeometryParser автоматически преобразует кости, кубы, UV и роли костей (BoneRole) в формат студии.
  2. На вкладке «Моделлирование» добавляйте примитивы (Куб, Цилиндр, Конус) с нижней панели. Чтобы прикрепить новый узел к конкретной грани родителя, включите режим «Привязки» и кликните по красной точке-якорю в 3D-вьюпорте.
  3. Перетаскивайте узлы в дереве костей слева или соединяйте их линией для изменения иерархии «родитель → потомок». В 3D-вьюпорте двигайте, вращайте и масштабируйте выбранный узел за оси гизмо, справа настройте имя и фаску (bevel).
  4. Нажмите зелёную кнопку сохранения (галочка), введите имя сущности и сохраните .json. После этого откройте любого NPC через «Создатель NPC», нажмите синюю иконку модели на левой панели и выберите вашу сущность.
9 / 18
3D-Студия, Текстуры и Анимации OpenGL 4.3

Текстурирование: 3D Raycast-кисть, слои и АвтоUV

Рисование прямо по граням 3D-модели, упаковщик RizomMaxRectsBinPacker и запекание PNG.

#TextureStudio#Raycast#RizomMaxRectsBinPacker#UV#слои

Вкладка «Текстурирование» (gui_TextureStudioScreen) содержит три подрежима: «Редактор UV», «Рисование» и «Наложение», а также переключатель разрешения атласа (16×16, 32×32, 64×64, 128×128, 256×256, 512×512) и кнопку «UV» для переключения между 3D-видом и 2D-развёрткой.

  1. На подвкладке «Редактор UV» нажмите «АвтоUV» — упаковщик RizomMaxRectsBinPacker подберёт оптимальную раскладку островов всех кубов (при нехватке места разрешение автоматически увеличится вплоть до 512×512). Нажмите «Запечь UV», чтобы перенести уже нарисованные пиксели на новые координаты.
  2. Перейдите в «Рисование». Наведите курсор на 3D-модель: отобразится 3D-кольцо кисти и нормаль грани. Зажмите ЛКМ для непрерывного рисования по модели (луч raycastModel переводит попадание в точные пиксели U/V и проводит линию Брезенхэма без разрывов).
  3. Настройте цвет через HEX или RGB-колесо (клик по квадратику цвета), размер кисти (1–32 px), интенсивность (1–100%) и управляйте стеком слоёв (+/-, режимы наложения NORMAL, MULTIPLY, SCREEN, ADD, OVERLAY).
  4. Нажмите «Запечь текстуры» — итоговое изображение сохранится в config/smartnpc/custom_entities/textures/<id>.png и закодируется в Base64 внутри файла проекта.
10 / 18
3D-Студия, Текстуры и Анимации OpenGL 4.3

Студия анимаций, GPU Compute (OpenGL 4.3) и IK

Таймлайн, кривые интерполяции, SSBO на 2048 костей, процедурные роли и crossfade состояний.

#AnimationStudio#OpenGL 4.3#SSBO#Catmull-Rom#Crossfade#IK

Вкладка «Анимирование» (gui_AnimationStudioScreen) позволяет создавать неограниченное число треков (idle, walk, sprint, attack, roar и др.) и настраивать плавные переходы между ними.

  • Управление студией: кнопки T / R / S переключают гизмо (перемещение, вращение, масштаб); Space запускает/останавливает воспроизведение; Ctrl + Z / Ctrl + Y — отмена/повтор до 50 действий; Auto-Keyframe автоматически создаёт ключ на текущем кадре при изменении кости.
  • Интерполяция ключевых кадров: Линейная (LINEAR), Плавная сплайновая (CATMULL_ROM), Безье (BEZIER) и Ступенчатая (STEP). Ключи можно перетаскивать по шкале таймлайна, копировать и масштабировать по длительности трека.
  • GPU Compute скиннинг (OpenGL 4.3): матрицы иерархии до 2048 костей (40 float на кость) вычисляются на видеокарте через SSBO Compute Shader с минимальной нагрузкой на CPU.
  • Процедурные роли костей (BoneRole) и Two-Bone IK: кости головы автоматически отслеживают взгляд на цель, а конечности с включённым IK адаптируются к неровностям рельефа.
  • Плавный Crossfade состояний: в gui_main для кастомной модели назначаются треки Idle, Walk и Sprint с индивидуальным временем плавного входа и выхода между анимациями.
Примечание: Готовые анимации сохраняются в config/smartnpc/animations/ и сразу доступны для назначения в главном окне NPC и узлах кинематографических диалогов без перезапуска игры.
11 / 18
Мир, Фракции, Диалоги и Зоны World & RP

Кинематографические диалоги

Создание ветвящихся графов диалогов, 12 ракурсов камеры и игровые действия.

#диалоги#камера#CameraShotType#DialogueActionType#BOT

Система диалогов привязывается к сущностям типа BOT на вкладке «Диалог» в gui_main. Файлы графов сохраняются в saves/<Мир>/NPC_mod/dialogues/<dialogueId>.json и могут переиспользоваться на нескольких ботах.

  1. Откройте бота инструментом «Создатель NPC», перейдите во вкладку «Диалог», включите тумблер «Диалог: ВКЛ» и задайте уникальный ID диалога.
  2. В левом нижнем углу холста выберите тип создаваемого узла и кликните по свободному месту (минимальная дистанция между узлами — 42 px): Круг (CIRCLE — реплики NPC), Квадрат (SQUARE — квестовый узел), Треугольник (TRIANGLE — автоматическое действие).
  3. Для соединения узлов зажмите кнопку мыши в голубой точке в центре исходного узла и протяните линию к целевому узлу. Клик по кружку в середине линии открывает настройки варианта ответа игрока; ПКМ по холсту с панорамированием двигает рабочую область.
  4. В правой всплывающей панели для узла-реплики добавьте одну или несколько последовательных реплик (+/-), выберите ракурс камеры (12 режимов CameraShotType, включая AUTOMATIC, OVER_SHOULDER_NPC, WIDE_TWO_SHOT, CINEMATIC_ORBIT), FOV (30–110°) и анимацию позы, затем нажмите «Сохранить».
  • Доступные действия вариантов ответа и треугольных узлов: NONE, CLOSE, GIVE_MONEY, TAKE_MONEY, OPEN_TRADER, START_COMBAT, SET_JOB, START_QUEST, JOIN_FACTION.
  • Во время разговора клиент плавно интерполирует камеру с проверкой коллизий об блоки (клиппинг), скрывает ванильный HUD и блокирует движение игрока. Через 10 секунд бездействия (200 тиков) камера переключается на крупный план игрока.
  • Если бот отмечен как «Лидер фракции», ПКМ по нему приоритетно запускает вступление во фракцию.
12 / 18
Мир, Фракции, Диалоги и Зоны World & RP

Торговцы, Стражи и Интерактивное окружение

Настройка 360 торговых слотов, боевой охраны с поводком и расписания объектов бота.

#TRADER#GUARD#m_b_environment#лимиты#скупка

Боты (entity_NPC_Bot) могут выполнять роль торговца, стража или жителя, взаимодействующего с блоками и сущностями в городе.

  • Торговец (Роль: TRADER): до 4 настраиваемых вкладок (имя + иконка) по 90 слотов (5×18). Положите предмет в слот ЛКМ (копируется из курсора) и нажмите ПКМ по слоту, чтобы открыть gui_TraderOffer: цена в CR, бартерный предмет, режим скупки торговцем, ограничение числа сделок (1–100) и время сброса лимита (1–1440 мин). В окне торговли ЛКМ покупает/продаёт 1 шт., ПКМ — целый стак.
  • Фракции и розыск в торговле: торговец враждебной фракции отказывает в сделке, а для разыскиваемых игроков (Bounty) автоматически применяется наценка merchantWantedPriceMarkupPercent из глобальных настроек фракций.
  • Страж (Роль: GUARD): задайте «Точку охраны» и «Радиус охраны» (4–64 бл.), выберите целевых мобов из списка (плюс автоматическая агрессия на враждебные фракции) и настройте для каждого типа моба агрессию, дистанцию боя, порог бегства, кайт из лука, прыжки и тактический отход. Страж сам меняет лук и лучшее оружие ближнего боя.
  • Окружение (Настройщик взаимодействия): выберите бота ПКМ, привяжите нужные кровати, сундуки, верстаки, печи, наковальни, колокола, рычаги, двери или сущности. Бот будет вероятностно переходить между ними с учётом весов, дистанции и штрафа за недавний визит — ложиться в кровати, звонить в колокол и имитировать работу.
13 / 18
Мир, Фракции, Диалоги и Зоны World & RP

Квесты, Фракции, Профессии и Bounty

Экономика, иерархия рангов с налогами, карательные патрули и глобальная охота за головами.

#квесты#фракции#профессии#Bounty#RetributionManager

Квесты, фракции, профессии и система розыска работают как единая RPG-экосистема, настраиваемая через Ctrl + N и Инструмент квестов.

  • Квесты (quest_Manager): каждый этап (QuestNode) имеет заголовок, описание, таймер (0–600 сек), триггер (MANUAL, LOCATION_ENTER, TIME_OF_DAY, KILL_MOB), координаты точки, окно времени суток и опциональную спавн-зону этапа. Включение «Режима Лобби» приостанавливает спавн обычных PLAYER-NPC в спавн-зонах на время прохождения квеста.
  • Фракции (Ctrl + N → Фракции): поддерживают название, описание, PNG/JPG-иконку 16×16 (рисуется над головами враждебных бойцов в 3D), враждебные фракции, шанс спавна NPC, условия рекрутирования, ветвящийся граф рангов с налогами (списываются каждые 24 000 тиков — при неуплате игрок исключается), штрафами за выход, наградами за убийство врагов и подкреплениями (FactionReinforcementUnit).
  • Профессии (выбор через кнопку на HUD при открытом чате, настройка в Ctrl + N → Профессии): Шахтёр (руды, камень, крафт из камня), Дровосек (брёвна, крафт из дерева), Ведьмак (убийство мобов), Киллер (убийство игроков и NPC-игроков). Уровень растёт по степенной кривой baseXp * (lvl - 1)^exponent и увеличивает денежные и XP-награды.
  • Возмездие и Bounty: убийство мирного игрока или PLAYER-NPC вне PVP-зоны накладывает штраф на 300 сек (RetributionManager) и периодически призывает карательный патруль. Предательство/дезертирство из фракции, случайные контракты гильдий или срабатывание «Горящей жопы» (rageBountyRate) убитого NPC-игрока создают контракт Bounty с глобальным баннером. Откройте Журнал (J) → «Награды за голову» → «Отслеживать цель», чтобы материализовать NPC-цель и включить 3D-маркер расстояния на HUD.
14 / 18
Мир, Фракции, Диалоги и Зоны World & RP

Полигональные зоны: PVP, SafeZone, Spawn и POI

Разметка территорий любой формы, дресс-код, управление популяцией и точки интереса.

#PVP-зона#SafeZone#SpawnZone#POI#дресс-код

Зоны в 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 по своему снаряжению.
15 / 18
Скриптинг (.java / .kts) Javac JIT

Как работают скрипты: глобальные, локальные и JIT

От написания в редакторе Ctrl + N до исполнения в памяти сервера.

#скрипты#JavacTool#global_#DSL#gui_ScriptEditorScreen

Скрипты хранятся в папке мира saves/<Мир>/NPC_mod/Scripts/ с расширением .java (также поддерживается чтение .kts). Встроенный редактор открывается через Ctrl + N → «Скрипты» или через кнопку «Открыть Java Script Editor» на вкладке </> у любого бота/моба.

При первом запуске или изменении файла движок script_BytecodeCompiler оборачивает ваш код в класс CompiledScriptExecutable и компилирует его прямо в оперативной памяти через системный JavacTool (Java 21) в изолированный ScopedScriptClassLoader. Если сервер работает на JRE без компилятора JDK или в коде использован упрощённый синтаксис DSL, автоматически срабатывает встроенный DSL-интерпретатор.

  1. Откройте редактор скриптов (Ctrl + N → «Скрипты») и нажмите «+ Скрипт» в левом нижнем углу.
  2. Задайте имя файла в поле «Имя .java:». Если имя начинается с префикса global_ (например, global_night_bandits), сервер будет запускать скрипт автоматически каждые 40 тиков в Overworld (с автокулдауном 6000 тиков после успешного срабатывания).
  3. Для локального события используйте имя без префикса global_ (например, bandit_raid) и привяжите его к конкретному BOT или MOB на вкладке </> в gui_main — такой скрипт вызывается раз в 20 тиков (раз в секунду).
  4. Вставляйте готовые вызовы из панели «API МЕТОДОВ» или «ШАБЛОНЫ» справа, используйте Ctrl + A/C/X/V и выделение мышью. Нажмите «▶ Тест», чтобы сохранить скрипт и немедленно выполнить его от вашего имени.
Примечание: Если скрипт должен прерваться и не сработать (например, не то время суток или идёт кулдаун), верните return false; — это сообщит движку не обновлять глобальный таймер автозапуска.
16 / 18
Скриптинг (.java / .kts) Javac JIT

Справочник переменных и методов Script API

Полный список объектов bridge, world, npc, player и target, доступных внутри скрипта.

#bridge#world#npc#player#target#API

При компиляции скрипта в тело метода 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, вызвавшего игрока или текущей цели.
17 / 18
Скриптинг (.java / .kts) Javac JIT

Готовые примеры скриптов

Рабочие сценарии ночного рейда, отложенного салюта и боссовой фазы лечения.

#примеры#рейд#салют#босс#schedule

Ниже приведены проверенные шаблоны, которые можно напрямую вставить в редактор скриптов и адаптировать под ваши пресеты из NPC_mod/Presets/.

  • Для боссового скрипта (привяжите к entity_NPC_Mob без префикса global_): проверяйте if (npc.getHealth() > npc.getMaxHealth() * 0.4f) return false;, затем вызывайте bridge.cooldown("phase2", 1800L), npc.heal(25.0f), npc.addEffect("minecraft:strength", 400, 1) и bridge.spawnBanditHorde("reinf_preset_1", 2, 12.0).
  • Любой свой скрипт можно сохранить в библиотеку шаблонов кнопкой «+ Сохранить шаблон» в правой нижней панели редактора.
global_night_bandits.java (Глобальный ночной рейд с проверкой лимита)
// Срабатывает только ночью (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;
18 / 18