File size: 1,892 Bytes
53f7b7a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | # factorio
> Factorio 1.x/2.x mods: zips in the mods folder, internal names, portal API, authenticated downloads.
## Identity
Factorio uses Lua mods distributed as `.zip` files from mods.factorio.com. Dependencies are declared in each mod's `info.json`.
## Mod folder and format
`%APPDATA%/Factorio/mods/` (Windows). Keep mods as `.zip`: NEVER extract them. `mod-list.json` in that folder lists mods and enabled state. Watch for stale duplicate versions of the same mod.
## Sources
Only mods.factorio.com. Internal names differ from display names (for example "Bob's Adjustable Inserters" is `bobinserters`). Some mods are renamed/continued under new names; search before assuming a mod is gone.
- List/lookup: `https://mods.factorio.com/api/mods/<internal_name>/full` (no login needed). Read `releases[]`, filter by `info_json.factorio_version`, pick the newest compatible release. `download_url` starts with `/download/...`.
- Download needs a logged-in account. With `download_file`, give the full URL `https://mods.factorio.com<download_url>`; if the user set FACTORIO_USERNAME and FACTORIO_TOKEN in the environment, the tool adds them automatically (token is in Factorio's `player-data.json`). Never print or ask for the token in chat.
- The user's bookmarked mods are an account-side list (API needs credentials).
## Compatibility
Match `factorio_version` (for example 2.0). Mods marked 2.0 generally work on later 2.x, but check each page. Check `dependencies` in each release's `info_json` and download required ones too.
## Load order
None manual. Dependencies decide order.
## Logs
`%APPDATA%/Factorio/factorio-current.log`. Errors name the failing mod and the missing dependency or the Lua error line.
## Common failures
Missing dependency -> download it from its page. Wrong game version -> pick an older release or another mod. Duplicate versions -> delete the older zip.
|