Getting started

Supported architectures

<ARCH>	Description
`x86_64-macos`	Apple Intel
`aarch64-macos`	Apple Arm
`x86_64-linux`	Linux, SteamDeck
`aarch64-linux`	Linux ARM
`x86_64-windows`	Windows

Prerequisite

Get ZIG

Get ZIG 0.14.0.

Get ZVM

            # zvm vmu zig mach - only for mach versions
            zvm i 0.14.0
        

Clone

git clone  https://github.com/cyberegoorg/cetech1.git

zig build init

Build

zig build

zig.exe build

Args	Value	Default	Description
`-Ddynamic_modules=`	`true` or `false`	`true`	Build all modules in dynamic mode.
`-Dstatic_modules=`	`true` or `false`	`false`	Build all modules in static mode.
`-Dwith_samples=`	`true` or `false`	`true`	Build with sample modules.
`-Dwith_editor=`	`true` or `false`	`true`	Build with editor modules.
`-Dwith_tracy=`	`true` or `false`	`true`	Build with tracy support.
`-Dwith_nfd=`	`true` or `false`	`true`	Build with NFD (native file dialog)
`-Dnfd_portal=`	`true` or `false`	`true`	Build NFD with xdg-desktop-portal instead of GTK. Linux, nice for SteamDeck

Run

zig-out/bin/cetech1_test && zig-out/bin/cetech1 --asset-root fixtures/test_asset/

# Desktop mode
zig-out/bin/cetech1_test && zig-out/bin/cetech1 --asset-root fixtures/test_asset/

# Standalone
zig-out/bin/cetech1 --fullscreen --asset-root fixtures/test_asset/

zig-out/bin/cetech1_test.exe && zig-out/bin/cetech1.exe --asset-root fixtures/test_asset/

Args	Value	Default	Description
`--load-dynamic`	`1` or `0`	`1`	Load dynamic modules?
`--max-kernel-tick`	`n`	`null`	Quit after kernel make n ticks.
`--max-kernel-tick-rate`	`n`	`60`	Kernel frame rate.
`--headless`	`1` or `0`	`0`	Without creating real window.
`--asset-root`	`str`	`null`	Path to asset root. (project path)
`--fullscreen`	`1` or `0`	`0`	Force full-screen mode, nice for SteamDeck.
`--test-ui`	`1` or `0`	`0`	Run UI tests and quit.
`--test-ui-filter`	`str`	`all`	Run only ui tests that pass this filter.
`--test-ui-speed`	`fast`, `normal`, `cinematic`	`fast`	UI test speed.
`--test-ui-junit`	`str`	`null`	UI test JUnit result filename.

ZLS

CETech provide ZLS as submodule, but you must build it.

            git submodule update --init externals/shared/repo/zls
            cd externals/shared/repo/zls
            zig build -Doptimize=ReleaseFast
        

            git submodule update --init externals/shared/repo/zls
            cd externals/shared/repo/zls
            zig.exe build -Doptimize=ReleaseFast
        

VSCode

Create vscode configs.
# This generate vscode launch.json with predefined cases # create or update settings.json # and set zls path to locally builded zig build gen-ide -Dide=vscode
Install extension ziglang.vscode-zig (or install all recommended)

Fleet

Create fleet configs.
# This generate fleet run.json with predefined cases # create or update settings.json # and set zls path to locally builded zig build gen-ide -Dide=fleet

Idea

Need zigbrains

Create idea configs.
# This generate basic files in .idea and run configuration predefined cases # and set zls path to locally builded zig build gen-ide -Dide=idea

Tracy profiler

CETech1 has builtin support for tracy profiler.

            brew install tracy
            tracy -a localhost
            zig-out/bin/cetech1 # on separate terminal
            # Have fun
        

            # install tracy by your way
            tracy -a localhost
            zig-out/bin/cetech1 # on separate terminal
            # Have fun
        

21 June 2025