How to Start
Information of the plugin to correctly work on your server.
Last updated
Information of the plugin to correctly work on your server.
Last updated
1) Spigot/Paper
You need Spigot or Paper for the plugin to work. Don't use Craftbukkit.
2) PlaceholderAPI
This dependency is optional. It will allow you to add requirements to unlock categories, and provide some useful variables.
To install the plugin on your server just place the MineWords.jar file inside your plugins folder. Remember to use a Spigot/Paper server. Default categories and levels will be generated in the levels folder.
To start playing you need to use the /minewords command. This will open the game main inventory. Here you will find the different categories. Categories are just a way to group levels by difficulty and maintain everything more organized. This inventory is completely configurable and you can even add requirements to unlock categories.
Selecting a category will open an inventory with all of the levels from that category. Players need to complete levels in order to continue to the next ones. There is a permission to bypass this requirement. These inventories are also completely configurable.
Click on the unlocked level to start playing. Opening a level will remove your inventory, but don't worry, your items will be safely stored (even if the server crashes). When exiting the level you'll get them back.
Playing the game is very straightforward. Follow the next steps:
Click on the first slot of each line to select a word and start guessing.
Hovering on the slot (the gray glass panel) will show a hint (a description) of the word.
You can use the characters/letters on your inventory to write a word. If the word is correct, the word will transform into color green.
You can use The "Scroll Up" and "Scroll Down" buttons to move around the level and show the next or previous words. If you want to quit the game, press the nether star.
Some levels can have a hidden word. This word is positioned vertically on the inventory, doesn't provide a description, and is represented by the color yellow. This hidden word is completely configurable, you can choose if you want one for the level or not.
The player will receive configurable rewards when completing a level or the whole category.
The second game mode can be accesed through the main inventory and will open an inventory where players will need to find the hidden daily word.
A similar logic as the main game applies, players need to use the character/letters items to write a word and start guessing.
When certain of a word, the "enter" button must be pressed (emerald block by default).
The color of the letters on the word will change depending on how close the guess was.
Color Green: It means that the letter is on the same position on the word.
Color Yellow: It means that the letter is on the word but on a different position.
Color Gray: It means that the letter is not on the word.
The player has 6 opportunities to guess the word correctly.
To start creating a level you need to go to the levels folder of the plugin and open one of the category files. You can even create your own category file, but in this example I will open the easy.yml file.
Copy one of the levels, for example the third one, and paste it below, changing its number.
On the "level" option, you need to set a list of words to discover. Each list element MUST have 8 characters, since this is the size of each word line on the inventory. That doesn't mean the word must have 8 letters.
For example, I want the first word to be "CLOSE". Since this word has only 5 letters, I must fill the line with the "-" symbol. You can put these symbols left or right of the word, it is up to you. The "-" symbols will be replaced with barriers (or the no_letter item) on the inventory.
Now that I have one word, let's add a description or hint to it, on the "words" option. Since its the first word, I put the description under the "1" path.
Now I can start adding new words to the level. If you want to add a hidden vertical word, be careful how you organize your words. I want the hidden word to be "SUN", so let's see how to arrange that.
Currently, the possible vertical words I got are: "CCV", "LUI", "ORO", "SEL". Let's move the words to make the word "SUN".
There it is! On column 6. Now, the only thing missing is defining that the sixth column will be a hidden word.
My level is ready, now I have to go to the inventory.yml file, to the category_easy inventory, and place the level where I desire. This is done by using the type: "level: 4" item on the slot you want.
The level is ready to be played!
