Skip to content
Cluaupp Cluaupp

Getting started

Cluaupp is the game toolchain. CL++ is the language.

Requirements

Section titled “Requirements”
  • Node.js 18 or newer
  • Rojo 7.7.0 (cluaupp init writes rokit.toml)
  • clpp 0.3.2 on PATH from KartzRbx/CLPP (clpp-setup.exe then clpp setup). Override with CLPP or CLPP_PATH.
Terminal window
cargo install --path .   # inside a CL++ checkout
clpp setup             # VS Code / Cursor language pack

Install Cluaupp

Section titled “Install Cluaupp”
Terminal window
npm install -g cluaupp@latest
cluaupp --version

Need 1.4.0+. A leftover global 1.3.0 still writes src/server / src/client / src/shared. Upgrade, then init into a new folder.

Or:

Terminal window
npx cluaupp init my-game

First game

Section titled “First game”
Terminal window
cluaupp init my-game
cd my-game
rokit install
cluaupp build
rojo serve
my-game/
  cluaupp.config.json
  default.project.json
  src/
    ReplicatedStorage/Shared/Constants/Datas/TemplateData.clh
    ServerScriptService/Boot/DataBoot.server.clpp
    ServerScriptService/Handlers/PlayerHandler.server.clpp
    ReplicatedStorage/Shared/Net/Net.flare
    StarterPlayer/StarterPlayerScripts/Controllers/DataController.client.clpp
    StarterPlayer/StarterCharacterScripts/Character/CharacterReady.client.clpp
  out/                    ← generated Luau (do not edit)
  libs/                   ← CluauppLibs

Tiny program

Section titled “Tiny program”
#include <clpp/roblox.clh>


void init() {
  Players players = GetService<Players>();
  post("online: " .: players.GetPlayers());
}

Language course and reference: kartzrbx.github.io/CLPP. Migrating .cpp: migration.