Upgrades

This part only cover the admin point of view. For users, check Upgrades

Upgrades can be fully customized by admins through two files:

• upgrades.yml – Defines the position, visuals, requirements, and rewards of all upgrades.

• lang/<lang_code>/upgrades.yml – Contains the localized names of upgrades. If a translation is missing for the server’s language, the name will default to English. If not found, the raw ID will be shown.

Upgrades.yml

By default, upgrades.yml already includes several example upgrades that can be used as templates or ready-to-use configurations. Each upgrade must be declared under the upgrades: section.

The CITY_HALL upgrade is unlocked by default for all Territories. Use it to define your default stats.

EXAMPLE_UPGRADE:
  col: 0                   #<- Column position
  row: 0                   #<- Row position
  itemCode: 'BELL'         #<- Icon of the upgrade. (https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
  maxLevel: 3              #<- The maximum level of the upgrade.
  cost: [ '1000', '2000' ] #<- A list of prices of each level of the upgrade. If the max level is higher than the size of the list, last price will be used several times
  prerequisites:           #<- List of prerequisites (other upgrade and town level only)
    TOWN_LEVEL: 3          #<- Defines the required town level
    OTHER_UPGRADE : 1      #<- Define a certain level from a certain upgrade 
  benefits:                #<- List of all rewards for each level of the upgrade
    PLAYER_CAP: +3         #<- +3 players per level
    CHUNK_CAP: +100        #<- +100 chunks per level

All prerequisites and upgrades can be found at the top of upgrades.yml .

Biome claiming

It is possible to manage in which chunks territories can claim their chunk. To do that, you can use the benefit AUTHORIZED_BIOMES . There, you can type minecraft biomes or biome pack described in upgrades.yml

benefits :
    AUTHORIZED_BIOMES: [ 'PLAINS' , 'DESERT', 'WARM_OCEAN']

In addition to normal chunk name, custom biome can also be used. You can find custom biome name with f3