System Configuration Cartridge

TIC-80 can be modified by editing the configuration file. Save the file to apply modifications.

Console Commands

`config`         Open config.tic file in the code editor.
`config reset`   Reset config.tic to the default values.

Parameters

Color Parameters

BG     =15, --background
FG     =12, --foreground ie text
STRING =4,
NUMBER =11,
KEYWORD=3,  --function, if, true... 
API    =5,  --TIC, print, cls...
COMMENT=14,
SIGN   =13, --*, -, =, (...
SELECT =14,
CURSOR =2,

Example

Font Parameters

SHADOW =true,
ALT_FONT=false,

ALT_FONT=true sets the small font in the code editor as default.

Delimiters Parameters

MATCH_DELIMITERS=true,
AUTO_DELIMITERS=false,

MATCH_DELIMITERS allows to highlight delimiters matching the one under the cursor.
AUTO_DELIMITERS allows to autocomplete delimiters. When a ( is written, the corresponding ) is added, etc.

Others

CHECK_NEW_VERSION=true

Check if a newer version of TIC-80 exists and displays a message in console if TIC-80 should be updated.

UI_SCALE=4

Sets the size of the TIC80 window at startup.

SOFTWARE_RENDERING=false

Switch from SDLGPU to SDL2 rendering which may be more stable but does not allow to use CRT effect. Linked to issue #1566.

GAMEPAD=
{
  TOUCH=
  {
    ALPHA=180,
  },
},

Sets the transparency of the gamepad buttons showing on screen on Android. The value can be [0,255], 0 is fully transparent and 255 is totally opaque.

Sprites and SFX

You can also change TIC-80 sound effects and sprites like the cursor.

Note: To change a game specific cursor use poke in your code instead.

Custom Tab Character

If you are using indentation-sensitive languages like python, you might want the tab and space characters to be different. You can do so by modifying sprite #265 (and #393 for small font) of the configuration file.

NOTE that it will change how tabs appear everywhere, not only in the code editor.

Themes

You can deeply modify your configuration file to create a theme that you can share with others.

Keeping Configuration after TIC-80 Updates

When TIC-80 is updated to a new version, the configuration file is reset as it can be updated too. In order to keep your previous configuration, you need to copy-paste your previous configuration file to the new version.

The config.tic files are in the .local/<version_number>/ folder of the TIC-80 folder that you can access by typing folder in the console. .local is an hidden folder. Ways to access hidden folders depends on your operating system.