nixblox

A Nix-based build and deployment system for Roblox games. Nixblox gives you reproducible builds, automated deployment, and a complete CLI workflow — from fetching source assets to publishing your game — all driven by a declarative Nix flake configuration.

Features

• Reproducible builds — Nix flakes ensure fully-specified, deterministic development environments
• Automated deployment — build and publish directly from the command line, no Studio required
• Multi-place management — handle complex projects with multiple places and shared assets
• Asset extraction — automatically pull models, maps, and other assets from source places
• Test integration — run jest-roblox tests as part of your build pipeline

Quickstart

Initialize a new project from one of the templates:

nix flake init -t git+https://git.matt.you/matt/nixblox            # default: minimal game setup
nix flake init -t git+https://git.matt.you/matt/nixblox#maximal    # every config option shown
nix flake init -t git+https://git.matt.you/matt/nixblox#toolchain  # just a dev shell (rokit/aftman/foreman)

Edit flake.nix to configure your game — set your universe ID, place IDs, and any asset places you want to pull content from. Then enter the dev shell and run your first build:

nix develop
nixblox bump       # pin asset place versions
nixblox build      # fetch asset places and compose each place's tree

See the Getting Started guide for a full walkthrough.

Documentation

Guide	Description
Getting Started	Prerequisites, installation, and your first build
Configuration	Config format, cascading resolution, and credential management
Build Pipeline	How bump, fetch, extract, build, and deploy work together
Testing	Jest-roblox integration and test configuration
Command Reference	Quick-lookup for all CLI commands and flags

Platform Support

• x86_64-linux
• aarch64-linux
• x86_64-darwin
• aarch64-darwin