A desktop workspace (Tauri v2 + plain JavaScript) for web development and 2D / 3D game making.
- Code editor (Ace) with live web preview and device frames
- UI designer – drag components onto a canvas, export HTML
- Game editor – 2D and 3D scenes, 100 visual logic blocks (Triggers, Logic & Math, Components, Properties, Text & Lists, GUI, Game Flow, Mobile Device, Behavior Bundles), a script view of the same logic, and your own assets: pixel-art sprites, a sound synthesizer with step sequencer, voxel / shape / OBJ models
- Play, device simulator, export to a single HTML file
- Plugins with in-app documentation (Docs → Plugins), themes
- Accounts, collaboration, public hosting via the bundled sharing server
Requires Node.js 18+ and Rust (rustup). On Linux you also need the Tauri system packages (webkit2gtk etc., see tauri.app/start/prerequisites).
npm install # also copies Ace + three.js into renderer/vendor
npm start # desktop app (tauri dev)
npm run build # installer / bundle
npm run web # browser-only mode on http://localhost:5173 (no Rust needed; files are kept in memory)
npm test # syntax checks + end-to-end test of the sharing server
npm run server # sharing server on http://localhost:8787 (PORT, DATA_DIR, PUBLIC_URL, ALLOW_REGISTER=0)
In the app: Cloud panel → Server → your URL → create an account → Publish current project. Games and sites are served at /p/<user>/<name>/; collaborators join with an invite code and sync every few seconds. To make links public, run the server on a machine/host that is reachable from the internet (put it behind HTTPS, e.g. Caddy or nginx) and set PUBLIC_URL.
npm run clean # remove build artefacts (node_modules, src-tauri/target, renderer/vendor) – alias: npm run autoclean
npm run uninstall # interactive; choose clean or full
npm run uninstall:auto # no questions: artefacts + Vextra's settings, plugins, themes, saved sign-in
node scripts/uninstall.js --mode=full --dry-run # preview only
node scripts/uninstall.js --mode=full --auto --toolchain # also uninstall rustup (asks you to type a confirmation)
Your own projects and games are never deleted. The same clean-up of app data is available in the app under Settings.
Drop a .js file in the plugins folder (Plugins panel → Open folder) with a /** @forge-plugin {...} */ manifest and an optional /** @forge-docs ... */ block. See plugins/ for examples and Docs → Plugins → Plugin API.
- A live Blender link (
tools/blender-addon): pull models from Blender, send models to it, auto-sync edits – plus one-click glb export and a model optimizer (tools/model-optimize). - Store Export understands VR / AR games: Meta Quest (Horizon Store) package, Android WebXR package, phone permissions, Steam VR launcher.
- Download installers from the Releases page – built automatically by GitHub Actions (newest runners and Node.js LTS) for Linux, macOS (Apple silicon + Intel) and Windows, with SHA-256 checksums. The Windows installers (.exe and .msi) both offer to delete your app data when you uninstall (see Docs → Uninstalling).
- Live demo in your browser (GitHub Pages) – look around without installing. Build it yourself with
npm run build:web. To publish it from your fork: Settings → Pages → Source: GitHub Actions, then push to the default branch.
- Skeletons, animations, Draco and Meshopt in 3D models, plus a Model Animation block to play clips.
- Import from other tools: FBX (Mixamo, Maya, 3ds Max…), Collada, STL, PLY, 3MF → game-ready
.glb. - Bluetooth now works in the Play tab (permission fix).
- GLB / glTF models – import 3D models from Blender and others in Assets → Models.
- A demo video for every block in the documentation.
- Voice commands can use a local model (Whisper server on your computer) or a cloud service, like the AI plugin.
- VR and AR demo games – Toy Toss, Orb Garden, AR Garden, AR Tape Measure – and floating 3D Text.
- Bluetooth blocks (Connect, Read, Write, Notify), a Get Field block, and readable results instead of
[object Object]. - 13 more blocks in the Block Extras plugin and demo clips for plugin blocks.
- Live values in the Logic tab (▶ Live), Exit Game ✕ + force close, Pause Game toggle fix, VR Toy Toss faces the table.
- VR / AR Look At is more reliable.
- Sky Parkour's fallen tiles come back when you respawn.
- 10 interface languages (incl. right-to-left Arabic) in Settings → Language.
- Accessibility: screen-reader labels and dialogs, keyboard moving of blocks, skip link, reduce motion, high-contrast themes, interface zoom.
- Store Export installs Java, Gradle and the Android SDK itself, replaces old versions when updating, and produces an APK in
mobile/distthat opens in Android Studio or on a Mac.
- Customizable loading page for every game (title, colours, logo, tips, progress style) with the Vextra Studio credit.
- Exported websites and UI designs carry a "Made with Vextra Studio · © XHiddenProjects" footer.
- Store Export builds with Java 27 and retries slow downloads.
- Fixed spawned objects that were invisible in some games; Echo Maze now hears your voice.
- Layers (Background / World / UI) with show / lock, and UI-layer objects that stay on screen.
- Edit UI layout: drag labels and bars to where you want them, or type the anchor and X / Y.
- Live cursor + selected-object position in the 2D and 3D viewports.
- Object scripts are now behaviours (Logic tab) – old projects convert automatically.
- All ten example games are block graphs – open one in Logic and read or rewire it. New Light block for live 3D lights.
- New ACCESSIBILITY.md.
- Ten example games (5 × 2D, 5 × 3D) in Library → Games.
- Store Export checks Java / Gradle / Android SDK automatically (JAVA_HOME), installs and updates them for you, and shows a simple checklist.
- vxui as a site builder (pages, ready-made sections, tablet/phone preview) and Vextra AI 2.0 (guide, code blocks, entity/scene/game behaviour targets, runs in the background).
- Vextra AI 2.2: token limit with a one-hour cooldown and checkpoint, status icon, per-model settings, design editors / Blender, visible play-tests. (2.1: plays and screenshots its own work (games and web pages), accepts attached pictures / video / audio / files, and no longer loops without changing anything.
- Responsive vxui: exported designs scale to any screen, stack on phones and support
#links and multiple pages. Designer & Game Extras 2.0 adds 7 designer components and 6 game objects. Optional Windows code signing (SmartScreen) in the release workflow. - Signed auto-updates on desktop (Settings → About → Install and restart); set up once with
npm run updater:keygen. - Voice Command speech-service fallback, mouse-look and kinematic-gravity fixes. See
CHANGELOG.md. - Community files: contributing guide, code of conduct, issue and pull request templates.
- Microphone and camera blocks now work in the editor's Play panel (the editor hands the devices to the sandboxed game), with clear error messages.
- Realism: physically based materials + screen effect for hyper-realistic 3D.
- New block groups: Microphone, Camera, VR and AR (with desktop fallbacks).
- Custom shader / material drop-downs in the Shader block and the Inspector.
- Drag to reorder editor tabs, bottom-panel tabs and sidebar icons.
- Vextra AI: Build & change site permission, checkpoints (Continue), token usage bar, context window for every provider, time-out lock, Reconnect with auto-countdown, more providers.
- Security: CodeQL findings in Vextra Shield fixed (see
SECURITY.md).
vextra-server.exe (the bundled local server, built by npm run build:server) is about 100 MB, and GitHub rejects normal files that large. It is stored with Git LFS instead (.gitattributes already lists it, and it is not in .gitignore):
# once, after installing Git LFS from https://git-lfs.com
npm run lfs:setup
git add .gitattributes src-tauri/resources/server
git commit -m "Add server binary via LFS"
git push
If the exe was already committed without LFS, convert it: git lfs migrate import --include="src-tauri/resources/server/vextra-server.exe" --everything, then git push --force-with-lease. GitHub's free plan allows 2 GB per LFS file but only 10 GiB of LFS storage + bandwidth per month; for many releases publish builds on the Releases page instead.
- Vextra Shield security plugin with a ⚙ Configure button; plugin hooks and
forge.config. - One Animation block for everything (sprite/model/clip, Auto walk-idle-jump), synced with its target; F3 cycles 1st / 3rd-back / 3rd-front camera in 3D.
- Vextra AI plugin (Claude, OpenAI, Gemini, Groq, Ollama… with Deny/Ask/Allow permissions) and account security (authenticator app, recovery codes, security keys).
- Start local server button in the desktop app (bundled server, no terminal); every object/target field is a dropdown; settings open as
plugin:<name>tabs. - Fixed leftover outlines when scaling 3D objects.
esbuildinstall script allowed by default.
- Separate animation studios for sprites and 3D models (🎞 Animate tab), with a calm, paused-by-default preview.
- 2D lights with scene darkness; clearer 3D light helpers.
- Library: install website templates and 2D/3D games from a URL, GitHub repo or catalog (defaults included).
- Animation clips, material files (also in the model editor), a 25-effect shader list with modes and custom shader files.
- Blocks: self-connect, Switch / Toggle switch, Number rounding, Collision side, Cursor none, icons on blocks and file types, resizable block settings.
- Store Export installs, assigns and builds automatically with a progress bar.
- Flexible layout that reflows with the window; more default 2D/3D assets; read-only notice moved to the top of the code pane.
- Build scripts:
npm run build:win,build:linux,build:mac(replacesbuild:exe).
- Web projects: any file type, a built-in SQLite database (browse/edit/SQL/import/export),
window.VXDBin previews, PHP run (desktop, needs PHP installed), local-server preview, and Export website to ZIP / tar.gz with.htaccess,nginx.conf, database and deploy notes. - Games:
Oncetrigger, Expression variables a–f, camera view width/height, GUI banner ads with an ad-service choice (house, image, HTML tag, AdSense, own code), first-person 3D demo, blank new projects (demos under the Command Palette), labels that survive restarts, working device frames in Play. - Editor: collapsible block palette / settings / nodes, panels that adapt to window size, real Simple vs Advanced modes.
- Markdown Preview plugin: outline, syntax-highlighted code with line numbers and a Copy button that follows the scroll. Docs use the same code blocks.
- The Rust side (
src-tauri) was written but not compiled in the environment this was built in. The whole front end, game runtime, and server were run and tested in a headless browser. The PHP-server and local-preview-server code was compiled and run on its own (std only) but not inside Tauri. Expect to fix small compile errors on firstnpm start. - PHP features need PHP installed on your computer. AdSense / ad tags need your own approved account and internet access. Store export prepares build-ready projects; signing and uploading need your own developer accounts.
- Ads, Game Center, achievements and device features are web fallbacks / simulations with hooks, not native SDK integrations.
- No glTF import (voxel, primitive-group and OBJ models only).
- Plugin blocks must be self-contained functions to survive export.
- Legacy
.forgescenefiles are converted best-effort. Data from the old McDev app folder is not migrated.
See CHANGELOG.md for release notes, SECURITY.md for the security policy and known advisories, and ACCESSIBILITY.md for accessibility.