Skip to content

explosivegaming/scenario

Repository files navigation

logo
Release Downloads Star Fork CodeFactor Discord

ExpGaming Scenario Repository

Explosive Gaming

Explosive Gaming (often ExpGaming) is a server hosting community with a strong focus on Factorio and games with similar themes. We are best known for our weekly reset Factorio server with a vanilla+ scenario where we add new features and mechanics that are balanced with base game progression. Although our servers tend to attract the more experienced players, our servers are open to everyone. You can find us through our website, discord, or the public server list with the name ExpGaming.

Use and Installation

  1. Download our git repository for the latest version. For a stable release you can download from our stable branch. See releases for other major releases.

  2. Extract the downloaded zip file into your Factorio scenario directory:

    • Windows: %appdata%\Factorio\scenarios
    • Linux: ~/.factorio/scenarios
  3. Within the scenario you can find ./config/_file_loader.lua which contains a list of all the modules which will be loaded by the scenario. Comment out (or delete) lines for features you do not want. Be aware modules may load other modules as dependencies even when removed from the list.

  4. More advanced users can adjust other configs files within ./config but some files will require a basic understanding of lua.

  5. Once you have made your config changes: open Factorio, select either single or multiplayer, select (host) new game, and finally select our scenario which will be called scenario-stable or scenario-dev under user scenarios.

  6. You will now be asked to generate your map and the scenario will load all selected modules. If any module does not load as expected please check factorio-current.log in your Factorio directory for errors and report them on our issues page.

Contributing

All are welcome to make bug reports, feature requests, and pull requests for our scenario. We do not require you to have any lua or coding knowledge to make bug reports and feature requests. If you have any questions ask us in our discord.

For developers wanting to add features please follow these guidelines:

  • All code is documented using ldoc, the end result can be found here.
  • Changes should be made on your own fork and merged into dev through a pull request.
  • Each pull request should be limited to one feature or a few bug fixes.
  • Pull requests are automatically checked for lint and documentation errors.
  • Pull requests are manually reviewed to maintain code and language quality.
  • New features should have the branch names: feature/feature-name
  • Bug fixes should have the branch names: fix/bug-name
  • Commits should have meaningful messages.

About our versioning and branch structure:

  • Versions track changes to the stable branch and are managed by organisation members.
  • Versions to not track changes on the dev branch which may contain some critical bugs.
  • Other branches may exist for alternative version of our scenario, these are not versioned.
  • Major releases contain significant changes to core modules.
  • Minor releases contain many new features and bug fixes.
  • Patch releases are only used for critical bugs.

Releases

Release* Release Name Factorio Version**
6.4 Farewell Factorio 1.1 1.1.110
6.3 Feature Bundle 2: Electric Boogaloo 1.1.101
6.2 Mega Feature Bundle 1.1.32
6.1 External Data Overhaul 1.0.0
6.0 Gui / 0.18 Overhaul 0.18.17
5.10 Data Store Rewrite 0.17.71
5.9 Control Modules and Documentation 0.17.63
5.8 Home and Chat Bot 0.17.47
5.7 Warp System 0.17.47
5.6 Information Guis 0.17.44
5.5 Gui System 0.17.43
5.4 Admin Controls 0.17.32
5.3 Custom Roles 0.17.28
5.2 Quality of life 0.17.22
5.1 Permission Groups 0.17.13
5.0 0.17 Overhaul 0.17
4.0 Softmod Manager 0.16.51
3.0 0.16 Overhaul 0.16
2.0 Localization and clean up 0.15
1.0 Modulation 0.15
0.1 First Tracked Version 0.14

* Scenario patch releases have been omitted and can be found here.

** Factorio versions show the version they were made for, often the minimum requirement to run the scenario.

License

The Explosive Gaming codebase is licensed under the GNU General Public License v3.0