Where:

/plugins/CollectablesCodex/collectables/notes/**

This folder holds the books (lore/story content) for the NOTE collectable type

Books are YAML files that define titles, authors, and content for the in-game written book UI

Directory → Namespace mapping

Namespaces are inferred from folder structure:

collectables/
├── notes/                       # base repo = "notes"
│   ├── secret/                    # subfolder creates namespace "secret"
│   │   ├── captain_diary.yml
│   │   └── expedition_log.yml
│   ├── mage_manifesto.yml       # default namespace = "notes"
│   ├── papers.yml
│   ├── scholar_notes.yml
│   └── weathered_journal.yml
├── secret.yml   (repo config)
└── notes.yml  (repo config)

Registration for this looks like:

secret:captain_diary
secret:expedition_log
notes:mage_manifesto
notes:torn_page
notes:burnt_scroll
notes:bloodstained_letter
notes:scholar_notes
notes:weathered_journal

Rules:

• Files in the root of notes/ default to namespace = notes
• Files inside a subdirectory (e.g. notes/fish/) use that subdirectory as the namespace
• You can override namespace manually with namespace: in the file

IDs:

• In single-book files: if book.id is omitted, it defaults to the filename (without .yml)
• In multi-book files: each map key under books: is the id (unless you override with id:)

File shapes

Single-book form