ChatgamesPack

EXECUTIVE PROJECT OVERVIEW
ChatGamesPack.sk is an automated chat engagement utility engineered for modern Minecraft server ecosystems running on Paper, Spigot, or Purpur (1.21+).

The system operates as a native Skript extension providing real-time, lightweight asynchronous word-puzzles, math races, reaction tasks, and sequence retention events directly inside the global chat stream. Give your community something fun to do during downtime without causing any performance lag.

---

️ 12 NATIVE COMPACT GAME MODES
Every game operates within isolated functional loops to automatically construct questions and handle strict validation metrics:

Game Mode	In-Game Structural Example	Expected Input
math	"Solve: (12+4) x 3"	48
unscramble	"Unscramble: rtheeneit"	netherite
fasttype	"Type exactly: Never dig straight down"	Never dig straight down
trivia	"What mob drops blaze rods?"	blaze
guessnumber	"Guess a number between 1 and 100"	74
fillmissing	"Complete: d_am_nd"	diamond
reverseword	"Unreverse: exakcip"	pickaxe
memory	"What was word #3?"	Context Dependent
reaction	"GO! Type: race"	race
symbolcopy	"Copy exactly: ✦✪✭✧"	✦✪✭✧
hiddenword	"Find the word: abcwardenxyz"	warden
wordchain	"Start with: sword - say a word beginning with d"	diamond

---

⚙️ DETAILED CONFIGURATION INDEX
The entire script is managed via clean, readable parameters located at the topmost section of the file. Adjust your setup to match your server style:

[*] interval-min / interval-max (Default: 10/25) ➜ Controls pacing cycles in minutes before a new random event triggers.
[*] game-timeout (Default: 60) ➜ The duration window in seconds allocated for players to successfully submit an answer.
[*] anti-duplicate (Default: true) ➜ Anti-exploit toggle blocking players from sending identical guess strings back-to-back to stop macro software.
[*] max-attempts (Default: 5) ➜ Restricts the maximum attempts a single user can make during a game to block brute-force scripts.
[*] Multi-Command Reward Routing ➜ Supports native economy hook variables and compound console reward command strings using custom isolates ( ;;) and dynamic placeholder PLAYER runtimes.

---

USAGE & CONFIGURATION MANUAL
A step-by-step walkthrough detailing exactly where, what, and how your staff or buyers can edit settings without breaking the backend script variables.

1. Where do I make configuration changes?
Open your server directory and navigate to your scripts folder: /plugins/Skript/scripts/. Open the chatgames.sk file using any plain text editor (such as Notepad++, VS Code, or Sublime Text).
2. Common Customization Tasks (How-To)

A. Customizing Reward Commands (reward-commands:)
The script allows you to run multiple console commands simultaneously when a player wins a game. You must follow two strict formatting rules:
[*]Use the exact uppercase keyword PLAYER wherever a user's name belongs. The script automatically swaps this with the winner's live username.
[*]Separate multiple distinct commands using a double semicolon ( ;;). Do not place empty spaces directly before or after the ;; dividers.

B. Modifying Word Pools (words-items:, words-mobs:, etc.)
The words used for scrambling, reversing, masking missing letters, and noise strings come directly from these lists.
[*]The lists must be entirely comma-separated.
[*] CRITICAL: Do not use spaces anywhere in the word lists. An accidental space registers as part of the word and will break user guessing calculations in chat.

✔ Correct Formatting:
✘ Incorrect Formatting:
C. Setting up Trivia Questions (trivia-list:)
The trivia category utilizes an explicit pair structure to match a question to its correct response.
[*]Use a vertical pipe symbol ( |) to separate the Question from the Answer.
[*]Use a double semicolon ( ;;) to separate entirely different trivia facts from one another.

D. Activating and Deactivating Game Modes
If you want to deactivate individual modes, find the enabled flags section and toggle the keywords directly between true and false:
---

️ APPLYING CHANGES & PERMISSIONS

How do I apply my new changes?
You do not need to restart your Minecraft server or reload heavy plugin directories to apply your changes. Once you are done making edits:
[OL]
[*]Save your file changes inside your text editor ( /plugins/Skript/scripts/chatgames.sk)
[*]Go in-game and run the administrative reload command: /chatgames reload (or run /sk reload chatgames from your server console).
[/OL]

Permissions Index
[*] chatgames.player ➜ Access to all player commands & leaderboards.
[*] chatgames.admin ➜ Full administrative control and reload capabilities.