SCRIPT KEYS DOCUMENTATION

Script Keys allow you to configure hotkeys (1-0, dash, and equals) and their Shift variants for quick actions in the game. This system supports 24 total keys with parameter substitution for dynamic commands.

KEY CONFIGURATION
-----------------
Configure your script keys in script_keys.txt using this format:
key=action

AVAILABLE KEYS:
- Keys 1-12: Press 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, -, =
- Keys 13-24: Press Shift + 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, -, =

PARAMETER TYPES
AUTOMATIC PARAMETERS (No input required):
- %coordinates or %coords : Your current coordinates (x y or x y z)
- %x : Your X coordinate
- %y : Your Y coordinate  
- %z : Your Z coordinate
- %location : Your current location name
- %mapname : Current map name
- %me : Your username

USER INPUT PARAMETERS (Prompts for input):
- %username : Prompts "Enter username:"
- %message : Prompts "Enter message:"
- %target : Prompts "Enter target:"
- %text : Prompts "Enter text:"
- %value : Prompts "Enter value:"
- %reason : Prompts "Enter reason:"
Note that some of these do the same thing, but present different prompt titles. This makes it easy to figure out what type of action you are executing. For instance, %message and %text.

CUSTOM PARAMETERS:
You can create custom parameters using any name you want. If the parameter isn't one of the predefined ones above, the system will automatically create a text input prompt with a custom label derived from your parameter name.

Examples:
- %your_chat_message : Prompts "Enter Your Chat Message:"
- %player_level : Prompts "Enter Player Level:"
- %custom_command : Prompts "Enter Custom Command:"
- %weapon_name : Prompts "Enter Weapon Name:"

The system automatically converts underscores to spaces and capitalizes each word to create user-friendly prompts.

SPECIAL PARAMETERS:
- %plist : Shows player selection menu if players are online

ACTION TYPES
1. SLASH COMMANDS: Start with "/" - sent as server commands
Example: 1=/pm %username %message

2. CHAT MESSAGES: Regular text - sent as chat messages
Example: 2=Hello everyone!

3. PARAMETERIZED ACTIONS: Include % variables for dynamic content
Example: 3=/go %x %y %z

EXAMPLE CONFIGURATIONS

Basic Examples:
1=/pm %username %message
2=/leave
3=Hello from %location!
4=/go %coordinates
5=My coordinates: %coords

Advanced Examples:
13=/pm %plist %message
14=I'm at %location on %mapname at %coords.
15=/pm %username     I saw %plist today.

Custom Parameter Examples:
16=I want to say: %your_chat_message
17=%your_chat_message

SYSTEM BEHAVIOR
- File automatically reloads every 5 seconds
- Empty lines and lines starting with "//" are ignored
- If script_keys.txt doesn't exist, a default file is created
- Keys without assigned actions will announce "Script key not assigned"
- You can cancel parameter prompts by pressing Escape or entering empty value

CONFIGURATION FILE FORMAT
// Script Keys Configuration
// Format: key=action
// Keys 1-12: Press 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, -, = 
// Keys 13-24: Press Shift + 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, -, =
// Use parameters like %username, %message within commands
// Special variables like %coordinates, %x, %y, %z, %location, %mapname, %me are auto-filled
// You can use any key numbers you want, no need to fill them all

1=/pm %username %message
2=/leave