4 releases (2 breaking)

0.7.0-beta Jan 28, 2022
0.6.0-beta Jan 24, 2022
0.5.1-beta Jan 22, 2022
0.5.0-beta Jan 22, 2022

#737 in Games

Custom license

16KB
279 lines

Another Factorio Mod Downloader?

Yeah, I've had tons of trouble getting other downloaders to work. I'm not sure why, and it was more fun to write my own than debug someone else's.

Note, that this program is intended for Headless Servers. I don't know how it will work for a regular client.

Installation

## from crates.io
$ cargo install facmod-rs

## from Github
$ cargo install --git https://github.com/ngraham20/facmod-rs

## manually from source
$ cargo install --path <path_to_repo>

Config YAML

Instead of specifying each parameter manually as a command argument, you may instead use a config file (yaml), as shown below. Any command arguments specified along side -c <CONFIG> will override those specified in the config file. This allows the config file to be used as defaults, while still retaining the ability to make manual changes.

username: "default"
api_token: "default"
mod_dir: "/opt/factorio/server/mods/"
mod_list:
- first_mod
- second_mod

username

This is your Factorio username.

api_token

You can find your token at https://factorio.com/profile. Just click reveal to see it. While this is safer to use than a password, it's still sensitive information, so make sure to lock down user privilages to the config file so this isn't leaked.

mod_dir

This is the path to the mods directory. Using the absolute path is best, but relative paths do work.

mod_list

This should be using the url version of the mod name. For example, if downloading https://mods.factorio.com/mod/space-exploration, then the name would be space-exploration.

Dependencies

~14–31MB
~426K SLoC