https://github.com/mgerhardy/caveexpress
CaveExpress is a classic 2D platformer with physics-based gameplay and dozens of levels. CavePacker is a Sokoban game.
https://github.com/mgerhardy/caveexpress
android arcade arcade-game cmake cpp emscripten game html5 html5-game ios opensource
Last synced: 8 months ago
JSON representation
CaveExpress is a classic 2D platformer with physics-based gameplay and dozens of levels. CavePacker is a Sokoban game.
- Host: GitHub
- URL: https://github.com/mgerhardy/caveexpress
- Owner: mgerhardy
- License: other
- Created: 2014-03-11T06:47:13.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2025-03-29T04:29:42.000Z (8 months ago)
- Last Synced: 2025-03-29T06:05:37.400Z (8 months ago)
- Topics: android, arcade, arcade-game, cmake, cpp, emscripten, game, html5, html5-game, ios, opensource
- Language: C++
- Homepage: http://www.caveproductions.org/
- Size: 767 MB
- Stars: 151
- Watchers: 11
- Forks: 22
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
States for building on Linux and Mac
[](https://github.com/mgerhardy/caveexpress/actions)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://opensource.org/licenses/MIT)
**[Homepage](http://www.caveproductions.org/)**
**[Discord](https://discord.com/invite/XqNBRsBY)**
# About
This repository is the home of two games: CaveExpress and CavePacker
## CaveExpress
CaveExpress is a classic 2D platformer with physics-based gameplay and dozens of levels. Master your pedal-powered flying machine to pick up packages from your cave-dwelling clients and drop them off at the collection point. But beware! Mighty mastodons, terrifying pterodactyls and others would rather see you extinct.
Features:
* Multiplayer
* Built-in mapeditor
* Physics-based gameplay
Online version: [caveexpress](https://mgerhardy.github.io/caveexpress/caveexpress.html)
## CavePacker
CavePacker is a sokoban game. It is a puzzle game where you have to move the packages onto their targets without getting stuck. The lesser steps you made for solving a level, the better. You may only push but not pull packages.
The maps are taken from XSokoban, KSokoban - the author of sasquatch and microban maps is David W. Skinner and the maps gri* are made by GRIGoRusha.
Btw.: Did I mention that this is a sokoban game that even supports network based multiplayer gaming. Check it out.
The multiplayer maps were all created by me and are released in the Public Domain or CC0.
Features:
* Multiplayer
* Built-in mapeditor
CavePacker includes a map editor. You can start it by executing it via `cavepacker -ui_push editor`
Online version: [cavepacker](https://mgerhardy.github.io/caveexpress/cavepacker.html)
# Installation
Use the nightly builds from [github actions](https://github.com/mgerhardy/caveexpress/actions) or install a stable release:
### Debian
`apt-get install caveexpress cavepacker`
### Other
Download from [github releases](https://github.com/mgerhardy/caveexpress/releases/tag/2.4)
# Development
## Dependencies
* cmake >= 2.8.7
* gcc, clang or msvc as compiler (C++11 support is needed)
* SDL2 >= 2.0.3
* SDL2_mixer >= 2.0.0
* SDL2_net >= 2.0.0
* SDL2_image >= 2.0.0
* sqlite3
* glm
* lua >= 5.2
* Box2D >= 2.4.1
* yajl (only if you compile tools)
## Compilation
How to build projects from sources described on wiki page [Compilation](https://github.com/mgerhardy/caveexpress/wiki/Compilation).
# Tools
Tools used for development, included in [sources](https://github.com/mgerhardy/caveexpress/tree/master/src/caveexpress/tools).
## TextureAtlas
The physical shapes with [box2deditor](https://github.com/mgerhardy/box2d-editor)
To convert the `tps` files into a texture atlas you can use the bundled tool `textureatlas`. The `tps` files can get created with Texturepacker 3.9.4.
The tool can read `tps` files (to some extent) and generate the needed texture atlas and lua sprite definitions that are needed for cavepacker and caveexpress. Call the tool with `-h` as parameter to get an overview of the command line options.
To generate e.g. all needed images and lua scripts for caveexpress, you can do this:
```sh
./textureatlas contrib/assets/png/caveexpress*.tps
```
## jsonconvert
Converts the box2deditor json output into CaveExpress readable format.
## soundmapper
Generate the entitysound.lua file for CaveExpress.
## tiledgenerator
Generate tiled mapeditor tileset definitions.
## CVARs
There is an in-game console (open it with `SHIFT+TAB` where you can execute commands and show or change configuration variables)