Documentation
Complete Technical Manual, Commands & Configuration Reference
---
⚙️ DEFAULT CONFIGURATION (Line 9 - 63)
Below is the reference guide for the editable
options: block at the top of your
chatgames.sk file. Do not modify any logic code below line 64.
| Configuration Key |
Default |
Description |
| interval-min |
10 |
Minimum wait time (in minutes) between random games. |
| interval-max |
25 |
Maximum wait time (in minutes) between random games. |
| game-timeout |
60 |
Time window (in seconds) players have to guess the correct answer. |
| anti-duplicate |
true |
Prevents macro software by blocking identical consecutive guesses. |
| max-attempts |
5 |
Max answers a single player can submit per game to stop brute-forcing. |
---
COMMANDS & PERMISSIONS REFERENCE
Player Commands
[*]
/chatgames leaderboard ➜ Displays top players with the most wins.
Required Permission:
chatgames.player
Admin Commands
[*]
/chatgames reload ➜ Instantly flushes and reloads the configuration profile.
[*]
/chatgames trigger <gamemode> ➜ Force-starts a specific game event instantly for testing.
Required Permission:
chatgames.admin
---
️ ADVANCED FORMATTING SYNTAX
1. Multi-Command Rewards (reward-commands:)
To dispatch multiple console rewards seamlessly, divide strings using a double semicolon (
;;). Use the literal placeholder
PLAYER for dynamic name injections.
Code (YAML):
reward-commands
: give PLAYER diamond 3;;eco give PLAYER 500;;crate key give PLAYER vote 1
2. Trivia Formulation Matrix (trivia-list:)
Trivia configuration profiles require an explicit split token pairing. Map your logic using the following architecture:
- Question/Answer Separator: Use a single vertical pipe (|)
- Entry Separator: Use a double semicolon (;;)
Code (YAML):
trivia-list
: Question One?|Answer One;;Question Two?|Answer Two
3. Strict Word Pool Syntax
When modifying word lists for categories like
unscramble or
reverseword, arrays
must be entirely comma-separated without spaces. Spacing variables will register inside the engine comparison filters and break player guess tracking.
✔ Correct:
stone,dirt,grass,cobblestone
✘ Incorrect:
stone, dirt, grass, cobblestone