- Make sure you have the correct tools ready.
- For example on Windows: Make sure you install the C++ compiler tools from Visual Studio Community, install the latest CMake, and install Visual Studio Code.
- Create a new repository from ths template.
- Clone your new repository.
- Make sure to initialize the
vcpkgandlibtcodsubmodules. If either folder is empty then the build process will fail.- The command to do this is:
git submodule update --init --recursive
- The command to do this is:
- Load this project in VS Code and install any recommended plugins. Most importantly: C/C++, C++ Intellisense, and CMake Tools.
- Using the CMake Tools plugin you can now build and run this project. Dependencies will automatically be installed via Vcpkg.
- On Windows, when CMake Tools asks for a toolkit you should select
Visual Studio Community ... - amd64. - When CMake Tools asks for a project select
libtcod-vcpkg-template.
- On Windows, when CMake Tools asks for a toolkit you should select
- The project will now build and run with F5.
You should edit the
CMakeLists.txtscript as needed to expand your project.
Now that you know the template works you'll want to take care the following:
- Replace the license in LICENSE.txt with your own, see choosealicense.com.
- Modify vcpkg.json to include any libraries from Vcpkg that you want to use such as the popular fmt library. You'll need to add these libraries to CMakeLists.txt to link them.
- Change
libtcod-vcpkg-templatein CMakeLists.txt to the name of your game. You may want to edit other parts of the CMake script as well, such as the included source files. - Verify the style settings in .clang-format and .editorconfig.
After you run git submodule update --init you can setup the submodules by going into their initialized submodule directories and checking out the desired commits.
See the Git Documentation on Submodules.
To use the development versions of libtcod: change to the libtcod subdirectory and checkout the develop branch with git checkout develop.
After that you can pull any updates to libtcod with git pull.
The Vcpkg submodule is updated in the same way.
Checkout and pull the master branch to get the most recent ports.