Tutorial:Modding FAQ

From Official Factorio Wiki
Revision as of 21:29, 26 June 2015 by JorgenRe (talk | contribs) (→‎Modding FAQ: Edited how to fix when recipies and technologies are changed to make it compatible with multiplayer games.)
Jump to navigation Jump to search

Modding FAQ

< Main Page

Welcome to the modding FAQ. (work in progress) Here we have a list of questions that are common to get while writing a mod. And the fix for the problem (if someone managed to find a fix) feel free to edit this page and add more Q and A's.

Questions / Fix
  • Q : Why do I get the error "C:\Factorio\mod doesn't match the expected mod_version# (case sensitive!)" error?
  • Fix :
For some reason, the folder name of your mod must include the version
number.  So if your mod is tittled "myMod" version 0.0.1, in order
for Factorio to read it, the folder must be titled "myMod_0.0.1".
Questions / Fix
  • Q : my item / entity wont load the sprite I made.
  • Fix :
Make sure your path is right : __mod-name__/map-name/2nd-map-name/sprite.png
Pay attention to case, the following file is not the same as previous:__Mod-name__/Map-name/2nd-map-name/sprite.PNG
  • Q : The name of my item is displayed as "Unknown key: item-name.yourname"
  • Fix :
Make sure you have valid locale mappings. Create a "locale" directory with an "en" subdirectory and create a "item-name.cfg" file.
It should contains something like:
 [item-name]
 itemx=Item X
 itemy=Item Y
 
 Do the same for your entities, but put them in an "entity-name" section/file.
  • Q : What does ('=' character not found in line) mean?
  • Fix :
If you get the error message '=' character not found in line , chances are you 
created a new document as something other than a .txt file, adding in format text
to  the document that is causing this error.  Copy the contents of your .cfg file
and make a new .txt file, rename it to .cfg, and paste your configuration into it.
  • Q : Error while loading prototype "entity-name": No such node (pictures).
  • Fix :
Make sure your entity contains the right amount of lines for that type of entity, 
for example a chest needs 1 picture for the entity to work but a wall needs 20. 
Look in the factorio base/prototypes/entity/entity.lua.
And you can see that different entities need different amounts of pictures.


  • Q : I've modified the recipe and/or technology prototypes and when I load my save game the changes aren't there even though it works in a new game.
  • Fix : You need to run
    for i, player in ipairs(game.players) do player.force.resetrecipes() end
    and/or
    for i, player in ipairs(game.players) do player.force.resettechnologies() end

To make Factorio reload the prototypes, this can be done using the console (~) or via the game.oninit event in control.lua (which will run when the mod is first added to a game), or through migration files (if you've made a mod release and need to 'migrate' user's saves to a new version automatically). The first is the easiest while testing, the second when you're releasing a mod for the first time, and the third for when you've already made a mod release. The prototypes are saved in the save file so as to (eventually) allow making changes to them during runtime (control.lua), which is why they need to be 'reset' for saves.