hizi docs

Appearance

External Game Engines ​

You can host your game engine outside the hizi.io platform. The hizi.io Remote Gaming Server (RGS) calls your engine over HTTP. Your engine calls the Game Studio API V2 to manage gamerounds and request random numbers.

Start with the external game engine template. It contains a minimal slot engine with two hosting options: a Cloudflare Worker or a self-hosted Node server. Both options use the same game logic. Use the template to develop and test your integration.

Setup ​

  1. Clone the template repository.
  2. Follow its README for your chosen hosting option.
  3. Configure the API endpoint and credentials for your hizi.io environment.
  4. Build and deploy the engine to a URL that the hizi.io RGS can reach.
  5. Register your game in the hizi app with its launch URL and engine base URL. Follow the template's instructions for your hosting option.

Configure the game in the hizi app ​

The game launch URL points to your frontend. The game engine base URL points to your engine. The RGS adds the operation name to the engine base URL when it calls your engine.

For the template's Cloudflare Worker, configure these values in the hizi app. Replace <account> with your Cloudflare account subdomain.

FieldExample value
Game launch URLhttps://game-readme-engine-example.<account>.workers.dev/frontend/
Game engine base URLhttps://game-readme-engine-example.<account>.workers.dev/game-readme

For example, the RGS calls https://game-readme-engine-example.<account>.workers.dev/game-readme/placeBet to place a bet.

Jurisdiction restrictions

Some jurisdictions might not allow this external hosting setup. Contact us for further instructions before you use it in production. We can confirm the hosting and deployment requirements for your target jurisdictions.