File Organization

📁 File Organization & Best Practices

Recommendation: Use multi-folders to organize your language files!

Root Files (Legacy/Simple)

Files directly inside the language folder (e.g., langs/pt_br/messages.yml) do NOT use the filename as a prefix.

• Key welcome in messages.yml → %lang_welcome%
• ⚠️ Warning: If two root files have the same key welcome, they will conflict!

Multi-Folders (Recommended)

Files inside subfolders use the folder and filename as a prefix. This prevents conflicts and keeps things organized.

• File: langs/pt_br/menus/main.yml
• Key: title
• Placeholder: %lang_menus.main_title% (Format: folder.filename_key)

Example Structure

plugins/IGLanguages/langs/
├── en_us/
│   ├── example.yml              → %lang_keyname%
│   ├── menus/
│   │   └── main.yml             → %lang_menus.main_keyname%
│   └── messages/
│       └── system.yml           → %lang_messages.system_keyname%
├── pt_br/
│   ├── example.yml
│   ├── menus/
│   │   └── main.yml
│   └── messages/
│       └── system.yml
└── th_th/
    └── example.yml

Key Resolution Rules

File Location	Key in YAML	Resulting Placeholder
langs/en_us/example.yml	welcome	%lang_welcome%
langs/en_us/menus/main.yml	title	%lang_menus.main_title%
langs/en_us/messages/system.yml	greeting	%lang_messages.system_greeting%
langs/en_us/systems/board.yml	money	%lang_systems.board_money%

Tip: All keys are case-insensitive. %lang_Welcome% and %lang_welcome% resolve to the same translation.

---

Next: Examples