Skip to content

(1.12) Ranks JSON

TheIllusiveC4 edited this page Mar 4, 2021 · 2 revisions

Overview

The ranks.json file is generated automatically when loading up Champions for the first time. It is located in the config/champions folder. This page will provide detailed explanations about the properties of the json objects.

JSON Fields

Tier

"tier": <integer>

The tier field holds the unique integer value for the rank. Essentially, this represents where this rank falls on the overall hierarchy of all champions, with higher numbers being better.

This is a required field.

Color

"color": <integer>

The color field holds the integer color value (or hex, e.g. "0xffffff") to be associated with the rank. This controls particle colors and health bar colors. Note that this is just a default and this color can be overridden client-side.

Affixes

"affixes": <integer>

The affixes field holds an integer value that controls how many affixes are given to each rank. This number is absolute, the champion will always spawn with exactly that many affixes.

Growth Factor

"growthFactor": <integer>

The growthFactor field holds an integer value that controls the multiplier given to the stats of champions of that rank. How much each stat increments is dependent on the values listed in the champions.cfg file.

Chance

"chance": <decimal number between 0.0 and 1.0>

The chance field holds a decimal number between 0.0 and 1.0 that controls how often each rank will spawn. Note that each chance is multiplicative. For example, lowering the chance for any given tier will also lower the chance for all tiers above it. This is because this chance is applied to every successive tier when the champion spawns.

Potions

"potions": <list of potions>

The potions field holds a list of potions in the format "resourcelocation", or "resourcelocation;amplifier" if an amplifier needs to be specified. All of these potions will be applied for 10 seconds, every 5 seconds. Thus, these are permanent effects on the champion.

Example

{
    "tier": 4,
    "color": 13382655,
    "affixes": 4,
    "growthFactor": 16,
    "chance": 0.2,
    "potions": ["minecraft:invisibility","minecraft:regeneration;2"]
}

From this configuration, the rank is given a tier of 4 which places it above ranks 0, 1, 2, and 3. Champions of this rank will be given a purplish color, 4 affixes, have their respective stats incremented by a factor of 16, and has a 20% chance to be given to a mob that was already given tier 3. Champions will permanently have the Invisibility potion and the Regeneration 3 potion active.