Welcome to the VoidRush Documentation
Voidrush is a web game platform that accepts HTML5 and WebAssembly bundles (Unity WebGL/Godot), featuring a developer portal, an upload/extraction pipeline, and a real-time SDK for multiplayer via WebSocket. This documentation guides you from *upload* to publishing, including quality requirements and SDK integration.
What You Can Build
- HTML5 Games (React/Phaser/Construct/Pixi/GDevelop/Three.js, etc.).
- WebAssembly Games (Unity WebGL, Godot Web) avec exécution isolée (COOP/COEP) quand nécessaire.
- Game Modes : solo, local multiplayer, online multiplayer (via SDK) et “open online multiplayer”.
Quick Architecture Overview
- Developer Portal : create and manage your games, upload your bundles, and track their status.
- Game Hosting : “raw” rendering of your
index.html(HTML5) or isolated mode (WASM), ready for embed. - Multiplayer : REST API + WebSocket, auto-room creation via URL, signed access tokens, ready-to-use SDK clients.
Where to Start
- Create a Developer Account puis add a game depuis le portail. Provide a title, a bundle (ZIP/HTML/JS), and choose the engine.
-
Upload your Build : we extract your archive, detect the
index.html, and expose a raw route to serve the game in an iframe. -
Enable Multiplayer (Optional) : use the auto-join API to generate a
tokenand aws_url, then connect with the UMD SDK. - Meet Quality Requirements : launch checklist, browser checks, cover assets, etc.
- Publish : fill out age rating, privacy policy, icon, video, etc.
SDK in 60 Seconds
Include the UMD bundle client-side and join a room directly from the current URL:
<script src="/static/games/js/voidrush-sdk.umd.js"></script>
<script>
// Ultra-simple variant (auto-join)
const client = new VoidrushSDK.AutoJoinClient({ gameId: "YOUR_GAME_ID" });
client.quickJoin().then(() => {
console.log("✅ connected to room:", client.roomId);
});
// Turn-based variant
const tbg = new VoidrushSDK.TurnBasedGameClient({ gameId: "YOUR_GAME_ID" });
tbg.sendMove({ from: "a2", to: "a4" });
</script>
The backend exposes an auto-join endpoint which returns token and ws_url.
The SDK can also reconstruct the WebSocket URL from the page if necessary.
Everything else is in the following sections
- Basic Launch Requirements : taille du build, isolation, assets, publication…
- SDK / Setup : compatibilité, erreurs fréquentes, headers.
- SDK / Setup et Data Module : intégrer, se connecter, échanger des messages.
- Assets & Cover images : formats & gabarits.
- Partners et FAQ & Contact.