> For the complete documentation index, see [llms.txt](https://tyzbrand.gitbook.io/docs.tyzs_skills/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tyzbrand.gitbook.io/docs.tyzs_skills/json-tweaks/how-works-tyzs-skills-6.4+.md).

# How Tyz's Skills Works

## JSON Architecture

In Tyz's Skills, the JSON configuration system operates independently from vanilla Minecraft data packs.

 Everything is managed directly inside your server folder at: `GAMEDIRECTORY/config/tyzs_skills/` .

*Inside this directory, you will always find two folders:*

{% columns %}
{% column %}

#### `default`

Contains all the default files generated by the mod and its addons.

This folder is **completely recreated** every time the game launches and serves as a general reference.

{% hint style="danger" %}
**DO NOT modify files inside the `default` folder.** 

Any changes you make here will be overwritten and lost on the next game startup.
{% endhint %}
{% endcolumn %}

{% column %}

#### `custom`

Contains all your custom or modified configuration files.

This folder is **never modified or cleared** by the mod. 

It acts as an **override layer**. Any file placed here with a matching identifier will be loaded *instead* of the default one.
{% endcolumn %}
{% endcolumns %}

Both the `default` and `custom` directories share the exact same internal structure, split into two subfolders:

* `skills`: Contains all skill-related JSON files.
* `data`: Contains all other global data files (such as custom categories, xp gain configurations...).

***

## Modifying Existing Content

To modify existing content, simply copy the file you want to edit from the `default` folder and paste it into the exact same subfolder inside the `custom` directory.

For your changes to apply successfully, the mod needs to know what it is replacing:

* **For Skills:** The `id` property *inside* the JSON file must perfectly match the `id` of the original skill in the `default` folder (the file name itself does not matter, though keeping it identical is recommended).
* **For Data Files:** The **file name** must be exactly the same as the target file in the `default` folder.

{% hint style="info" %}
**Tip:** Use `/skills reload` to apply changes you made while in game, without needing to relaunch.
{% endhint %}