vix-game

A small 2D game built with Vix.cpp and the vix/game runtime.

Overview

vix-game is a simple game project used to demonstrate how to build a real interactive application with Vix.cpp.

It uses:

• vix.app
• vix/game
• GameRuntime
• Scene
• SDL window backend
• OpenGL renderer backend
• asset loading
• sprite rendering
• keyboard movement
• collision
• score update

Controls

W / Arrow Up       Move up
S / Arrow Down     Move down
A / Arrow Left     Move left
D / Arrow Right    Move right
Escape             Quit

Project structure

vix-game/
  assets/
    player.jpg
    coin.jpeg

  src/
    main.cpp
    GameConfig.hpp
    GameApp.hpp
    GameApp.cpp

    entities/
      Player.hpp
      Player.cpp
      Coin.hpp
      Coin.cpp

    gameplay/
      Collision.hpp

    scenes/
      MainScene.hpp
      MainScene.cpp

  game.package.json
  vix.app
  vix.json

Build

vix build

Run

vix run

Export

vix game export

Requirements

The installed Vix.cpp game module must be built with SDL support enabled.

On Ubuntu:

sudo apt update
sudo apt install libsdl2-dev libsdl2-image-dev

Goal

This project is intentionally small.

It exists to show the clean path from:

• Vix project
• game app
• window
• renderer
• sprite
• input
• gameplay

Create folders

mkdir -p src/entities src/gameplay src/scenes assets

Expected assets

Place these files:

assets/player.jpg
assets/coin.jpeg

Test

vix build
vix run