Mod Repositories
Add a repository URL in settings and Nx86 will list its available mods for browsing, installation, and updates. Repositories are index files with metadata, download URLs, and checksums.
The official Nx86 mod index is maintained through pull requests and reviewed for metadata correctness and license compliance before merging. Being listed means the entry passed a structural review: not that the mod's behavior has been verified.
Repository entry fields
| Field | Description |
|---|---|
| mod ID | Matches the id field in nxmod.toml. |
| name | Display name. |
| version | Published version. |
| author | |
| license | |
| target Title ID | |
| target Build ID | May list multiple. |
| source repository | URL of the mod's upstream source. |
| download URL | Direct URL to the .ndx release asset. |
| checksum | SHA-256 of the download asset. Verified after download. |
| screenshots | |
| cache impact | Declared cache.impact from the manifest. |
| trust metadata | Whether the mod requires native code, Lua, network, or filesystem access. |
For GitHub-backed indexes, Nx86 uses the GitHub API to read release metadata, check for updates, and download assets. Index responses are cached and only re-fetched when you explicitly check for updates.