reformat docs

This commit is contained in:
David Andersen 2016-04-14 22:48:52 -07:00
parent 199f6c7f59
commit 2fc2b7656d

View File

@ -4,8 +4,8 @@
[![](https://badge.imagelayers.io/dtandersen/factorio:latest.svg)](https://imagelayers.io/?images=dtandersen/factorio:latest 'Get your own badge on imagelayers.io')
What is Factorio?
=====
# What is Factorio?
[Factorio](https://www.factorio.com) is a game in which you build and maintain factories.
You will be mining resources, researching technologies, building infrastructure, automating production and fighting enemies. Use your imagination to design your factory, combine simple elements into ingenious structures, apply management skills to keep it working and finally protect it from the creatures who don't really like you.
@ -14,11 +14,7 @@ The game is very stable and optimized for building massive factories. You can cr
NOTE: This is only the server. The game is available on [Steam](http://store.steampowered.com/app/427520/).
Current Version
-----
0.12.30
### Features
# Features
* Automatically takes latest save or autosave when restarting the container.
* Volumes for saves and mods
* Set autosave interval and number of saves.
@ -26,14 +22,12 @@ Current Version
* Enable/disable console commands in game.
* Based on Alpine Linux.
Versions
-----
If you need to use an older version, checkout out the different [tags](https://hub.docker.com/r/dtandersen/factorio/tags/).
# How to use this image?
## Quick Start
This runs factorio with default settings, and your save will be kept:
How to use this image?
-----
### I just want to play !
This runs factorio with default settings, and your save will be kept :
```
docker run -d \
-v [PATH]:/opt/factorio/saves \
@ -43,15 +37,19 @@ docker run -d \
* Where [PATH] is a folder where you'll put your saves, if there already is a save in it with the string "save", that one will be taken by default, otherwize, a new one will be made.
* Where [PORT] is the port number you choose, if you're going to launch it on your local machine, don't use the port 34197, take another one at random.
### Advanced usage
#### Without map persistence
## Advanced usage
### Without map persistence
```
docker run -d \
-p [PORT]:34197/udp \
dtandersen/factorio
```
This will generate a new random map with default settings.
#### With map persistence
### With map persistence
```
docker run -d \
-v [PATH]:/opt/factorio/saves \
@ -60,7 +58,9 @@ docker run -d \
```
This will generate a new random map with default settings and save it onto the volume.
Replace [PATH] with a path to a folder on the host where the map will be saved.
#### With existing map
### With existing map
```
docker run -d \
-v [PATH]:/opt/factorio/saves \
@ -68,8 +68,10 @@ docker run -d \
dtandersen/factorio
```
It's the same as above, it takes the last modified file which contains the word save in the filename as current save when booting the server. This allows when upgrading the container to take the last save, you don't have to rename the last autosave as save.zip
#### Autosave interval
You can set the autosave interval. By default it is set at 2 minutes bud you can change it by launching the container with the "FACTORIO_AUTOSAVE_INTERVAL" variable to whatever suits you best.
### Autosave interval
You can set the autosave interval. By default it is set at 2 minutes bud you can change it by launching the container with the `FACTORIO_AUTOSAVE_INTERVAL` variable to whatever suits you best.
```
docker run -d \
--env FACTORIO_AUTOSAVE_INTERVAL=[NUMBER] \
@ -77,8 +79,10 @@ docker run -d \
dtandersen/factorio
```
Where [NUMBER] is the number of minutes between autosaves.
#### Autosave slots
You can set the number of autosave slots. By default it is set at 3 slots bud you can change it by launching the container with the "FACTORIO_AUTOSAVE_SLOTS" variable to whatever suits you best.
### Autosave slots
You can set the number of autosave slots. By default it is set at 3 slots bud you can change it by launching the container with the `FACTORIO_AUTOSAVE_SLOTS` variable to whatever suits you best.
```
docker run -d \
--env FACTORIO_AUTOSAVE_SLOTS=[NUMBER] \
@ -86,7 +90,9 @@ docker run -d \
dtandersen/factorio
```
Where [NUMBER] is the number of autosave slots.
#### Mounting mod volume
### Mounting mod volume
As everybody knows about factorio is you can add mods to it. Now you can also do it in this docker image by mounting a volume.
```
docker run -d \
@ -95,16 +101,20 @@ docker run -d \
dtandersen/factorio
```
Where [PATH] is the path to the folder with your mods.
#### Allowing in-game commands
I've always disabled in-game commands because I think it is like cheating, however, you can enable them by setting the the "FACTORIO_DISSALOW_COMMANDS" variable to "false".
### Allowing in-game commands
I've always disabled in-game commands because I think it is like cheating, however, you can enable them by setting the the `FACTORIO_DISSALOW_COMMANDS` variable to "false".
```
docker run -d \
--env FACTORIO_DISSALOW_COMMANDS=false \
-p [PORT]:34197/udp \
dtandersen/factorio
```
#### Activating no-auto-pause in the game when no one is on the server
I do not recommend this feature, bud it can make the game more difficult if you're up for a challenge :-). Just set the "FACTORIO_NO_AUTO_PAUSE" variable to "true".
### Activating no-auto-pause in the game when no one is on the server
I do not recommend this feature, bud it can make the game more difficult if you're up for a challenge :-). Just set the `FACTORIO_NO_AUTO_PAUSE` variable to "true".
```
docker run -d \
--env FACTORIO_NO_AUTO_PAUSE=true \
@ -112,6 +122,6 @@ docker run -d \
dtandersen/factorio
```
### Credits
# Credits
Based on [Zopanix' Factorio Server](https://github.com/zopanix/docker_factorio_server).