Contributing

Workflow

• Work on feature branches and open pull requests against main.
• Use Conventional Commit format for commit messages and pull request titles.
• Include user-facing release notes in pull request bodies.
• Keep plugin repositories as thin wrappers around reusable workflows in XelsDalamud.Workflows.
• Do not publish to the official Dalamud plugin repository from this organization.

Release Boundary

PR preview builds may only update testing fields:

• TestingAssemblyVersion
• TestingChangelog
• TestingDalamudApiLevel
• DownloadLinkTesting

Manual stable release workflows may update stable fields:

• AssemblyVersion
• DownloadLinkInstall
• DownloadLinkUpdate
• stable release metadata

Do not share feed update paths unless the mode is explicit and enforced.

Validation

Run the repository-specific validation commands from its AGENTS.md before requesting review. For plugin repositories, local builds usually require Dalamud dev assemblies through DALAMUD_HOME or the local XIVLauncher fallback path.