narrowtux / SmartModInserter

Manages mods for factorio
GNU Lesser General Public License v3.0
38 stars 12 forks source link
factorio mod mod-manager

Smart Mod Inserter

This is a smart mod manager for factorio. It will allow you to create modpacks and later launch factorio with the mods of those modpacks with a single click.

Features

An incomplete list of features. Features marked with a * are only available in the indev version.

Future features

Download and Install

To download, head over to the releases page. From there, select a release and download the appropriate file.

The .jar files are recommended for everyone, however, for OS X users there will be special .app bundles available starting with version 0.3. Additionally to the benefit of having an app-bundle, it will allow you to click the Install links on factoriomods.com.

To run, you need the Java Runtime Environment with version 8 u 40 or higher. Windows users should vary as to not install any unwanted 3rd party software along with Java. To fully prevent installing Ask-Toolbar and the like, usage of this ninite installer package is recommended.

If you have Java installed, simply opening the .jar or .app is enough to launch Smart Mod Inserter.

Linux Users

JavaFX is required and may not be installed by default. On Ubuntu, you can fix this by installing these packages:

sudo apt-get install openjdk-8-jre openjfx libopenjfx-java

First launch

Upon first launching Smart Mod Inserter, it will probably ask you to define the factorio application path and the data path. On some setups, it will automatically be able to figure out some of those paths. Until you have all necessary paths selected, the close button will stay disabled.

After all paths have been defined, Smart Mod Inserter will move all mods found in <datadir>/mods/ to <datadir>/fmm/mods/ and create a modpack titled Default containing those mods. You can edit the name if you want.

If you put mods into the <datadir>/mods/ folder after that, they will also be moved to <datadir>/fmm/mods/, if they don't already exist in that folder.

Compile

To compile, you need at least JDK 1.8_40 and maven.

After executing

    mvn clean package

from the command line, you'll have a .jar file in the target/ directory.

OS X

A special build plugin is configured to create an OS X .app bundle. To create this, use maven with the appbundle:bundle goal.

License

This project is licensed under the GNU Lesser General Public License, Version 3