Pite

A game engine inspired by Godot, written in Rust — scene tree, first-class GUI editor, Python scripting.

Quickstart

cargo run -p pite-cli -- new hello --template minimal-2d
cargo run -p pite-cli -- run --scene examples/minimal-2d/scenes/main.pitescene
cargo run -p pite-cli -- check
cargo run -p pite-cli -- edit --scene examples/minimal-2d/scenes/main.pitescene

new scaffolds a project, run plays a scene, check validates it, edit opens the editor.

Export

cargo run -p pite-cli -- export linux

export linux|windows writes a runnable directory (dist/<name>-platform>/) with the engine binary, a run launcher, and only the referenced game content (game/). Extra files ride along via [export] include in pite.toml (all export settings default; old projects export untouched). Python is bundled: export fetches a pinned CPython 3.12 (checksum-verified, cached under ~/.cache/pite/toolchains, never vendored in the repo) and ships the interpreter library plus a stdlib zip under python/ — site-packages is not shipped, because pite is a native module registered from Rust. The launcher sets what the platform needs (LD_LIBRARY_PATH + PYTHONPATH on Linux; on Windows the interpreter DLL goes next to the binary plus a python312._pth naming the stdlib zip, because Windows ignores PYTHONPATH once that file exists), so the exported game runs on a machine with no Python installed. Offline? Export fails loudly and tells you to pass --no-bundle-python, which keeps the old requirement of system Python 3.12 (PITE_PYTHON overrides detection; --skip-python-check skips that gate). Exported runs never watch files (--no-reload is baked into the launcher).

Status

v0.1-m2 (tagged): a playable 2D loop, not a scaffold. Textured sprites render through Camera2D with key-driven movement and parent-carried transforms; typed signals (pite.signal(int)) connect nodes; Label and Button draw and click; pite.play("…") runs WAVs; scenes hot-reload while you type. Around that: a binary scene cache (_cache/, content-hash keyed, version stamped), an asset pipeline with uid tracking (pite reimport), a locked pite.toml schema, and an external Python language server in the code pane. See CHANGELOG.md for the release-by-release record.

Workspace

Crate	Role
pite-cli	pite binary: new / run / check / reimport / edit / export
pite-runtime	Window, main loop, script driving, hot reload
pite-core	Node tree, handles, props, lifecycle dispatch
pite-render	Renderer2D trait (wgpu seam)
pite-script	Embedded Python (pite module)
pite-scene	TOML scenes, instantiation, validation, binary cache
pite-editor	eframe/egui panels on the same tree, LSP client
pite-assets	Importer trait, uid registry
pite-audio	WAV decode + playback state machine
pite-project	pite.toml, res:// paths, templates
pite-export	Desktop export (binary + resolved content)

Docs

Doc	Covers
docs/scene-format.md	.pitescene TOML, instantiation, the scene cache
docs/scripting-api.md	Python API: nodes, signals, input, audio, text
docs/assets.md	res:// refs, uid manifest, pite reimport
docs/editor.md	Panels, viewport, save, tree ops
docs/manifest.md	pite.toml fields, defaults, check rules
docs/lsp.md	Pinned pyright server, completion/hover/diagnostics

License

Dual-licensed MIT + Apache-2.0 (Rust standard): LICENSE-MIT, LICENSE-APACHE. New source files carry an SPDX header (SPDX-License-Identifier: MIT OR Apache-2.0); see CONTRIBUTING.md.