Upgrade

This part only cover the admin point of view. For admins, 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.

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

Last updated