NexusMods Integration

NexusMods Integration

Setup

1. Get your API key from nexusmods.com/users/myaccount?tab=api
2. Open Edit → Settings and paste the key into NexusMods API Key
3. Click Save

The key is stored XOR+base64 obfuscated in the JSON config file (not plaintext, not strongly encrypted — treat your config file as sensitive).

Browsing mods

File → Browse NexusMods opens a card-grid search dialog.

• Type a mod name to search. Results show mod thumbnails (loaded asynchronously with local disk cache), author, download count, and endorsements.
• Search uses the NexusMods GraphQL v2 API (nameStemmed: MATCHES) as the primary path, falling back to the Elasticsearch search endpoint.
• Click a card to see file listings. Files marked OLD_VERSION or ARCHIVED are hidden automatically.

Downloading and opening

From the mod file listing:

• Download & Open in Editor — available for .esp, .esm, .esl plugin files and .ba2/.zip/.7z archives containing string files. The file is downloaded, extracted if needed, and opened directly in the editor. The dialog closes automatically.
• Other file types can be downloaded to disk for manual use.

Uploading translations

File → Upload to NexusMods opens the upload dialog.

The uploader uses the NexusMods v3 multipart upload protocol:

1. Request presigned S3 URLs
2. Upload file chunks to S3
3. Finalise the upload
4. Poll for processing completion
5. Attach file metadata (name, version, description, category)

Set the File Group ID in Settings (found on the mod's Files tab → ⋯ → API Info) to attach uploads to an existing file group (e.g., a "translations" group).

Notes

• The NexusMods API requires a free account. Premium is not required for search and download.
• The GraphQL endpoint may fail DNS resolution on some networks. The Elasticsearch fallback handles this case automatically.
• Thumbnail images are cached locally to avoid repeated downloads on repeated searches.