InteractEntity

Turn any mob into a fully scripted NPC. Branching dialogues, quests, conditional choices and story chains, all through simple JSON files. No Java required.

✨ Features

💬 Branching dialogues with options and visibility conditions
📜 Quest system with HUD tracker and journal (J to open)
🔗 Multi-NPC story chains — one NPC's actions trigger another
🎭 30+ conditions: items, health, time, weather, biome, kills, variables, visited nodes
⚡ 30+ actions: give items, run commands, teleport, particles, sounds, camera shake, effects
🧙 Auto-spawn — NPCs appear on world join, after a dialogue, or when a player enters an area
🎨 Dynamic skin loader (put custom elsa.png/harold.png or player skins directly in config/interactentity/skins/ without rebuilds!), custom avatars, backgrounds and color codes (&a, hex &#FF6600)
🌐 Multiplayer-ready — shared progress across the server

📦 Quick start

Drop the .jar into mods/
Launch — folder interactentity/dialogues/ is created
Add a JSON file describing the dialogue
/npc spawn <id> in-game — right-click to talk

{
  "target": { "name": "Old Zombie", "tag": "old_zombie" },
  "entry": "start",
  "nodes": {
    "start": { "text": "&fHello, traveler...", "next": "end" },
    "end":   { "text": "&7*The zombie falls silent*" }
  }
}

📚 Full documentation

All actions, conditions, examples, GUI customization, multi-NPC story chains — in the full README on GitHub (English + Русский).

🛠️ Requirements

Minecraft 1.20.1 + Forge
GeckoLib (mandatory dependency!)
Client + Server (mod must be on both sides)

🇷🇺 Русский

Превратите любого моба в полноценного NPC. Ветвящиеся диалоги, квесты, условия и цепочки сюжетов — всё через простые JSON-файлы. Без Java и плагинов.

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

💬 Ветвящиеся диалоги с вариантами ответа и условиями видимости кнопок
📜 Система квестов — HUD-трекер и журнал (J чтобы открыть)
🔗 Цепочки NPC — действия одного запускают другого
🎭 30+ условий: предметы, здоровье, время, погода, биом, убийства, переменные, посещённые узлы
⚡ 30+ действий: выдать предмет, команда, телепорт, частицы, звук, тряска камеры, эффекты
🧙 Автоспавн — NPC появляется при заходе в мир, после диалога или при входе в зону
🎨 Загрузчик динамических скинов (загружайте кастомные .png скины или скины игроков напрямую в папку config/interactentity/skins/ без пересборки мода!), кастомные аватары, фоны и цветовые коды (&a, hex &#FF6600)
🌐 Мультиплеер — общий прогресс на сервере

📦 Быстрый старт

Кинь .jar в mods/
Запусти — создастся папка interactentity/dialogues/
Добавь JSON-файл с диалогом
/npc spawn <id> в игре — ПКМ для разговора

{
  "target": { "name": "Старый Зомби", "tag": "old_zombie" },
  "entry": "start",
  "nodes": {
    "start": { "text": "&fПривет, путник...", "next": "end" },
    "end":   { "text": "&7*Зомби замолкает*" }
  }
}

📚 Полная документация

Все действия, условия, примеры, кастомизация GUI, сюжетные цепочки NPC — в полном README на GitHub (English + Русский).

🛠️ Требования

Minecraft 1.20.1 + Forge
GeckoLib (обязательная зависимость!)
Клиент + Сервер (мод нужен с обеих сторон)

interactEntity