JVGS is a free, minimalistic platform game that is not like the others.
C++ Lua Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
resources Fix compilation for me Nov 12, 2014
src Fix compilation for me Nov 12, 2014
util Added a border to the viewer. Oct 20, 2009
LICENSE Switched to WTFPL. Feb 19, 2010
icon.png Added icon. Feb 20, 2010
poems Started working on level-end. Oct 27, 2009


1. Contents

  1. Contents
  2. Notes
  3. Dependencies
  4. Compiling
  5. Running
  6. License

2. Notes

The sounds are not included on github. Get them from the sourceforge mirrors. Actually, get the whole package from sourceforge unless you want an unstable release.

3. Dependencies

  • A sane compiler.
  • CMake (>= 2.6)
  • SDL (>= 1.2)
  • SDL_mixer (>= 1.2)
  • FreeType (recent version)
  • Swig (recent version)
  • Lua (>= 5.1)

On Ubuntu, these dependencies can be installed using the command

sudo apt-get install build-essential cmake swig libfreetype6-dev zlib1g-dev liblua5.1-0-dev libsdl-mixer1.2-dev libsdl1.2-dev

4. Compiling

cd into the jvgs folder, and then:

cmake .

5. Running

To execute run the game, use


By default, it runs the game in fullscreen mode. If you do not want this, you can run it like this in windowed mode:

./src/jvgs main.lua --width 800 --height 600

JVGS will remember the most recent video mode. To put it in fullscreen mode again, use:

./src/jvgs main.lua --fullscreen yes

6. License

JVGS is released under the WTFPL.