Upgrades
Using upgrades, you can give your players custom perks that are upgradable. In this documentation, you will understand how to edit them to your own style!
Creating your first upgrade
Creating a new upgrade is an easy task to do! All the upgrades follow the same rules, but in this tutorial we will create a generator upgrade.
We will start with the basic layout for the upgrade:
All the upgrades work with the same layout: a global section for the upgrade, and sub-sections for every level of the upgrade. You can make as many levels as you want!
Now, we can start working on our first level. We will give it a price-type, price, commands to be executed upon rankup and a required permission to use the upgrade. In this case, I don't want a permission - so I don't add that section.
As you might have noticed, I run /is admin setupgrade - this is required so the plugin will actually change the upgrade's level for the island. Not doing so will make the upgrade to not rankup, as you'll see in the last level.
After we set up the basic layout of the level, we want to give it some values. The values will be synced with the island. You can change crop growth, spawner rates, mob drops, limits, generators and more with the upgrades! For this tutorial, I will change the generator rates using the "generator-rates" section:
That's it! We completed our first level! Because this is the first level of the upgrade, it will be applied to all the islands by default. It means that all of the islands on my server will have the generator rates that I configured. Now, I will add more levels by following the same layout:
After I configured all of my levels, I must also add the last upgrade - level #4. Unlike the other upgrades, this upgrade will not have the setupgrade command, but will still have values assigned to it:
Finally, I have a working generator upgrade that will have it's values synced with all the islands. You can change the values anytime you want, and your islands will be synced automatically with it. Removing existing levels is not an option - you can just make the upgrade to do nothing, but removing it completely will cause errors from the plugin.
You can use the following sections to alter island values:
crops-growth
: The crop growth multiplier for this upgrade.
spawner-rates
: The spawner rates multiplier for this upgrade.
mob-drops
: The mob drops multiplier for this upgrade.
team-limit
: The team limit for this upgrade.
warps-limit
: The warps limit for this upgrade.
coop-limit
: The coops limit for this upgrade.
border-size
: The border size for this upgrade.
block-limits
: The block limits for this upgrade.
Under this section, all the blocks will be in the following format: "TYPE: LIMIT".
entity-limits
: The entity limits for this upgrade.
Under this section, all the entities will be in the following format: "TYPE: LIMIT".
generator-rates
: The generator rates for this upgrade.
Under this section, all the rates will be in the following format: "TYPE: CHANCE".
island-effects
: The island effects for this upgrade.
Under this section, all the effects will be in the following format: "EFFECT: LEVEL".
Price Types
The plugin has two pre-defined price types - money based prices and placeholders based prices.
Simply add the price-type
section to your upgrade with the price-type you want. Currently there are two different ones: money
and placeholders:
money
When using this price-type, money will be taken from the players' bank (Essentials or any other economy plugin).
You must add the following fields to your upgrade to get this working:
placeholders
When using this price-type, money will be taken by executing custom commands, and the balance will be parsed by a placeholder.
You must add the following fields to your upgrade to get this working:
You can register custom price types using the API.
Example
In the example below, you can find two upgrades (each has only one level) with different price types.
The first upgrade, money-example-upgrade
, has a money
price-type configured to it. The second one, placeholders-example-upgrade
, has a placeholders
price-type.
For this example, assume the placeholder %custom_economy_balace%
returns an integer with the balance of the player and the command /customeco take <player-name> <price>
takes the given balance from the given player.
Last updated