ChatgamesPack v2.0.0

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.



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





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 Pros: Supports native economy hook variables and compound console reward command strings using custom isolates ;; and dynamic placeholder PLAYER runtimes.

THE PRACTICAL USAGE & CONFIGURATION MANUAL
A step-by-step walkthrough detailing exactly where, what, and how your buyers or staff 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. Open the chatgames.sk file using any plain text editor (such as Notepad, Notepad++, or VS Code).

All configurations are found at the very top of the file inside the designated options: section spanning from Line 9 to Line 63.
CRITICAL: Do not touch, edit, or remove any text located below Line 64. Changes outside the options block can break the plugin logic entirely.


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.

➜ Correct Example:


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.

➜ Correct Example:


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:



3. 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:

• Save your file changes inside your text editor (Home/plugins/Skript/scripts/chatgames.sk)
• Go in-game and run the administrative reload command: /chatgames reload (or run .sk reload chatgames from console).

4. Permissions (luckperms)

• chatgames.player - All player commands & leaderboards
• chatgames.admin - Full admin control

Reading the Built-in Error Safeguard: If you make a typo during configuration (such as missing a closing quotation mark or dropping an accidental space), the engine's compilation safeguard activates. It will prevent a server crash and output a precise layout warning report in chat telling you exactly which line number contains the typo so you can correct it instantly!