Organize Config Options Into Sections and Categories

Structuring Your Config Hierarchy

AzusaConfig allows you to group related settings into logical sections. Use nested classes or section annotations to create a clear hierarchy—for example, separate sections for gameplay, visuals, and performance settings.

Adding Descriptions and Comments

Include descriptive text for each setting so players understand what each option does. AzusaConfig preserves these comments in the generated config file, making it self-documenting.

Creating Subsections

For complex mods, create subsections within sections. This prevents a single config file from becoming overwhelming and helps players find relevant settings quickly.

Example Organization

A typical structure might include: general settings (enable/disable the mod), gameplay mechanics (balance values), and advanced options (debug features). Each section should contain only related options.

This organization makes configs easier to maintain and more user-friendly.