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

1. Drop the .jar into mods/
2. Launch — folder interactentity/dialogues/ is created
3. Add a JSON file describing the dialogue
4. /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)
• 🌐 Мультиплеер — общий прогресс на сервере

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

1. Кинь .jar в mods/
2. Запусти — создастся папка interactentity/dialogues/
3. Добавь JSON-файл с диалогом
4. /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 (обязательная зависимость!)
• Клиент + Сервер (мод нужен с обеих сторон)