✨ ChatGames ✨ - Multiple Game Types, Fully Customisable, Hiscores, Fully Translatable

✨ ChatGames ✨ - Multiple Game Types, Fully Customisable, Hiscores, Fully Translatable -----

Let your players play chat games in your server chat

Additions
➕ Implemented reward commands that allow for probability. You can now add rewards that have a pre-defined % chance to be given to the winner. Just add the chance-commands section to each rewards section that you require chance commands for.

Code (YAML):

reaction-test :

enabled : true
words :
- 'apple'
- 'banana'
- 'pear'
- 'orange'
- 'hippopotamus'
- 'egypt'
- 'pyramid'
- 'antidisestablishmentarianism'
- 'pneumonoultramicroscopicsilicovolcanoconiosis'
rewards:
use-prefix : false
broadcast :
- '&8&m-| ------------------------------------------------|-&r'
- '&r &9C&a&lh&ba&c&lt&dG&e&la&7m&2&le&3s'
- '&r'
- '&r &7 %player% &ehas won $50 for getting the answer!'
- '&r &eAnswer : &6&l%answer%!'
- '&r'
- '&r&8&m-| ------------------------------------------------|-'
commands :
- 'eco give %player% 50'
chance-commands:
cmd1:
command : 'eco give %player% 100'
chance : 50 # percent chance
cmd2:
commands : 'eco give %player% 1000'
chance : 5 # percent chance

Optimisations/Bug Fixes
⚒ Hex Color codes will now display properly again. Simple use the hex code anywhere in a string for it to display in-game, e.g.

Code (YAML):

prefix : ' #FF0000&l[#FF002B&lC#FF0056&lh#FF2A56&la#FF7D2B&lt#FFD100&lG#99AF66&la#338CCC&lm#0095FA&le#00CAEF&ls#00FFE4&l] '

⚒ Fixed a bug where the plugin would not work properly if you did not have PAPI installed.
⚒ Fixed a bug where the math engine would only give negative answers, and would round these answers to 0 the majority of the time.
⚒ Fixed an issue where games would not run properly if all players left during the first game.
⚒ Reworked some utility classes to tidy up the code-base and minor optimisation improvements.

-|-----------------------------------------------------------------|-
As always if you need any support feel free to reach out
to me on Discord and I will do my best to support you!
-|-----------------------------------------------------------------|-

----------, Dec 2, 2023

Math Changes, PAPI and GUI Localisation

Additions
➕ Overhauled the math engine to be more efficient behind the scenes.
➕ Added the "%chatgames_game_win_time% placeholder to output the seconds it took to win a game.
➕ Added the ability to define the maximum and minimum values that the math questions will use. Simply add the following to your config.yml math section and the games with use these numbers from now on.

Code (Text):

hard-range:
max: 999
min: 1
easy-range:
max: 999
min: 1

➕ Added full PlaceholderAPI support in the game start/lose messages as well as in the game broadcast messages. You should be able to use any PAPI placeholder now.
➕ Added all scoreboard GUI messages to the messages.yml file. You can now fully translate the scoreboard GUI. Add the following to your messages.yml file to change them.

Code (Text):

# Scoreboard Category GUI
scoreboard-category-title: 'Scoreboard'
filler-item: '&r'

total-category-button: '&6&lTotal &9&lScore'
reaction-category-button: '&cReaction &6Score'
unscramble-catgeory-button: '&7Unscramble &6Score'
math-category-button: '&9Math &6Score'
trivia-category-button: '&8Trivia &6Score'

total-category-lore: |
&7Click to view &6total &9hiscores.
reaction-category-lore: |
&7Click to view &6reaction &9hiscores.
unscramble-category-lore: |
&7Click to view &6unscramble &9hiscores.
math-category-lore: |
&7Click to view &6math &9hiscores.
trivia-category-lore: |
&7Click to view &6trivia &9hiscores.

# Scoreboard Page GUI
scoreboard-title: 'Chatgames HiScores'
next-page-button: '&eNext Page'
previous-page-button: '&cPrevious Page'
return-button: '&cReturn'
scoreboard-total-head: '&6&lTotal Score: &7&l'
scoreboard-reaction-head: '&a&lReaction Score: &7&l'
scoreboard-unscramble-head: '&a&lUnscramble Score: &7&l'
scoreboard-math-head: '&a&lMath Score: &7&l'
scoreboard-trivia-head: '&a&lTrivia Score: &7&l'

Optimisations
⚒ Various optimisations and code cleanup.

----------, Aug 13, 2023

Optimisation + MinPlayer Fix

Bug Fixes
⚒ Fixed an issue where the minimum player check wasn't being called properly when players would leave the game just before a game was run.
Additions
➕ Changed how the math questions were being calculated and dropped use of an external API that was being used. The file size of the jar has also dropped dramatically.

----------, Jul 23, 2023

1.20 + Refactoring

Bug Fixes
⚒ Refactored a lot of the classes and changed how various things work.
Additions
➕ Added support up to 1.20

----------, Jul 18, 2023

Bug fixes + Enabling/Disabling

Bug Fixes
⚒ Fixed an issue where the math games were not giving rewards.
⚒ Fixed an issue where you couldn't force a game from the console.
⚒ Added a prefix to the TextUtil#Console method.
⚒ Fixed a major bug where the world whitelist was returning on the first entry.
⚒ Fixed a NPE relating to worlds and game answers.

Additions
- Added the ability to turn on/off every module through "enabled: true/false" added beneath the game name in the config.yml

----------, May 16, 2023

Trivia Game NPE Fix

Bug Fixes
⚒ Fixed a bug where a NullPointerException was being thrown sometimes when a trivia game was about to begin.

----------, May 8, 2023

Bug Fixes

Bug Fixes
⚒ A bug has been fixed that caused the math-win message to display instead of the math-lose message.
⚒ Games wouldn't end if the minimum players were not online, even if they were online to begin with when the game started. Now a game will end regardless of how many players are online.
⚒ Tweaked the default config.yml file so that the interval between games is 5 minutes and not 5 seconds.

----------, May 7, 2023

Words.txt Fix + Optimisations

Bug Fixes
⚒ The words.txt file was not working correctly, but this has now been fixed. You can populate the words.txt file with whatever words you like and these words will be used for reaction & unscramble games if you have enabled the file in your config.yml.
⚒ Internal refactoring and optimisations.

----------, Apr 24, 2023

Global rewards for Trivia

Additions
➕ Added a global rewards option for the trivia section. This allows you to use a default reward for all trivia games. If you have enabled this setting then any rewards put in the individual question sections will be ignored. To use this new setting simply add this to the "Trivia" section underneath the "Enabled: true" option.

Code (YAML):

use-global-rewards : false # Set true to use the same rewards for all games
global-rewards:
use-prefix : false
broadcast :
- '&8&m-| ------------------------------------------------|-&r'
- '&r &9C&a&lh&ba&c&lt&dG&e&la&7m&2&le&3s'
- '&r'
- '&r &7 %player% &ehas won $50 for getting the answer!'
- '&r &eAnswer : &6&l%answer%!'
- '&r'
- '&r&8&m-| ------------------------------------------------|-'
commands :
- 'eco give %player% 50'

----------, Apr 13, 2023

Scoring & Rewards Bug Fix

Bug Fixes
⚒ Fixed a bug where the reaction game reward was being sent more than once.
⚒ Fixed an issue with the scoring where each game was affecting the reaction game score.

----------, Apr 5, 2023

Fixed math game placeholder

Bug Fixes
⚒ The %answer% placeholder in math games was returning the question and not the answer. This has now been fixed.

//===================================================//
As always if you need any support feel free to reach out
to me on Discord and I will do my best to support you!
//===================================================//

----------, Apr 4, 2023

Reward Broadcast Tweak

Additions
➕ A new option has been added under the rewards section of each game type in the config.yml. Now you will be able to use the use-prefix: true/false option to choose whether or not you want the plugin prefix to be included in your broadcast messages. This allows for much more customisation in your broadcasts.

----------, Apr 4, 2023

Bug Fixes + Tweaks

Additions
➕ Tweaked the /cg forcegame command so that you can force a game to start even if you do not meet the minimum required players for a game.

Bug Fixes/Optimisations
⚒ Fixed a bug where the min-players option has no affect. Now you're able to define the minimum players required before a game starts. You can bypass this requirement by either setting it to 0 or using the /cg forcegame command.
⚒ Fixed a bug where the %answer% placeholder was not working in the unscramble-start message.
⚒ Tweaked some internal code that handles the reaction games. It's now more optimised and is more in-line with the other ChatGames.

----------, Apr 4, 2023

Minor Bug Fix

Bug Fixes
⚒ Fixed a bug with the header/footer being left empty as well as making multi-line support more apparent for the game messages.

----------, Mar 26, 2023

Reload Bug Fix

Bug Fixes:
⚒ Fixed a bug that was causing the reload command to not work and fill the console with errors.

----------, Mar 26, 2023

2.0.0 - Scoreboards, Placeholders, Revised Games and more...

This new version changes a lot of things in the configuration files of ChatGames and thus before you upgrade to 2.0.0 it is highly recommended that you read through the documentation if you're not planning on a fresh install.

Additions:
➕ Support for 1.19.4 has been added.
➕ MySQL support has been added.
➕ All game messages now have a header/footer, allowing you to better define how your game messages are displayed. This also allows them to stand out more in game.
➕ Math Questions have been refactored and now support EASY/HARD/BOTH difficulty settings.
➕ Added support for a sound to play in-game when a game starts. This can be configured from the config file.
➕ Player Scoring has now been implemented. Players will be able to see how many games they have won through either the in-game score GUI or through a hi-score hologram if DecentHolograms is installed.
➕ Hiscores have been added. You can now see the hiscores of your players for all game types.
➕ You can now use PlaceholderAPI to display various game-related information. More on this can be found in the documentation.
➕ You will now see progress when entering a word incorrectly. If you manage to get 5/6 letters correct then you will be told this in a game message.

Bug Fixes/Optimisations:
⚒ All references to the "Custom" game type have now been refactored to "Trivia".
⚒ The Math System has been overhauled for improved equations with more variety.
⚒ Any reference to "problem" and "solution" in the config files have now been refactored to "question" and "answer".
⚒ Removed the space after the prefix from the code. Now if you choose not to have a prefix there will be no space before your messages.
⚒ A lot of code cleanup and refactoring has been done. Code efficiency has been improved as well.
⚒ Various bugs that have come to my attention have been fixed.

Overall quite a bit has changed with this update and so there may be bugs found. If you do find any bugs or you need any assistance you can reach out to me on the support discord or read the documentation. Any suggestions can also be submitted via the discord.

I hope you enjoy this new version and look forward to your feedback!

----------, Mar 26, 2023

Bug Fix

Additions
➕ Added a min-players option to the config.yml so that you can define how many players need to be online before a game starts.

Bug Fixes/Optimisations
⚒ Fixed a bug where custom games would throw a console error and not run the game.
⚒ Fixed an issue with the /cg reload command throwing errors into the console in some instances (on a fresh install).

----------, Sep 26, 2022

Full localisation support + Bug Fixes

Additions
➕ Added extra localisation so you can now fully translate the plugin to your language. Add these to your messages.yml file:

Code (Text):

# Command Aliases
command-enable: 'enable'
command-disable: 'disable'
command-forcegame: 'forcegame'
command-reload: 'reload'
command-mute: 'mute'
command-help:
- '&6ChatGames Commands'
- '//------------------//'
- '&7/chatgames enable &8- &f Enables the plugin.'
- '&7/chatgames disable &8- &f Disables the plugin.'
- '&7/chatgames forcegame &8- &f Force a new game.'
- '&7/chatgames reload &8- &f Reload the plugin config files.'
command-noperms: '&cYou do not have permission to run this command.'
#
# Utility Messages
mute-on: '&7ChatGames has been &cmuted&7. You will no longer see any game messages!'
mute-off: '&7ChatGames has been &eunmuted&7. You will now see game messages.'
force-game-success: 'You have successfully forced a new game.'
force-game-plugin-disabled: '&cYou cannot start a new game when the plugin is disabled.'
plugin-enabled: '&ePlugin has been &6&lenabled.'
plugin-disabled: '&ePlugin has been &6&ldisabled.'

➕ Added an "enabled: true/false" option to the custom gamemode. You will now be able to turn off custom questions without getting any errors in the console.
➕ You can now force a game through the console with /cg forcegame.
➕ The download now comes with chinese translation files which can be used in place of the default files for full chinese translation.

Bug Fixes/Optimisations
⚒ Fixed a bug with custom games spouting console errors from time to time.
⚒ Minor optimisations and removal of obsolete code.

----------, Sep 21, 2022

Game Loss Bug Fix

Bug Fixes/Optimisations
⚒ Fixed a bug that caused the losing messages to not display when the game had ended without a winner.

----------, Sep 12, 2022

Changes + Fixes

Additions
➕ Implemented the fundimentals for the upcoming leaderboard system. Placeholders for scores and leaderboards will be coming very soon.
➕ Added an "easy-mode" for the maths section. Add "easy-mode: true" under the "maths>enabled" part of the config to limit your maths equations to double digit numbers only.
➕ Rewrote how the word scrambler works. Now it has more support for sentences. It will no longer scramble sentences indiscriminately. It will now only scramble each word of a sentence, retaining the space between words.
➕ The /cg reload command is a little more verbose now. Showing you which files it has reloaded.

Bug Fixes/Optimisations
⚒ Fixed a bug where maths questions would ignore the time between games.
⚒ Minor optimisations and removal of obsolete code.

----------, Sep 11, 2022

Enable/Disable whitelist + bug fixes

Additions
➕ You can now turn the world whitelist on and off. Simply add the following to your config.yml or delete your old one and use the newly generated config file.

Code (Text):

# Should we use a whitelist for the worlds the games will work in?
use-whitelist: false

Bug Fixes/Optimisations
⚒ Fixed an issue with the world whitelist not working properly.

----------, Sep 7, 2022

Bug Fixes

Bug Fixes/Optimisations
⚒ Fixed a bug that would cause errors in the console if your words.txt file was not configured correctly. Now instead of errors it will let you know that the file has been configured wrong in the console and in-game.
⚒ Fixed an issue that would cause your answers to not be recognised if you had coloured chat in-game.

----------, Sep 5, 2022

Fixed a critical bug

Bug Fixes/Optimisations
⚒ Fixed a bug relating to backwards compatibility which broke the plugin. The plugin should now work again and retain backwards compatibility.

----------, Sep 3, 2022

Backwards Compatibility

Additions
➕ 1.12 to 1.16 support has now been added. If there are any issues as always feel free to message me on discord and I'll fix the issues ASAP!

----------, Aug 30, 2022

Multi-World Support

Additions
➕ You will now be able to limit the games to only be active in certain worlds. You will need to add the following line to your config.yml file (or delete the old one) in order to use this version!

Code (YAML):

# A list of all the worlds that the games are active in
world_whitelist :
- world
- world_the_end
- world_nether

----------, Aug 16, 2022

1.17/1.18 Compatibility bug fix

Bug Fixes/Optimisations
⚒ Fixed a compatibility issue with 1.17/1.18.

----------, Jul 22, 2022

Math game type + word list

Additions
➕ You will now find an option to enable a "math" game type in the config.yml. This will automatically generate random sums ranging from 1-5 digit numbers. Supports addition, subtraction, multiplication and division.
➕ You can now populate a words.txt file in the plugin directory with as many words as you'd like for use in your games. Make sure to enable the config option in the config.yml to use-wordlist. Then scramble and reaction test will pull words from the words.txt file.

Bug Fixes/Optimisations
⚒ More minor optimisations and bug fixes.
⚒ Changed the default config.yml to use the proper answer placeholder. It is %solution% and not %answer%.

----------, Jul 22, 2022

Math game type + word list

Additions
➕ You will now find an option to enable a "math" game type in the config.yml. This will automatically generate random sums ranging from 1-5 digit numbers. Supports addition, subtraction, multiplication and division.
➕ You can now populate a words.txt file in the plugin directory with as many words as you'd like for use in your games. Make sure to enable the config option in the config.yml to use-wordlist. Then scramble and reaction test will pull words from the words.txt file.

Bug Fixes/Optimisations
⚒ Fixed a bug where the config files were trying to use the %answer% placeholder. The correct placeholder is %solution%.
⚒ More minor optimisations and bug fixes.

----------, Jul 21, 2022

1.19 Support + Localisation Support

Additions
➕ 1.19 support has been added.
➕ You will now find that you have a messages.yml file in which you can change all of the messages within the plugin.

Bug Fixes/Optimisations
⚒ Changes to the way some internals are done
⚒ Minor optimisations.

----------, Jul 5, 2022

Legacy Support

Added legacy support for 1.17

----------, Jun 9, 2022

Fixed loss messages

Fixed the losing messages as it originally only showed a losing message for the reaction test. Now it will show a losing message for unscrambled and custom games as well.
Added some logic to prepare for the next update in which you are able to change all of the messages in the plugin (e.g. the prefix, game messages etc.)
Added the ability for players with the "chatgames.mute" permission to mute the chatgames messages (/cg mute).

----------, Jun 9, 2022

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 15,236

First Release: Jun 8, 2022

Last Update: Dec 2, 2023

Category: ---------------

All-Time Rating:

23 ratings

Find more info at docs.criticalred.com...

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings

Ask Questions / Get Support