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

Clone

git clone  https://codeberg.org/cyberegoorg/cetech1.git

zig build init

Get ZIG

Get ZIG 0.15.1.

Get ZVM

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

Install via VSCode plugin or use ZVM.

NVim

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

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

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)

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_studio=`	`true` or `false`	`true`	Build with studio 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_studio --asset-root fixtures/test_graph/

# Desktop mode
zig-out/bin/cetech1_test && zig-out/bin/cetech1_studio --asset-root fixtures/test_graph/

# Standalone
zig-out/bin/cetech1_studio --fullscreen --asset-root fixtures/test_graph/

zig-out/bin/cetech1_test.exe && zig-out/bin/cetech1_studio.exe --asset-root fixtures/test_graph/

Args	Value	Default	Description
`--asset-root`	`str`	`null`	Path to asset root. (project path)
`--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.
`--worker-count`	number	CPU count	Max threads for task system.
`--renderer`	`bgfx_metal`, `bgfx_vulkan`, `bgfx_dx12`, `bgfx_noop`	Autoselect best	Render backed.
`--renderer-debug`	`1` or `0`	`0`	Render backed debug. (shaders)
`--renderer-profile`	`1` or `0`	`0`	Render backed profile. (shaders)
`--headless`	`1` or `0`	`0`	Without creating real window.
`--vsync`	`1` or `0`	`0`	Vsync.
`--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.

Tracy profiler

CETech1 has builtin support for tracy profiler and provide Tracy as submodule, but you must build it first.

            git submodule update --init externals/shared/repo/tracy
            cd externals/shared/repo/tracy
            cmake -B profiler/build -S profiler -DCMAKE_BUILD_TYPE=Release
            cmake --build profiler/build --parallel --config Release
        

            git submodule update --init externals/shared/repo/tracy
            cd externals/shared/repo/tracy
            cmake -B profiler/build -S profiler -DCMAKE_BUILD_TYPE=Release
            cmake --build profiler/build --parallel --config Release
        

            profiler/build/tracy-profiler -a localhost
            zig-out/bin/cetech1_studio # on separate terminal
            # Have fun
        

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

16 March 2026