How to Start

Information of the plugin to correctly work on your server.

Requirements

1) Spigot

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 levels.

https://www.spigotmc.org/resources/placeholderapi.6245/

Installation

To install the plugin on your server just place the ConnectTheBlocks.jar file inside your plugins folder. Remember to use a Spigot/Paper server. Default categories and levels will be generated in the levels folder.

How to Play

The Inventory

To start playing you need to use the /ctb 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. This inventory is not configurable, at least not the position of the items, however you can modify and translate them. If a category has more than 40 levels, a new item will appear to move to the next levels.

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.

The Game

Like I said before, the idea of the game is to connect the blocks with the same color. To accomplish that, you need to follow some rules:

Information

• Default start/end blocks will be present on every level. These blocks are fixed, players can't remove them.

• To start placing blocks, first you need to select one of the default ones by clicking on them. Then, to place a block of the selected type, left click on an empty slot on the inventory.

• If you want to remove blocks of the same type, right click one of them.

• To complete the level you need to fill all the empty slots of the inventory, connecting the default blocks.

Rule 1

Blocks of the same type must be connected.

Rule 2

You need to follow just one line. You can't place blocks from both the start and the end block at the same time. If you do, the placed blocks will be removed.

Rule 3

The blocks can not have more than 2 blocks of the same type around them. So, these kind of movement are not possible to make.

Rule 4

The path must not have any kind of bifurcations.

Create/Edit Levels

Before creating a level you should create a new category by duplicating a category file under the levels folder. Modify the options you want and remember to delete the "levels" path so you start creating levels from scratch.

If you are creating a new category remember to add it to the main inventory in the inventory.yml file!

Now use /ctb createlevel. You'll need to choose the created category and the type/shape of the new level. These shapes are defined in the level_inventory_types option in the inventory.yml file.

Now you need to start placing the default blocks first (the start and end blocks). If you make a mistake you can remove the blocks by right clicking them. The same rules applies. When you finish, click on the Create Level button.