/README.md (b5a3f573f076ef740ca742ec9598043732e10c0e) (2723 bytes) (mode 100644) (type blob)

# Confectioner Engine

This repository contains the engine and some permissively licensed third-party code.

Though Confectioner Engine is FLOSS (see: COPYING), Cave Confectioner's art, game assets, and IP are proprietary. This applies regardless of the licensing of the engine. Please don't name products "Cave Confectioner".

After compiling, place the "base" and "game" folders from a commercial Cave Confectioner release in this folder, then run the game.

# Compiling

To be on the safe side, you should have a spare 2 GB of storage to build. The makefile uses wget to download compressed archives from the Internet: source code for GNU/Linux, binaries for Windows. Steam and Mac libraries currently must be downloaded manually if you target Steam or Mac.

## Dependencies

* A Unix-compatible environment (GNU/Linux, Mac, or possibly BSD)
* GCC or Clang
* MinGW (only if targeting Windows)
* CMake
* wget
* tar
* Boost (source downloaded automatically for any target platform, HUGE when extracted)
- *Poco is NOT used anymore, but its ghost floats around the code*
* OpenSSL 1.1 (system version used on GNU/Linux, downloaded for other platforms)
* SDL 2.0.x (source optionally downloaded for GNU/Linux, binaries for Windows)
* SDL's dependencies (only if building static for GNU/Linux, see below)

To install many of the core dependencies on Debian/Ubuntu/Mint/Trisquel:

sudo apt install build-essential libsdl2-dev \
libegl1-mesa-dev libgl1-mesa-dev libgles2-mesa-dev \
libxrandr-dev libxi-dev libasound2-dev libpulse-dev libudev-dev

To compile with static SDL2 and Boost on GNU/Linux, simply run `make`. The default DRM-free static executable is called **cave-confec**.

To compile with dynamic SDL2 on GNU/Linux (but still downloading and compiling Boost) run `make confec-dynamic`. The DRM-free dynamic executable is called **confec-dynamic**.

Read the makefile for other target platforms and configurations.

If you care to update non-executable dependencies, here is where to get them:

**openjdk.pem**

* OpenJDK SSL trust store, which is used in the Windows build.
* https://github.com/nabla-c0d3/trust_stores_observatory

**gamecontrollerdb.txt**

* Used by SDL to recognize game controllers and assign mappings.
* https://github.com/gabomdq/SDL_GameControllerDB

# Tools used

These tools are used for programming and content creation. They are not needed for compilation, but you can use them to expand, rework, or mod the game.

* Geany - code editing
* Tiled - maps
* GIMP - sprites
* Audacity - audio

All of the tools are cross-platform and can be installed on free systems as well as Windows and Mac.

To install the tools on Debian/Ubuntu/Mint/Trisquel:

sudo apt install geany tiled gimp audacity

Mode Type Size Ref File
100644 blob 98 227abf3bfa53b2530dcc74495da7bd0ccdcb0775 .gitignore
100644 blob 225 9b00c2c2e7b4f0c1e338fdead65f17ba0af089c1 COPYING
100755 blob 43 45aea818a4a3202b2467509f28a481cce08834d2 Confectioner.command
100644 blob 14015 649b7f0c112c3ac13287bfe88b949fec50356e4d Makefile
100644 blob 2723 b5a3f573f076ef740ca742ec9598043732e10c0e README.md
040000 tree - 6b3a1677d07517c1f83769dd7675fe6bb9d7a269 base
100755 blob 156 84cb1387849f2ca98e53e43536d00af2dfabf7d3 caveconfec
100755 blob 28 41b0ef285892c86306eaa269f366dd04cb633d21 caveconfec.bat
100644 blob 198037 a0180394c9bf29c02b7ef05916bd5573e3f37da2 confec.cpp
100644 blob 487269 29cfd3578eb40b1f039e271bcaa81af49d1b7f3c gamecontrollerdb.txt
040000 tree - 62e9d686bbab52d3d88886390b437a3ecef315de include
100755 blob 12081 ad29f012941aedfd4ee7232ed95fb68c8c5244c9 index-template.html
100755 blob 1065 a460e3c74b8fa53a6f609944ef7e41558479e73f libs.cpp
100755 blob 27581 8350a63e947e8a4a55608fd090d128fef7b969a1 micropather.cpp
100644 blob 141235 f54e2d2631a628876a631456c043b77da5db78bd openjdk.pem
100755 blob 8 e9a74187b02a27b165dfa4f93bf6f060376d0ee6 steam_appid.txt
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/mse/ConfectionerEngine

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/mse/ConfectionerEngine

Clone this repository using git:
git clone git://git.rocketgit.com/user/mse/ConfectionerEngine

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main