NPC Dialog

Create interactive NPC conversations in your Hytale world. Press F to open custom multi-page dialogs with navigation, persistent storage, command execution, custom button text, forced story progression, and entity state controls.

6.6 тысяч загрузок

Обновлён 9 дней назад

Геймплей Улучшение Качества Жизни Утилиты Разное

Скриншоты

Описание

Диалог NPC

Сервер поддержки - https://discord.gg/DRxwt8Qg2W

Мощная и интуитивно понятная диалоговая система NPC для серверов Hytale, которая позволяет создавать интерактивные разговоры с любым субъектом в вашем мире.

Версия [1.2.0] - 2026-01-17 Живи!

Описание

NPC Dialog - это комплексный плагин, который позволяет администраторам серверов создавать богатые многостраничные диалоговые системы для любого объекта в их мире Hytale. Игроки могут взаимодействовать с NPC, нажимая F, открывая красивый пользовательский интерфейс, который отображает разговоры с навигацией между несколькими страницами.

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

Дополнительные случаи использования

NPC Диалог не ограничивается сюжетными или квестовыми NPC — он также может использоваться в качестве информационной системы общего назначения для вашего сервера:

- Help & Tutorial NPCs - отображение информации в интерактивном, читаемом пользовательском интерфейсе

Серверные правила NPC - позволяют игрокам читать правила сервера по страницам вместо спама

Руководства и советы - Объясните механику сервера, ранги или пользовательские функции

- New Player Onboarding - Создание пошаговых представлений для новых игроков

Информационные центры - центральные NPC для часто задаваемых вопросов, команд или объявлений

Особенности

Основная функциональность

Интерактивная система NPC - Связывайте диалоговые разговоры с любой организацией в вашем мире

Замороженное состояние (субъекты не могут перемещаться)

Невраждебное состояние (сущности не могут атаковать)

Неуязвимое состояние (субъекты не могут получить ущерб)

- Выбор простаивающей анимации с прокручиваемым списком анимации, отображающим все доступные анимации для каждой модели сущности

Пользовательский текст подсказки взаимодействия (например, «Press F to open Large Tavern Chest»)

- Многостраничные диалоги - создание ветвящихся разговоров с несколькими страницами

- Пользовательские кнопки - Две полностью настраиваемые кнопки (Custom Button 1 и Custom Button 2) в диалоговом интерфейсе плеера, расположенном над кнопками навигации

Разметка текста в Диалогах для жирного, курсивного, цветного и монопространства в имени NPC, названии диалога и диалоговом контенте: «{b}», «{i}», «{m}», «{#RRGGBB}» или «{#RGB}» и «{/}» до конца. Пример: 'Hello {b}bold{/} and {#ff0000}red{/} text. пункт

- Взаимодействие с игроками - игроки нажимают F для взаимодействия со связанными объектами

- Устойчивое хранение - все данные NPC сохраняются в формате JSON и сохраняются при перезагрузке сервера

Автоматическое восстановление - Взаимодействия автоматически восстанавливаются при перезагрузке сервера или при загрузке объектов

- Поддержка разрешений - Требуется разрешение npcdialog.admin на использование команд администратора (совместимо с LuckPerms)

- Миграция данных - папка данных плагина изменилась с _NPC Dialog на Hyronix_NPC Диалог с автоматической миграцией при первом запуске

Пользовательский интерфейс

Панель администратора - красивый, интуитивно понятный графический интерфейс для создания и управления NPC и страницами диалога

Создание новых NPC с пользовательскими именами и названиями

Редактировать существующие NPC и их свойства

Добавить несколько диалоговых страниц в NPC

Связать NPC с объектами, выбрав их в мире

Удалите NPC и автоматически удалите их взаимодействия.

- Выпадение выбора страницы для легкого редактирования

Настройка следующего текста кнопки для каждой страницы

Настройка текста предыдущей кнопки для каждой страницы

Настройка текста кнопки Close для каждой страницы

Установите выполнение команд для кнопок Next и Close

- Опция «Предотвратить закрытие до последней страницы»

Включить / отключить предыдущую видимость кнопки на странице

- Включить/отключить пользовательскую кнопку 1 и пользовательскую кнопку 2 на страницу

Настройка пользовательской кнопки 1 и пользовательской кнопки 2 текст и команды

- Состояния объекта Toggle непосредственно из пользовательского интерфейса администратора (замороженная, невраждебная, неуязвимая, праздная анимация)

- Idle Animation Selection - Список прокручиваемой анимации, показывающий все доступные анимации для модели выбранного объекта, с выделением выделения

- Установите пользовательский текст подсказки взаимодействия для каждого NPC

- Улучшенный макет и поведение прокрутки для лучшего удобства использования

Player Dialog UI - чистый, читаемый интерфейс для игроков

Название и название NPC Centered

Прокручиваемый многолинейный диалоговый контент

Две настраиваемые кнопки (Custom Button 1 и Custom Button 2), расположенные над навигационными кнопками

- Навигационные кнопки (предыдущие/следующие) для многостраничных разговоров

Настраиваемая кнопка (Previous, Next, Close, Custom Button 1, Custom Button 2)

Кнопка закрытия (может быть скрыта до последней страницы)

Расширенные возможности

- Command Execution System - выполнение команд сервера при взаимодействии игроков с диалоговыми кнопками

Следующая кнопка Команда: Запускайте команды, когда игроки нажимают кнопку «Далее» (например, /help)

Близкая кнопка Запуск команд, когда игроки закрывают диалог (например, /spawn, /warp spawn)

Пользовательская кнопка 1 Командование: Выполняйте команды, когда игроки нажимают кнопку 1

Пользовательская кнопка 2 Командование: Выполняйте команды, когда игроки нажимают кнопку 2

- Командные селекторы: Поддержка селекторов @p и @s в командах

@p = ближайший игрок (ближайший игрок к точке выполнения команды) - автоматически заменяется игроком, который нажал кнопку

- @s = self (сущность, выполняющая команду) - автоматически заменяется игроком, который нажал кнопку

Оба селектора заменены именем игрока, поэтому они работают одинаково в этом контексте.

- Пример: "Give @p Plant_Fruit_Apple --quantity=1" даст элемент игроку, который нажал кнопку

- Административные команды: Команды типа /give, /tp, /effect, /summon и т.д. автоматически выполняются в качестве консоли для соответствующих разрешений.

Игровые команды: Регулярные команды выполняются как игрок, который нажал кнопку

- Конфигурационные файлы:

- playerPermissionCommands.json - Карты исполняемых игроком команд к узлам разрешения. Командные команды, перечисленные здесь, будут иметь разрешения, временно предоставленные через LuckPerms при выполнении, что позволит игрокам использовать ограниченные команды через взаимодействия NPC.

- consoleCommands.json - Определяет команды, которые должны выполняться в качестве консоли (в обход разрешений игрока). Команды в этом списке будут работать с полными разрешениями консоли при запуске через кнопки NPC, полезные для команд администратора, таких как «/give», «/tp» и т. Д.

Пользовательская кнопка Текст - Измените текст кнопки «Предыдущее», «Далее», «Близко», «Таможенная кнопка 1» и «Таможенная кнопка 2» на все, что вы хотите (например, «Продолжить», «Принять квест», «Перейти вперед»).

- Подсказки пользовательского взаимодействия - Установите пользовательский текст подсказки взаимодействия, который появляется, когда игроки смотрят на связанные объекты (например, «Press F to open Large Tavern Chest»).

Заставьте игроков читать все диалоговые страницы, прежде чем они смогут закрыть диалог (идеально подходит для серверов и учебных пособий, основанных на истории)

Включите / отключите предыдущую кнопку - Контролируйте, появляется ли предыдущая кнопка на каждой странице (полезно для линейной прогрессии истории, когда вы не хотите, чтобы игроки возвращались)

- Кнопки Enable/Disable Custom Toggle Custom Button 1 и Custom Button 2 видимость на странице

- Entity State Management - Toggle entity states (Frozen, Non-hostile, Invulnerable, Idle Animation)

- Idle Animation Selection - Выберите конкретные простаивающие анимации из прокручиваемого списка, показывающего все доступные анимации для каждой модели объекта

Multi-Line Content - поддержка длинного диалогового текста с автоматической прокруткой

- Entity Linking - диалоги ссылок с любым существующим объектом, использующим внутриигровой выбор

Кросс-мировая поддержка - работает на вашем сервере во всех мирах

Умное управление взаимодействием - автоматически добавляет / удаляет компоненты взаимодействия

Безопасное удаление - правильно очищает взаимодействия при удалении NPC

Предотвращение ошибок - Предотвращение сбоев при взаимодействии с удаленными NPC

командование

| /npcdialog Открывает GUI администратора для управления NPC и диалогами | Требует npcdialog. Разрешение администратора.

Руководство по использованию

Создание диалога NPC

1. Открытый администратор Панель: Запуск /npcdialog в игре (требуется разрешение npcdialog.admin)

2.Создать NPC:

Введите имя NPC в поле «Имя NPC»

Введите заголовок (факультативно) в поле «NPC Title»

- Установите пользовательский текст подсказки взаимодействия (необязательно, например, «Press F to open Large Tavern Chest»)

Нажмите «Создать NPC»

3. Добавить Диалоговый контент:

Введите диалоговый текст в поле «Диалоговый контент» (поддерживает несколько строк).

- Опционально настроить «Next Button Text» (по умолчанию — «Next»)

- Опционально настроить «Предыдущий текст кнопки» (по умолчанию до «Предыдущего»)

- Опционально настроить «Текст с закрытой кнопкой» (по умолчанию «Закрыть»)

- Дополнительно добавьте «Next Button Command», чтобы выполнить, когда игроки нажимают «Далее».

- Вы можете использовать селекторы @p или @s в командах (например, «дать @p Plant_Fruit_Apple --quantity=1»).

- @p и @s автоматически заменяются именем игрока, нажавшего кнопку

- Дополнительно добавьте команду «Закрыть кнопку», чтобы выполнить, когда игроки закроют диалог.

- Вы можете использовать селекторы @p или @s в командах (например, «tp @p 100 64 200»).

Команды администратора (Give, Tp, Effect и т.д.) автоматически выполняются в качестве консоли для соответствующих разрешений.

- Включить/отключить пользовательскую кнопку 1 и пользовательскую кнопку 2

Настройка пользовательской кнопки 1 и пользовательской кнопки 2 текст и команды

Переключите «Предотвратить закрытие до последней страницы», если вы хотите заставить игроков читать все страницы

Переключатель «Показать предыдущую кнопку в диалоге» для включения / отключения предыдущей кнопки

Нажмите «Сохранить NPC», чтобы сохранить первую страницу

4. Настройка штатов организации (факультативно):

- Переключатель "Замороженный", чтобы предотвратить движение объекта

- Переключите «Не враждебный» для предотвращения атаки объекта

- Переключатель «Неуязвимые», чтобы предотвратить получение организацией ущерба

- Toggle "Idle Animation", чтобы включить праздную анимацию

Выберите конкретную простаивающую анимацию из прокручиваемого списка анимации (показывает все доступные анимации для выбранной модели объекта)

5. Ссылка на организацию:

Выберите объект, который вы хотите связать в списке объекта (левая панель)

- Субъект будет автоматически связан с выбранным вами NPC.

6. Добавить больше страниц (необязательно):

Выберите страницу, которую вы хотите отредактировать, из выпадающего раздела «Выбрать страницу»

Добавление новых страниц с помощью кнопки «Добавить страницу»

Используйте предыдущие / последующие кнопки в пользовательском интерфейсе игрока для навигации между страницами

Взаимодействие игроков

Игроки просто смотрят на связанную сущность и нажимают F для взаимодействия.

- Пользовательский текст подсказки взаимодействия (если установлен) появится при взгляде на объект

- Открывается диалоговый интерфейс, показывающий имя, название и разговор NPC.

Игроки могут использовать пользовательские кнопки 1 и пользовательские кнопки 2 (если они включены), расположенные над кнопками навигации.

Игроки могут перемещаться между страницами с помощью кнопок «Предыдущее/следующее» (с настраиваемым текстом при настройке)

Если включена «Предотвратить закрытие до последней страницы», игроки должны добраться до последней страницы, прежде чем они смогут закрыть диалог.

Команды, настроенные для кнопок Next/Close/Custom, будут выполняться автоматически при нажатии

Пример использования Cases

Обсуждение Quest Giver NPC

Создание многостраничного введения квеста

Используйте «Предотвратить закрытие до последней страницы», чтобы игроки прочитали полный квест.

Настройте Next Button Command, чтобы «принять квест» на последней странице (не используйте «/»).

- Или используйте "дать @p Quest_Item_1 -quantity=1" для предоставления элементов квеста при принятии

Настройка следующего текста кнопки «Принять квест»

- Используйте настраиваемую кнопку 1 для «Просмотр наград» с командой для отображения информации о вознаграждении

- Настройка пользовательского взаимодействия подсказка: «Нажмите F, чтобы принять квест»

Учебник NPC

- Создание пошаговых обучающих страниц

Отключить предыдущую кнопку, чтобы заставить линейную прогрессию

- Используйте выполнение команд для телепортации игроков или передачи предметов на определенных этапах.

Пример: «tp @p 100 64 200» для телепортации игрока, нажавшего кнопку

- Пример: "Give @p Tutorial_Book --quantity=1" для передачи элементов игроку

- Используйте пользовательскую кнопку 1 для опции «Skip Tutorial»

- Предотвратить закрытие до завершения учебного пособия

- Позволяет заморозить состояние, чтобы сохранить учебник NPC на месте

- Выберите конкретную простаивающую анимацию из списка анимации

Информация NPC

Создание страниц правил FAQ или сервера

Разрешить игрокам свободно перемещаться с помощью кнопок «Предыдущее/следующее»

Используйте пользовательскую кнопку 1 для «Открытый магазин» или пользовательскую кнопку 2 для «Teleport to Spawn»

Используйте команду Close Button, чтобы телепортировать игроков обратно в нерест.

- Пример: "tp @p 0 64 0" для телепортации игрока, закрывшего диалог

- Настройка пользовательского взаимодействия подсказка: «Нажмите F, чтобы просмотреть правила сервера»

Файлы конфигурации

Плагин создает два конфигурационных файла в папке данных плагина для расширенного управления командами:

PlayerPermissionCommands.json - Карты исполняемых игроками команд к узлам разрешения LuckPerms. Когда команда указана здесь, плагин временно предоставит указанное разрешение игроку через LuckPerms при выполнении команды. Это позволяет игрокам использовать ограниченные команды через взаимодействие с NPC без постоянных разрешений.

Пример конфигурации:

{

«PermissionCommands»: {

"warps": "warp.list",

"spawn": "spawn.use"

consoleCommands.json - определяет команды, которые должны выполняться как консоль, а не как игрок. Команды в этом списке будут работать с полными разрешениями консоли, минуя проверки разрешения игрока. Это полезно для команд администратора, которые должны работать при запуске через кнопки NPC.

Пример конфигурации:

{

"Консольные команды":

"дай",

"Тп",

"Телепорт",

"убить",

"гейммоде"

]

Уведомление о распространении:
Этот мод не может быть перераспределен или объединен со сторонними настройками без Ясный и видимый кредит Hyronix Studios и название мода. В противном случае перераспределение не допускается.

Показать оригинальное описание (English)

NPC Dialog

Support Server - https://discord.gg/DRxwt8Qg2W

A powerful and intuitive NPC dialog system for Hytale servers that allows you to create interactive conversations with any entity in your world.

Version [1.2.0] - 2026-01-17 Now live!

Description

NPC Dialog is a comprehensive plugin that enables server administrators to create rich, multi-page dialog systems for any entity in their Hytale world. Players can interact with NPCs by pressing F, opening a beautiful custom UI that displays conversations with navigation between multiple pages.

Perfect for quest systems, story-driven servers, interactive tutorials, or any scenario where you want entities to have meaningful conversations with players.

Additional Use Cases

NPC Dialog isn't limited to story or quest NPCs — it can also be used as a general-purpose information system for your server:

- Help & Tutorial NPCs – Display /help-style information in an interactive, readable UI

- Server Rules NPCs – Let players read server rules page-by-page instead of spamming chat

- Guides & Tips – Explain server mechanics, ranks, or custom features

- New Player Onboarding – Create step-by-step introductions for new players

- Information Hubs – Central NPCs for FAQs, commands, or announcements

Features

Core Functionality

- Interactive NPC System - Link dialog conversations to any entity in your world

- Frozen state (entities cannot move)

- Non-hostile state (entities cannot attack)

- Invulnerable state (entities cannot take damage)

- Idle animation selection with scrollable animation list displaying all available animations for each entity model

- Custom interaction hint text (e.g., "Press F to open Large Tavern Chest")

- Multi-Page Dialogs - Create branching conversations with multiple pages

- Custom Buttons - Two fully customizable buttons (Custom Button 1 and Custom Button 2) in player dialog UI, positioned above navigation buttons

- Text Formatting in Dialogs Markup for bold, italic, color, and monospace in NPC name, dialog title, and dialog content: `{b}`, `{i}`, `{m}`, `{#RRGGBB}` or `{#RGB}`, and `{/}` to end. Example: `Hello {b}bold{/} and {#ff0000}red{/} text.`

- Player Interaction - Players press F to interact with linked entities

- Persistent Storage - All NPC data is saved in JSON format and persists across server restarts

- Automatic Restoration - Interactions are automatically restored when the server restarts or when entities load

- Permission Support - Requires npcdialog.admin permission to use admin commands (compatible with LuckPerms)

- Data Migration - Plugin data folder changed from _NPC Dialog to Hyronix_NPC Dialog with automatic migration on first startup

User Interface

Admin Panel - Beautiful, intuitive GUI for creating and managing NPCs and dialog pages

- Create new NPCs with custom names and titles

- Edit existing NPCs and their properties

- Add multiple dialog pages per NPC

- Link NPCs to entities by selecting them in-world

- Delete NPCs and automatically remove their interactions

- Page selection dropdown for easy editing

- Customize Next button text for each page

- Customize Previous button text for each page

- Customize Close button text for each page

- Set command executions for Next and Close buttons

- Toggle "Prevent Close Until Last Page" option

- Enable/disable Previous button visibility per page

- Enable/disable Custom Button 1 and Custom Button 2 per page

- Configure Custom Button 1 and Custom Button 2 text and commands

- Toggle entity states directly from admin UI (Frozen, Non-hostile, Invulnerable, Idle Animation)

- Idle Animation Selection - Scrollable animation list showing all available animations for the selected entity's model, with selection highlighting

- Set custom interaction hint text for each NPC

- Improved layout and scrolling behavior for better usability

Player Dialog UI - Clean, readable interface for players

- Centered NPC name and title

- Scrollable multi-line dialog content

- Two customizable buttons (Custom Button 1 and Custom Button 2) positioned above navigation buttons

- Navigation buttons (Previous/Next) for multi-page conversations

- Customizable button text (Previous, Next, Close, Custom Button 1, Custom Button 2)

- Close button (can be hidden until last page)

Advanced Features

- Command Execution System - Execute server commands when players interact with dialog buttons

- Next Button Command: Run commands when players click the "Next" button (e.g., /help)

- Close Button Command: Run commands when players close the dialog (e.g., /spawn, /warp spawn)

- Custom Button 1 Command: Execute commands when players click Custom Button 1

- Custom Button 2 Command: Execute commands when players click Custom Button 2

- Command Selectors: Support for @p and @s selectors in commands

- @p = nearest player (closest player to the command execution point) - automatically replaced with the player who clicked the button

- @s = self (the entity executing the command) - automatically replaced with the player who clicked the button

- Both selectors are replaced with the player's name, so they work identically in this context

- Example: "give @p Plant_Fruit_Apple --quantity=1" will give the item to the player who clicked the button

- Admin Commands: Commands like /give, /tp, /effect, /summon, etc. automatically execute as console for proper permissions

- Player Commands: Regular commands execute as the player who clicked the button

- Configuration Files:

- playerPermissionCommands.json - Maps player-executed commands to permission nodes. Commands listed here will have permissions temporarily granted via LuckPerms when executed, allowing players to use restricted commands through NPC interactions

- consoleCommands.json - Defines commands that should execute as console (bypassing player permissions). Commands in this list will run with full console permissions when triggered through NPC buttons, useful for admin commands like `/give`, `/tp`, etc.

- Custom Button Text - Change the "Previous", "Next", "Close", "Custom Button 1", and "Custom Button 2" button text to anything you want (e.g., "Continue", "Accept Quest", "Go Forward")

- Custom Interaction Hints - Set custom interaction hint text that appears when players look at linked entities (e.g., "Press F to open Large Tavern Chest")

- Prevent Close Until Last Page - Force players to read through all dialog pages before they can close the dialog (perfect for story-driven servers and tutorials)

- Enable/Disable Previous Button - Control whether the Previous button appears on each page (useful for linear story progression where you don't want players going back)

- Enable/Disable Custom Buttons - Toggle Custom Button 1 and Custom Button 2 visibility per page

- Entity State Management - Toggle entity states (Frozen, Non-hostile, Invulnerable, Idle Animation) directly from the admin UI

- Idle Animation Selection - Select specific idle animations from a scrollable list showing all available animations for each entity model

- Multi-Line Content - Support for long dialog text with automatic scrolling

- Entity Linking - Link dialogs to any existing entity using in-game selection

- Cross-World Support - Works across all worlds on your server

- Smart Interaction Management - Automatically adds/removes interaction components

- Safe Deletion - Properly cleans up interactions when NPCs are deleted

- Error Prevention - Prevents crashes when interacting with deleted NPCs

Commands

| /npcdialog | Opens the admin GUI for managing NPCs and dialogs | Requires npcdialog.admin permission |

Usage Guide

Creating an NPC Dialog

1. Open Admin Panel: Run /npcdialog in-game (requires npcdialog.admin permission)

2. Create NPC:

- Enter the NPC name in the "NPC Name" field

- Enter a title (optional) in the "NPC Title" field

- Set custom interaction hint text (optional, e.g., "Press F to open Large Tavern Chest")

- Click "Create NPC"

3. Add Dialog Content:

- Enter dialog text in the "Dialog Content" field (supports multiple lines)

- Optionally customize the "Next Button Text" (defaults to "Next")

- Optionally customize the "Previous Button Text" (defaults to "Previous")

- Optionally customize the "Close Button Text" (defaults to "Close")

- Optionally add a "Next Button Command" to execute when players click Next

- You can use @p or @s selectors in commands (e.g., "give @p Plant_Fruit_Apple --quantity=1")

- @p and @s are automatically replaced with the player's name who clicked the button

- Optionally add a "Close Button Command" to execute when players close the dialog

- You can use @p or @s selectors in commands (e.g., "tp @p 100 64 200")

- Admin commands (give, tp, effect, etc.) automatically execute as console for proper permissions

- Enable/disable Custom Button 1 and Custom Button 2

- Configure Custom Button 1 and Custom Button 2 text and commands

- Toggle "Prevent Close Until Last Page" if you want to force players to read all pages

- Toggle "Show Previous Button in Dialog" to enable/disable the Previous button

- Click "Save NPC" to save the first page

4. Configure Entity States (Optional):

- Toggle "Frozen" to prevent the entity from moving

- Toggle "Non-hostile" to prevent the entity from attacking

- Toggle "Invulnerable" to prevent the entity from taking damage

- Toggle "Idle Animation" to enable idle animation

- Select a specific idle animation from the scrollable animation list (shows all available animations for the selected entity model)

5. Link to Entity:

- Select the entity you want to link in the entity list (left panel)

- The entity will automatically be linked to your selected NPC

6. Add More Pages (Optional):

- Select the page you want to edit from the "Select Page" dropdown

- Add new pages using the "Add Page" button

- Use Previous/Next buttons in the player UI to navigate between pages

Player Interaction

- Players simply look at a linked entity and press F to interact

- The custom interaction hint text (if set) will appear when looking at the entity

- The dialog UI opens showing the NPC's name, title, and conversation

- Players can use Custom Button 1 and Custom Button 2 (if enabled) positioned above the navigation buttons

- Players can navigate between pages using Previous/Next buttons (with custom text if configured)

- If "Prevent Close Until Last Page" is enabled, players must reach the last page before they can close the dialog

- Commands configured for Next/Close/Custom buttons will execute automatically when clicked

Example Use Cases

Quest Giver NPC

- Create a multi-page quest introduction

- Use "Prevent Close Until Last Page" to ensure players read the full quest

- Set Next Button Command to "quest accept" on the last page (Dont use the "/")

- Or use "give @p Quest_Item_1 --quantity=1" to give quest items when accepting

- Customize Next button text to "Accept Quest"

- Use Custom Button 1 for "View Rewards" with a command to show reward information

- Set custom interaction hint: "Press F to accept quest"

Tutorial NPC

- Create step-by-step tutorial pages

- Disable Previous button to force linear progression

- Use command execution to teleport players or give items at specific steps

- Example: "tp @p 100 64 200" to teleport the player who clicked the button

- Example: "give @p Tutorial_Book --quantity=1" to give items to the player

- Use Custom Button 1 for "Skip Tutorial" option

- Prevent closing until tutorial is complete

- Enable Frozen state to keep the tutorial NPC in place

- Select a specific idle animation from the animation list

Information NPC

- Create FAQ or server rules pages

- Allow players to navigate freely with Previous/Next buttons

- Use Custom Button 1 for "Open Shop" or Custom Button 2 for "Teleport to Spawn"

- Use Close Button Command to teleport players back to spawn when done

- Example: "tp @p 0 64 0" to teleport the player who closed the dialog

- Set custom interaction hint: "Press F to view server rules"

Configuration Files

The plugin creates two configuration files in the plugin data folder for advanced command management:

playerPermissionCommands.json - Maps player-executed commands to LuckPerms permission nodes. When a command is listed here, the plugin will temporarily grant the specified permission to the player via LuckPerms when executing the command. This allows players to use restricted commands through NPC interactions without having permanent permissions.

Example configuration:

{

"playerPermissionCommands": {

"warps": "warp.list",

"spawn": "spawn.use"

}

consoleCommands.json - Defines commands that should execute as console instead of as the player. Commands in this list will run with full console permissions, bypassing player permission checks. This is useful for admin commands that should work when triggered through NPC buttons.

Example configuration:

{

"consoleCommands": [

"give",

"tp",

"teleport",

"kill",

"gamemode"

]

}

Distribution Notice:
This mod may not be redistributed or bundled with third-party setups without clear and visible credit to Hyronix Studios and the mod name. Otherwise, redistribution is not permitted.