interactEntity

Turn any mob into a fully scripted NPC with branching dialogues, quests, and conditions, all through simple JSON files, no coding required

Quick challenge

How far can you run before the mobs catch you?

interactEntity

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 - 🎨 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

```json { "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 - Client + Server (mod must be on both sides)

---

🇷🇺 Русский

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

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

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

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

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

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