Testing Resources

From Armagetron

So you have written a new resource and would like to test it? Then you have come to the right place :)

Save it

Resource directory

Resources that should be available to a specific user are stored in

  • Linux — <home>/.armagetronad/resource
    • Example: /home/Joe/.armagetronad/resource
  • Windows — <appdata>\Armagetron\resource
    • Example: C:\Documents and Settings\Joe\Application Data\Armagetron\resource
  • Mac OS X — <home>/Library/Application Support/Armagetron Advanced/resource
    • Example: /Users/Joe/Library/Application Support/Armagetron Advanced/resource

Resources that should be available to all users of a computer are stored in

  • Linux — /usr/share/games/armagetronad/resource
  • Windows — C:\Program Files\Armagetron Advanced\resource
  • Mac OS X — Armagetron Advanced.app/Contents/Resources/resource


  • Linux — ~/.armagetronad/resource
  • Windows — C:\Program Files\Armagetron Advanced\resource
  • Mac OS X — ~/Library/Application Support/Armagetron Advanced/resource


Inside the resource directory, resources are located at


where type, name, version, author and category must match those stated in the resource:

<Resource type="..." name="..." version="..." author="..." category="...">

In windows, the subdirectories must be seperated by '\', not '/'.

Tell Armagetron to use it

by setting the configuration item

  • MAP_FILE (for maps)
  • COCKPIT_FILE (for cockpits)



(note that you have to use '/' regardless of whether you use windows)

Configuration items can be set using the console or by editing a configuration file. The configuration file shared by all users on the computer is located at

  • Linux — /usr/etc/games/armagetronad/settings.cfg
  • Windows — C:\Program Files\Armagetron Advanced\config\settings.cfg
  • Mac OS X — Armagetron Advanced.app/Contents/Resources/settings.cfg

or is it (FIXME)

  • Linux — ~/.armagetronad/config/settings_custom.cfg
  • Windows — C:\Program Files\Armagetron Advanced\config\settings_custom.cfg
  • Mac OS X — ~/Library/Application Support/Armagetron Advanced/config/settings_custom.cfg

Settings in this file may be overridden for a specific user in the file

  • Linux — <home>/.armagetronad/var/autoexec.cfg
  • Windows — <appdata>\Armagetron\var\autoexec.cfg
  • Mac OS X — <home>/Library/Application Support/Armagetron Advanced/autoexec.cfg

You may have to create the override file since it is not created automatically.

Run Armagetron

Now its time to play Armagetron Advanced locally.

If you have saved it wrong or the path you put is incorrect it will tell you.

If your settings or code is wrong it will also tell you a line number.