l5rx-chiaroscuro/wiki/users/custom-compendiums.md

# Compendiums

**Never directly edit the system compendiums**.  They will be erased anytime you update the system.

The best option to keep the links between items and properties, for example, is to fill out a custom compendium using Babele.  This will prevent changes you make to system compendiums from being overridden by game system updates.

## Using the Custom Compendiums Maker (recommended)

Here is a quick guide to fill the compendiums with Custom Compendium Maker.

1. Go to the [Custom Compendiums Maker Website](https://vly.yn.lu/l5r5e-custom-compendium-maker/)
2. Download the template file :

![Download](img/ccm_usage_dl.png)

3. Open the template file with any software that can modify an Excel sheet (.xlsx).
4. Check instruction on `Infos` sheet.
5. Go into the `Configuration` sheet, and changes the values in the `Values` column.<br>If your language is `English` you'll probably only need to change the `Author` value.

![Template config](img/ccm_excel_config.png)

6. Add the various descriptions on all sheets.<br>Here an example on the `Techniques` sheet :

![Template Techniques](img/ccm_excel_tech.png)

7. Make sure you save the file often!
8. When it's done, visit the website again and follow the instructions:

![Options](img/ccm_usage_options.png)

9. Download the generated archive file.

![Archive](img/ccm_archive.png)

10. Extract it in your FoundryVTT `modules` directory.

![FVTT Modules](img/ccm_foundry_datadir.png)
![FVTT CCM](img/ccm_archive_extracted.png)

11. Open FoundryVTT and load an L5R5e World.
12. Make sure to have all these modules enabled:
    - Babele
    - L5R5e Custom Compendiums
    - LibWrapper

![FVTT Loaded](img/ccm_foundry_module_manager.png)

13. Open an item you know you had added a description to see the result:

![FVTT Tech](img/ccm_foundry_tech_filled.png)

14. Done, have a good time playing L5R!


## Using the Custom Compendiums Module
You will need to manually download the following module and edit json files.
Please follow the instructions on :
> https://gitlab.com/teaml5r/l5r5e-custom-compendiums