PuzzleLib icon

PuzzleLib -----

Library(Core) for every Puzzle plugin

Download Now
3.3 MB .jar


What is PuzzleLib​
PuzzleLib is a library (core) plugin for all Puzzle plugins. Every Puzzle plugin needs this library to be downloaded as a plugin to the server to work.
Plugins which now works on PuzzleLib:

Contacts​
If you want new features added to this plugin, feel free to suggest them; I will try to implement them if they are interesting and useful. If you have any questions about using this plugin or encounter any bugs, you can contact me on my Discord channel.
Features​
  • Custom Logger to send colorized messages to most consoles with different levels. Collects log files where it's needed(You can disable it in PuzzleLib logger.yml).
  • Custom .yml configs with safe logic to prevent a lot of errors/warnings on mistakes. If a value is wrong, it returns the default value. Possibility to return any value to the default value manually. It can collect comments everywhere in the file. "#load_info" feature to load all default comments and clear existing comments (see instructions below).
  • All needed dependencies are controlled by this library in all Puzzle plugins. (You can enable/disable any external plugin integration if you want for all Puzzle plugins and enable/disable message in every plugin on start where all hooked integrations are listed with features available or unavailable) in dependencies.yml).
  • Color util to send colorized messages (see instructions below).
  • You can set up Economy format for all Puzzle plugins in economy.yml
  • Database integration with migration.
  • Other useful developer utilities.
Configuration file features​
  • You can remove, add, change any comments everywhere
  • You can clear all comments and load default comments by this way:
    put "#load_info" on the first line in the config file -> save it -> use reload command in Puzzle plugin where you are making these changes.
  • You can return default value for any key in structured config, for that you just need to remove the value or the key and value, save the file and use reload command in Puzzle plugin where you are making these changes
  • If you see warning messages in config that some values has been added to any configuration file - it means that config has been automatically updated or you returned that values to default.
  • If you got errrors about incorrect structure and fixing structure of config - it means that you have used some restricted special symbols or wrong spaces structure, please check if it fixed the structure automatically correctly (It can add quotes in some places for more safe structure).
Colors tutorial for all Puzzle plugins​
If you want to use HEX and gradient colors on your server you must be sure that version of your server is 1.16 or newer. If it will be below 1.16 and you will try to use these colors that text will be just white. Use this tutorial for my Puzzle plugins only because in other plugins it can differ. Remember that you still can use all standard colors for all versions as usual if you want.

To use gradient colors, you need to put your text between '<>' and '</>', for example:
HEX gradients:
<#ffffff>Your text</#000000> - where '#ffffff' is your start gradient color and '#000000' is end of your gradient color. You need to put all colors by HEX standard.

Standard colors gradients:
<&c>Your text</&4> - where '&c' is your start gradient color and '&4' is end of your gradient color. You need to put all standard colors.

In gradient colors you can continue use formatting text like ‘&b’ , ‘&n’ and another. You also can break your gradient for some words with another color and after this word continue that gradient. You can use any color for word that you need and after, to continue gradient use ‘&r’. (You can find examples below in spoiler)

To use HEX colors, you need to put your text after ‘&<>’, for example:
&<#ffffff>Your text - where ‘#ffffff’ is your HEX color.

- '<#8a2dd6>Gradient colors</#c90c68>'
- '<#8a2dd6>Gradient &lcolors &nwith &mformatting</#c90c68>'
- '<#8a2dd6>Gradient with &4break &rof colors</#c90c68>'
- '<&b>Gradients with standard colors</&5>'
- '&<#4d0d3e>HEX colors'
- '&5Standard &dcolors'
[​IMG]
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 21
First Release: Dec 19, 2025
Last Update: Mar 14, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings