Anarkis Gaming Wiki

Documentation Center for our games and mods

User Tools

Site Tools

[ Wiki Home ] - [ Anarkis Gaming Studio ] - [ Forums ] - [ Unending Galaxy Manual ]


atc:mods:making_mods

This is an old revision of the document!


Getting Started

After The Collapse is a fully moddable game. A very large part of the game is contained in our data, written in human readable JSON text files. Additionally, code can by added via Lua. We also provide an infrastructure to easily add, create and remove mods.

Mod File Structure

Mods, when not on steam, are meant to be put in the {game path}\mods\your_new_mod sub-folder. Each mod goes in its own sub-folder. The game allows you to create a blank mod easily directly from the “Mods” menu on the main screen:

It will create the very basic structure for your mod like this:

 MyMod
 |-> config.json    <- config file describing the mod, with name, description, version number. Required.
 |-> main.lua       <- Lua entry point if you want to alter the game's logic. Optional.
 |-> files/         <- Folder containing data files you want to add or modify. Required.
     |-> data/      <- contains game/data files to add or override (items, objects, npc, tech, etc.). Optional (add it manually).
     |-> Content/   <- contains game/Content files to add or override (images, textures, sfx, music). Optional (add it manually).

Files placed in the files/ folder will be included in the game granted you respect the same folder structure we're using.

NB: The ability to add or overwrite the game's content, is a feature we call ModFS and we'll be referring to whenever used.

Adding or Editing Data

Granted you respect the format and the file structure, you can pretty much add or modify anything existing in the game. For example: if you wanted to override the properties of the lettuce seeds, you would have to create data/items/seeds/lettuce.json within the files/ folder. Your mod folder would then look like this:

 MyMod
 |-> config.json
 |-> files/data/items/seeds/
     |-> lettuce.json

We'd advise you, no matter if your intent is to override some data or add new one to use files from the base game as examples. Copy them, rename them (if adding stuff), alter them. So far, so good. Of course, it might take a little while to figure what each line in each file does, but we'll be happy to provide some explanation on the discord or steam forums.

Adding or Editing Content

By content we mean images, sprites, sound effect and music tracks. Content can be overridden or added just like with data.

A few ground rules:

  • Textures must be in png, we technically accept jpg/jpeg files too but that's not something you should use unless your really know what you're doing
  • Sound files must be ogg, wma, mp3 or wav files and will be auto-magically
  • Sound files in files\Content\sfx\ will be processed as effects, sound files in any other folder will be considered songs.

Any textures and/or sounds that are part of your mod must be built by the game's engine. This is automatically done at run-time and will convert your images and sounds in the required .xnb file format. The game will only build content without a matching .xnb, so delete the compiled file whenever you change something in your source.

Lua API

The version of the documentation relevant to your version of After the Collapse is available in mods/MQDoc.chm. The bleeding-edge documentation is available at https://collapse.cutie.cafe/doc.

A few useful terms:

  • Mannequin is the name of the modding framework that was developed for After the Collapse by Alexandra.
  • ModFS is a subset of Mannequin that creates a layer over the way the game loads files, to allow for overwriting & addition

Steam Workshop

Please note that the Workshop uploading tool is available for Steam customers only. Customers from other store can either use the Steam activation code they received, or upload their mods to the IndieDB mod section.

We have included a tool to upload your mods to the Steam Workshop easily. It's located in the Workshop subfolder of your installation. ({steam path}\steamapps\common\AfterTheCollapse\Workshop). It's called TakeThree.

Make sure to have accepted the Steam Workshop Legal agreement before trying to upload a mod. After that, it's simply a matter of filling out all of the fields, and you will have your mod available on the Workshop. Note that the program also offers the option to update a mod you've previously uploaded.

Once uploaded, you'll be given a link to your creation, you can further edit the description, add pictures, link to your social media account from there.

NB: Mods uploaded to the Steam Workshop must follow the Steam Subscriber Agreement, Steam Workshop Legal Agreement, and Anarkis Gaming Workshop rules. We reserve the right to remove any mod that we would deem dangerous, illegal or damaging for the game.

atc/mods/making_mods.1540852662.txt.gz · Last modified: 2018/10/29 23:37 by serialkicked