ChatgamesPack 2.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:

reward-commands: give PLAYER diamond 3;;crate key give PLAYER vote 1;;eco give PLAYER 500

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.

diamond,emerald,sword,pickaxe,apple,cookie

➜ Incorrect Formatting:

diamond, emerald, sword, pickaxe, apple, cookie

C. Setting up Trivia Questions (trivia-list:)
The trivia category utilizes an explicit pair structure to match a question to its correct response.

trivia-list: Rarest ore?|ancient debris;;What mob explodes?|creeper;;What tool mines obsidian?|diamond pickaxe

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:

    math-enabled: false          # This game mode will no longer run automatically
    unscramble-enabled: true     # This game mode will actively populate the randomizer

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!