TheoTown file structure

[reindeerwheat]

Up to date as of 1.12.74

0-9, A-Z

• Show

  📂 managed plugins

  Where only plugins downloaded from the plugin store in-game are stored. They should always end with .mpf.

  • Core_integration_<..>.mpf
  • DSA_Game_Integration_<..>.mpf

  .mpf files are encrypted and are associated with the forum account that was signed in the game at the time of creation (at the time you downloaded the plugins from the store). They will be ignored if you aren't signed in to the same account. This restriction exists to combat potentially unauthorised plugin sharing/usage.
• maps: Where your single cities (which aren't located in a region) are stored. City files can be any name but should end with .city.
• music: Where the game's music are stored. You can also import other songs to be played in-game: viewtopic.php?t=6061.
• Show

  📂 plugins

  Where external plugins downloaded from outside the plugin store should be stored. They are usually found at viewforum.php?f=43(<-- please read the security notice linked there), GitHub, unofficial TT community Discord servers (may require an invite link from insiders), or around the internet.

  • pluginA*
  • Show

    📂 sample

    • plugin.manifest
    • sample_dsc.json
    • 🖼 sample_dsc.png
    • 🖼 sample_winter_dsc.png
  • encryptedA.plugin*
  • encryptedB.ttplugin*
  • error.log: Last plugin error encountered (e.g. invalid JSON syntax, duplicate IDs).
  • jsonOnlyPlugin.json*
  • pluginB.zip*
  • pluginC.zip*
  • README.txt

  *For illustration purposes only; they aren't actually included by default.
• Show

  📂 regions

  Where your regions are stored.

  • Show

    📂 default

    • X_Y.city*: City files' name here should always follow this fornat, "7_4.city" for example. "X" and "Y" are unsigned integer coordinates where a city should be positioned in a region, starting from the bottom-left corner. (viewtopic.php?p=15384#p15384)
    • region.json

    *For illustration purposes only.
  • flatearth: Same structure as default.
  • tributaries: Same structure as default.
• scenarios: Where scenarios for limited time events (unless I get corrected for this otherwise) are stored. Scenarios are also (single) cities and their file names should end with .city.
• key_mapping.json: Where keybinds for the game's functions are stored.
• crash.txt, log.txt, and out.txt: For debugging purposes.
• settings.json: Where the game's settings are stored.

How to access:

• Show

  Built-in file manager

  

  

  

• Show

  Android

  /storage/emulated/0/Android/data/info.flowersoft.theotown.theotown/files
  

  Show

  Can't access Android/data?

  https://play.google.com/store/apps/deta ... marc.files

  

  Alternatively, you can access these files on your PC once you connected it with your device (via USB for example).
• Show

  iOS

  You can access the files via the Files app or, when the device is connected to a Mac, in the storage location for your device in the finder. Search for TheoTown.
• Windows: C:\Users\<insert usernane>\TheoTown
• macOS/Linux: /home/TheoTown or ~/TheoTown

Did you know: ".." represents a parent directory, so "plugins/dirA/dirB/../dirC" is just "plugins/dirA/dirC" and so on.