The mod's skills can be modified using a datapack.
Editing skills[ | ]
With a datapack, the player is able to edit the following:
- the abilities of a skill.
- the level requirement and properties of the abilities.
- the skill xp multiplier
The player cannot edit the following:
- how a skill is trained.
- how much xp is needed to level up to the next level.
- maximum number of cycles in a skill.
In order to edit a skill, the player must create a json file for the skill data/aoa3/player/skills/ directory inside the datapack folder. The file should be named after the skill its editing, in all lowercase letters, e.g.: dexterity.json.
Inside the file, the player can place the code for the abilities of the skill. An example of the code can be seen below:
{
"xp_modifier": 1.0,
"abilities": [
<insert abilities here>
]
}
The xp_modifier can be changed to a different number to increase/decrease the amount of xp gained from training the skill.
The <insert abilities here> code for an ability should be replaced with a list of code blocks for each ability that the player wants to add to the skill. An example code block:
{
"id": "<id>",
"unique_id": "<number>",
"<editable parameter 1>": <parameter 1>,
"<editable parameter 2>": <parameter 2>,
...
"<editable parameter n>": <parameter n>,
"level_req": <number>
}
A comma (,) should be inserted after the last } for every ability block that the player adds, except for the last in the list.
The following table explains the properties the player can edit:
| Property | Explanation |
|---|---|
| id | The id of the ability. |
| unique_id | A unique value that represents the specific ability instance. Used to differentiate between multiple abilities of the same type on a skill. |
| level_req | The level required to unlock the ability. |
| <editable parameter n> | Each ability has a set of parameters that can be changed for the ability. |
The player can add any pre-existing ability in the game to any skill. The player cannot create brand new abilities using a datapack, but abilities added using an addon should be able to be added to existing skills with a datapack just fine.
The following code shows a modified skill with only two abilities:
{
"xp_modifier": 1.0,
"abilities": [
{
"id": "aoa3:attribute_modification",
"unique_id": "1970224826",
"base_value": 0.0,
"per_level_mod": 1.3,
"attribute": "minecraft:generic.max_health",
"operation": 0.0,
"level_req": 25
},
{
"id": "aoa3:bonus_mining_result",
"unique_id": "-1680951660",
"base_value": 0.4,
"per_level_mod": 4.0,
"level_req": 40
},
{
"id": "aoa3:one_shot_damage_limiter",
"unique_id": "-437214191",
"min_activation_health": 0.0,
"health_restore_amount": 1.0,
"level_req": 90
}
]
}
Adding new skills[ | ]
Adding new skills can only be done with an addon. If the player has successfully acquired the addon, then these new skills should be editable/removable in the same way that the original skills can be.
Removing skills[ | ]
TBP
