# 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.