SantumScript | PlaceholderAPI Scripting

SantumScript Wiki
Welcome to the official wiki for SantumScript created by DonKolia

Overview
SantumScript is a powerful custom scripting plugin for Paper 1.21 It allows you to write custom code logic inside yml files located in the plugin folder and its subfolders The plugin reads these files and translates them into executable actions in your server With full PlaceholderAPI support and mathematical evaluations it gives you total control over what happens when a script is called

Commands and Permissions
/santumscript call <script_name> [args...]
Triggers a specific script from your scripts folder You can pass unlimited arguments separated by spaces Inside the script these arguments can be used as %arg_1% %arg_2% and so on

/santumscript reload
Reloads all scripts into memory Requires santumscript admin permission

Variables and Placeholders
The system fully supports PlaceholderAPI You can use variables like %player_level% or %player_name% anywhere in your conditions or actions You can also use mathematical expressions inside conditions The engine will calculate math operations before comparing values

Additionally SantumScript comes with custom dynamic placeholders built-in:

%random_min_max%
Selects a random number between min and max For example %random_1_10% will be replaced by a random number between 1 and 10

%in_radius_<x>_<y>_<z>_<world>_<radius>%
Checks if the player executing the script is near certain coordinates in a specific world It returns true or false making it perfect for if conditions For example %in_radius_100_64_100_world_10% == true

Logical Operators
When creating conditions you can use the following comparison operators:

• == or = for equality
  
  
• != for inequality
  
  
• > < >= <= for numeric comparisons

You can combine multiple conditions using logical operators:

• && (AND) means both conditions must be true
  
  
• || (OR) means at least one condition must be true

Scripting Syntax
If ElseIf and Else
You can control the flow using standard conditional blocks
Switch Statements
You can evaluate a single expression and execute blocks based on matching cases You can also use PlaceholderAPI variables inside the case strings


Available Actions
Every line of execution inside your blocks must be surrounded by double quotes The following action prefixes are supported:

• as_op: <command> Executes a command granting temporary operator permissions to the player
  
  
• as_console: <command> Executes a command through the server console
  
  
• as_player: <command> Forces the player to execute a command
  
  
• message: <text> Sends a color-formatted message to the player
  
  
• centered_message: <text> Sends a message mathematically centered in the player chat