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.
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
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.
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 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.