config - nesbox/TIC-80 GitHub Wiki

config Open config.tic file in the code editor to configure TIC-80.
config [reset | default]

Parameters

  • reset reset current configuration file.
  • default edit default cart template.

Description

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

config_demo

The config command also allows to edit the Hello World default cart thanks to the default parameter.

Configuration 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

config_color

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, palette as well as sprites like the cursor or the fonts.

config_editors_demo

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.

custom_tab

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

Themes

You can deeply modify your configuration file by editing the palette, sprites, font, SFX and parameters 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 path to the config.tic file is displayed by the config command. This path is .local/<version_number>/ in 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.