From ee5d270bfa8deac86c98b72cff17f1383aff6af2 Mon Sep 17 00:00:00 2001 From: tastybento Date: Sun, 23 Sep 2018 13:21:41 -0700 Subject: [PATCH] Created new README.md Explain how to use add-on --- README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..8ad2944 --- /dev/null +++ b/README.md @@ -0,0 +1,61 @@ +# addon-level +Add-on for BentoBox to calculate island levels for BSkyBlock and AcidIsland. This add-on will work +for both game modes. + +## How to use + +1. Place the level addon jar in the addons folder of the BentoBox plugin +2. Restart the server +3. The addon will create a data folder and inside the folder will be a config.yml +4. Edit the config.yml how you want. The config specifies how much blocks are worth (see below) +5. Restart the server if you make a change + +## Config.yml + +The config.yml has the following sections: + +* Command hook-in configuration +* General settings +* Limits +* Block values +* Per-world block values + +### Command hook-in configuration + +This section allows you to tell the add-on which commands it should hook into. Do not edit this unless +you are changing the game mode command names. + +### General Settings + +This section defines a number of overall settings for the add-on. + +* Underwater block multiplier - default value = 1. If this value is > 1 then blocks below sea level will have a greater value. +* Level cost - Value of one island level. Default 100. Minimum value is 1. +* Level wait - Cooldown between level requests in seconds +* Death penalty - How many block values a player will lose per death. Default value of 100 means that for every death, the player will lose 1 level (if levelcost is 100) +* Sum Team Deaths - if true, all the team member deaths are summed. If false, only the leader's deaths counts. +* Max deaths - If player dies more than this, it doesn't count anymore. +* Reset deaths on island reset +* Reset deaths on team join + +### Limits +This section lists the limits for any particular block. Blocks over this amount are not counted. This limit applies to all game modes and is not world-specific. +Format is MATERIAL: value + +### Block values +This section lists the value of a block in all game modes (worlds). To specific world-specific values, use the next section. Value must be an integer. Any blocks not listed will have a value of 0. AIR is always zero. +Format is MATERIAL: value. + +### World-specific block values +List any blocks that have a different value in a specific world. If a block is not listed, the default value will be used from the blocks section. +Prefix with world name. The values will apply to the associated nether and the end if they exist. Example: + +``` +worlds: + AcidIsland_world: + SAND: 0 + SANDSTONE: 0 + ICE: 0 +``` + +In this example, AcidIsland will use the same values as BSkyBlock for all blocks except for sand, sandstone and ice.