SantumConversations -  Conversation Dialogs System Interactions icon

SantumConversations - Conversation Dialogs System Interactions -----

Designed to replace and enhance standard NPC interactions



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
  1. Download the SantumConversations.jar file.
  2. Place it in your server's plugins folder.
  3. Ensure you have PlaceholderAPI installed - With expansions
  4. IMPORTANT: You must have packetevents-spigot-2.9.3 installed on your server.
  5. 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.
Resource Information
Author:
----------
Total Downloads: 15
First Release: Dec 27, 2025
Last Update: Jun 10, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings