Discord:
https://dsc.gg/donkolia
Features
- Custom YAML Configuration: Define conversations in easy-to-read YAML files
- Recursive Loading: Organize your conversations in subfolders within plugins/SantumConversations/conversations/
- Advanced Conditions: Support for all standard comparison operators (==, !=, >=, <=, >, <) for both numbers and strings
- PlaceholderAPI Support: Fully integrated with PlaceholderAPI for dynamic text and conditions
- Math Operations: You can use math directly in placeholders, for example %player_level%+2 == 50 or %variable%/5, and the plugin will calculate it automatically anywhere
- Interactive Chat: Clickable responses for players in the chat
- Menu Interceptor: Immersive conversation mode
-
- W / S: Scroll through options
- Shift (Sneak): Select the highlighted option
- Space (Jump): Exit the conversation
- Native UI Dialogs: Set mode: "ui" to use the new Native Paper 1.21.8 Dialog menus It displays the text clearly and adds buttons for each response, respecting condition visibility
- ESC Key Support: Players can simply press the ESC key to exit the dialog UI flawlessly
- Subfolder System: Create subfolders to organize your conversations
- Action System: Execute commands when a player selects a response
-
- [as_op] <command>: Execute as OP
- [as_player] <command>: Execute as the player
- [as_console] <command>: Execute from the console
Installation - Requirements
- Download the SantumConversations.jar file.
- Place it in your server's plugins folder.
- Ensure you have PlaceholderAPI installed - With expansions
- IMPORTANT: You must have packetevents-spigot-2.9.3 installed on your server.
- Restart your server.
Configuration
Conversations are located in plugins/SantumConversations/conversations/. You can create any folder structure you desire.
Code (YAML):
simplename:
quester
:
"NPC Name"
first
:
"Welcome"
# Optional: Explicitly define the starting option
mode
:
"ui"
# You can use "ui" for Native Dialogs or "chat" for regular text
NPC_options:
"Welcome":
ask
:
"How are you today %player_name% %player_level%+2?"
ask_conditions
:
-
"%player_name% == DonKolia"
-
"%player_level%+2 == 50"
no_requirements_message
:
"You cannot talk to me &b%player_name%+4"
answers:
- text
:
"I'm doing great, thanks %player_name% %player_level%+2"
next_ask
:
"Where are you?"
answer_conditions
:
-
"%player_level% >= 50"
- text
:
"Give me experience"
actions
:
-
"[as_op] xp set %player_name% 50 levels"
next_ask
: null
"Where are you?":
ask
:
"Where are you? I can't find you"
answers:
- text
:
"I'm in the castle"
answer_conditions
:
-
"%player_level% >= 50"
actions
:
-
"[as_console] say %player_name% is in the castle"
next_ask
:
"Okay"
"Okay":
ask
:
"Understood"
answers:
- text
:
"Goodbye"
next_ask
: null
Commands
Command
Description
Permission
/santumconversations reload Reloads all conversations and configuration. santumconversations.reload
/santumconversations reload <name> Reloads a specific conversation (currently reloads all). santumconversations.reload
/santumconversation set <conversation> <player> Starts a conversation for a player. santumconversations.set
Permissions
- santumconversations.reload: Allows reloading the plugin.
- santumconversations.set: Allows starting conversations for players.