kaledis.toml

The kaledis.toml file is the heart of your project configuration. It replaces the traditional conf.lua.

Schema

"$schema" = "./kaledis.schema.json"

The schema enables autocompletion and validation in editors like VS Code.

Global Options

Option	Type	Description
experimental_hmr	boolean	Enables Hot Module Replacement (HMR) for faster development iteration.

[project]

Configures global project settings.

Key	Type	Default	Description
name	string	"Untitled"	The name of your project. Used for window title if not specified, and build artifacts.
love_path	string	(Auto-detected)	Path to the love.exe executable or directory.
asset_path	string	None	Path to your assets directory (e.g., "assets").
src_path	string	None	Path to your source code directory (e.g., "src").
detect_modules	boolean	false	If true, automatically detects used Love2D modules.
modules	string[]	All	Manual list of Love2D modules to enable (e.g., ["graphics", "audio"]) if detect_modules is false.
entry_point	string	"main"	The main entry file (without extension).

[window]

Configures the game window.

Key	Type	Default	Description
title	string	"Untitled"	The window title.
icon	string	None	Path to the window icon file.
width	integer	800	Window width.
height	integer	600	Window height.
resizable	boolean	false	Whether the window is resizable.
min_width	integer	1	Minimum window width.
min_height	integer	1	Minimum window height.
fullscreen	boolean	false	Whether to start in fullscreen mode.
vsync	boolean	true	Vertical sync.

[audio]

Configures audio settings.

Key	Type	Default	Description
mixwithsystem	boolean	true	Whether audio mixes with the system audio.
mic	boolean	false	Request microphone permission (Android/Mobile).