A modern BASIC for building 2D and 3D games — write .mb source, download pre-built binaries, and run. No Go, no C compiler, no build tools on your machine. Download from here: (https://github.com/CharmingBlaze/moonbasic/releases/tag/v1.2.27)

One download gives you moonrun (play games), moonbasic (check, compile to .mbc, language server), and optionally the moonBASIC IDE — a desktop editor with the full documentation built in. The engine bundles Raylib, Box2D, and Jolt — graphics, audio, 2D physics, 3D physics, networking, terrain, UI, particles, and more behind 4,200+ built-in commands across 40+ namespaces (WINDOW.*, ENTITY.*, PHYSICS3D.*, GUI.*, NET.*, …).

This repository is the official home for documentation, examples, and pre-compiled downloads for Windows, Linux, and macOS (Apple Silicon).

Latest release: github.com/CharmingBlaze/moonbasic/releases/latest

Direct links by platform: charmingblaze.github.io/moonbasic/

You do not need to install Go, GCC, Node.js, or Raylib separately.

IDE bundle — moonbasic-ide, moonbasic, moonrun, README-IDE-RELEASE.txt, START-IDE. Documentation is inside the IDE.

Full runtime — moonbasic, moonrun, README-RELEASE.txt, VS Code .vsix, INSTALL-VSCODE.bat / INSTALL-VSCODE.sh.

All artifact names and platform notes: RELEASES.md

The fastest way to start — one folder, no extra setup.

1. Download moonbasic-<tag>-ide-… for your OS from Releases.
2. Extract anywhere permanent.
3. Run START-IDE.bat (Windows) or chmod +x START-IDE.sh moonbasic-ide moonbasic moonrun && ./START-IDE.sh (Linux/macOS).
4. Write or open a .mb file in the editor.

The IDE auto-detects moonbasic and moonrun in the same folder. Open Documentation in the sidebar for BEGIN_HERE.md, guides, and the full command reference.

Engine source: moonbasic-compiler (moonbasic ide/).

If you downloaded the full runtime instead of the IDE:

moonrun --version          # Windows: moonrun.exe --version
moonbasic new MyGame
cd MyGame
moonrun main.mb

Try an example from this repo (clone or Download ZIP — examples ship here, not inside release zips):

moonrun examples/spin_cube/main.mb
moonrun examples/guides/game_loop.mb

After extracting the full runtime:

moonbasic install-vscode

Or double-click INSTALL-VSCODE.bat (Windows) / run ./INSTALL-VSCODE.sh.

That installs the extension and sets moonbasic.languageServerPath and moonbasic.moonrunPath automatically. Then open any .mb file — completions, hover help, Ctrl+F5 run, Ctrl+Shift+C check, Alt+H help at cursor.

Extension source: editors/vscode-moonbasic/ · Guide: docs/GETTING_STARTED.md

APP.OPEN(960, 540, "Hello moonBASIC")
WHILE NOT APP.SHOULDCLOSE()
    RENDER.CLEAR(20, 24, 32)
    RENDER.FRAME()
WEND
APP.CLOSE()

(APP.* aliases WINDOW.* — same engine, clearer tutorials.)

MIT — see LICENSE.

Engine source (contributors): github.com/CharmingBlaze/moonbasic-compiler