/README.md (845d90e867de93f3b4a2b57f16a10d3585a21b9d) (2692 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 is proprietary. This restriction exists regardless of the licensing of the engine. Please don't name products "Cave Confectioner".

After compiling, place the data folder 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 18092 d159169d1050894d3ea3b98e1c965c4058208fe1 COPYING
100755 blob 43 45aea818a4a3202b2467509f28a481cce08834d2 Confectioner.command
100644 blob 12084 829108f64c4db9a8182ae5f0246c7760c2d118d2 Makefile
100644 blob 2692 845d90e867de93f3b4a2b57f16a10d3585a21b9d README.md
100755 blob 156 84cb1387849f2ca98e53e43536d00af2dfabf7d3 caveconfec
100755 blob 28 41b0ef285892c86306eaa269f366dd04cb633d21 caveconfec.bat
100644 blob 186549 2ea12a923152ce63d3bd6282b0c0170e61d23f53 confec.cpp
040000 tree - 673643a439cd3679db47a752fdbd73b380ad88f3 data
100644 blob 255473 3ab2f705594283033a4a09220fe5b8ab4df9bb32 gamecontrollerdb.txt
040000 tree - cd5865b6a63abf8f6d43464b0a4786b5c6afc4ff include
100755 blob 1041 dd7c0bd7d8a6b4aeff53142375240872735d42a0 libs.cpp
100755 blob 27581 8350a63e947e8a4a55608fd090d128fef7b969a1 micropather.cpp
100644 blob 143279 e3a3425cdaca2e2590b4f88454f14d44b8a3be83 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