Levels/Categories Tutorial

In this page you will find all properties of levels/categories configuration files. Everytime you modify something in these files you must reload the plugin using /ctb reload.

On Level Selection Title

The title of the opened inventory when inside the level selection of this category.

on_level_selection_title: "&8[&b&lEasy&8] &6&lLevels"

On Game Title

The title of the opened inventory when playing on a level of this category.

on_game_title: "&8[&b&lEasy&8] &6Level %level%"

Inventory Items

The format of each item is the following:

inventory_items:
  <type>:
    <item>
circle-info

Remember that the item to be displayed has the properties listed HERE.

circle-check

Category Items

Each category will be represented by its own item in the main inventory. This item will vary depending on the current state of the category. For now there are two possible states.

1. Category

The item displayed by default. You can tell the players on this item the amount of levels the category has, the difficulty of them, and maybe the possible rewards.

circle-info

Variables:

  • %progress% (A progress bar showing the progress of the levels completed from this category)

  • %percentage% (Percertange of the levels completed from this category)

2. Category No Requirements

The item displayed when the player doesn't have the necessary requirements to play on this category. You should tell the players on this item, what requirements are needed.

Level Items

Each level of this category will be represented on the level section inventory by its own item. This item will vary depending on the current state of the level. These are the possible states.

1. Level Unlocked

The item displayed when the level is ready to be played.

circle-info

Variables:

  • %level% (Number of this level)

  • %type% (Type/Form of this level)

2. Level Blocked

The item displayed when the level is blocked, which means the previous level has not been completed.

circle-info

Variables:

  • %level% (Number of this level)

  • %type% (Type/Form of this level)

3. Level Completed

The item displayed when the level has been completed.

circle-info

Variables:

  • %level% (Number of this level)

  • %type% (Type/Form of this level)

  • %time% (Time taken to complete the level)

Modify Levels Amount

Whether the amount value of the Level Items should be changed depending on the number of the level. Be careful if your category has more than 64 levels!

Rewards

Rewards are given through actions. All Actions can be found HERE.

Per Level

Default actions to be executed when the player finishes a level from this category.

circle-info

Variables:

  • %level% (Number of the current level)

  • %time% (Time taken to complete the level)

All Levels

Default actions when the player finishes all levels from this category.

Requirements

Requirements needed to unlock this category. You can add multiple requirements/conditions. More info HERE.

No Requirements Error Message

Message to be sent to the player when requirements are not satisfied.

Levels

Levels are automatically saved on this file when creating them using /ctb createlevel.

Type

The type/form of the level. You should not modify this property manually. Types are defined in the level_inventory_types configuration on the inventory.yml file.

Blocks

The position of default blocks. You should not modify this property manually. Blocks are defined in the game_blocks configuration on the config.yml file.

Rewards

Allows you to set custom rewards for this level only. Will replace the default per level rewards from this category.

Inventory Rewards

Enable this option is you want to give items to the player as reward.

Last updated