Overview

_{Founded & maintained by Aviril, Mario, Tron, Anisa & A-Variakojiene}

Vital.sandbox is an open-source, high-performance sandbox built on Godot-Engine and powered by C++17 & Lua.
Full control over rendering, networking, threading, and assets — one seamless workflow.

Getting Started

• Releases: Grab the latest stable build from Releases.
• Documentation: Learn the APIs, scripting patterns, and engine integration in the Guides.
• Benchmarks: See how Vital.sandbox performs against GDScript in the Benchmarks.
• Vault: Browse community resources and scripts in the Vault.
• Roadmap: Track what's planned and in progress on the Roadmap.
• Vendors: View all third-party dependencies and licenses in Vendor.
• Community: Got questions or want to connect? Join us on Discord.

Built-in Features

Vital.sandbox's Lua layer isn't a thin wrapper, it's a full-featured runtime that touches every system in the engine and actively expanding — Roadmap.

• UI primitives: Canvas, SVG, image, font, and texture APIs
• Crypto: Built-in cryptographic utilities
• Rendering: Control scenes, shaders, rendertargets, and draw calls directly from script
• Networking: Built-in async networking primitives for multiplayer-ready games
• Threading: True multi-threading support with promise-based coordination
• Asset delivery: Dynamic asset loading and streaming, managed entirely from Lua
• Event system: Heartbeats, listeners, and reactive patterns that scale cleanly
• Database: Async database access with query support (server-side)
• Webview: Embedded webview rendering (client-side)
• Audio: 2D and 3D audio sources with effect bus support
• Discord: Native Discord integration (client-side)
• GFX pipeline: Full environment control — fog, glow, sky (panoramic, physical, procedural), SSAO, SSIL, SSR, and more
• Lighting: Directional, point, spot, and area lights with full scripting control
• Physics: Complete physics support — rigid, static, animatable, character, and vehicle bodies, collision shapes, areas, and spaces
• Physics debugger: Per-shape and global collision wireframe visualizer, with color-coded local vs. replicated shapes

Structure

• Vital.sandbox/ — C++ GDExtension core
  • API/ — Lua-facing bindings, grouped by system: core, gfx, light, physics, utility
  • Bootstrap/ — build-time dependency scripts (Godot, vendors, Discord, etc.)
  • Config/ — compile-time server configuration headers
  • Engine/ — engine-side implementations backing every API type
  • Manager/ — high-level managers: sandbox lifecycle, asset delivery, networking, masterlist, Discord, kit
  • Sandbox/ — Lua VM: machine, mixin, runtime instance types
  • Tool/ — internal C++ utilities (logging, threading, crypto, HTTP, file, timers, etc.)
  • Vital/ — entrypoint, precompiled header, and top-level includes
• Vital.client/ — Godot client project (loads the GDExtension, ships as the player binary)
• Vital.server/ — Godot server project with config.yaml (network, sync, masterlist, bootstrap)
• Vital.benchmark/ — self-contained benchmark project; runs benchmark and exports benchmark.json
• build.py — cross-platform build script

Privacy Policy

• Vital.sandbox may send server information exposed by the server owner to the masterlist solely for server listing purposes.
• No personal data is collected, stored or shared with any third party.