https://github.com/raysan5/raylib-game-template
A small template to start your raylib game
https://github.com/raysan5/raylib-game-template
Last synced: 22 days ago
JSON representation
A small template to start your raylib game
- Host: GitHub
- URL: https://github.com/raysan5/raylib-game-template
- Owner: raysan5
- License: zlib
- Created: 2021-06-30T16:44:07.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-15T18:55:47.000Z (8 months ago)
- Last Synced: 2024-10-18T02:28:33.273Z (8 months ago)
- Language: C
- Homepage:
- Size: 2.54 MB
- Stars: 396
- Watchers: 10
- Forks: 94
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
-----------------------------------
_DISCLAIMER:_
Welcome to **raylib game template**!
This template provides a base structure to start developing a small raylib game in plain C. The repo is also pre-configured with a default `LICENSE` (zlib/libpng) and a `README.md` (this one) to be properly filled by users. Feel free to change the LICENSE as required.
All the sections defined by `$(Data to Fill)` are expected to be edited and filled properly. It's recommended to delete this disclaimer message after editing this `README.md` file.
This template has been created to be used with raylib (www.raylib.com) and it's licensed under an unmodified zlib/libpng license.
_Copyright (c) 2014-2025 Ramon Santamaria ([@raysan5](https://twitter.com/raysan5))_
-----------------------------------
## Getting Started with this template
#### Linux
When setting up this template on linux for the first time, install the dependencies from this page:
([Working on GNU Linux](https://github.com/raysan5/raylib/wiki/Working-on-GNU-Linux))
You can use this templates in some ways. Using Visual Studio, using CMake or make your own build setup. This repository come with Visual Studio and CMake already setuped.
Chose one of the follow setup, that fit in you development enviroment.
### Visual Studio
- After extracting the zip, the parent folder `raylib-game-template` should exist in the same directory as `raylib` itself. So your file structure should look like this:
- Some parent directory
- `raylib`
- the contents of https://github.com/raysan5/raylib
- `raylib-game-template`
- this `README.md` and all other raylib-game-template files
- If using Visual Studio, open projects/VS2022/raylib-game-template.sln
- Select on `raylib_game` in the solution explorer, then in the toolbar at the top, click `Project` > `Set as Startup Project`
- Now you're all set up! Click `Local Windows Debugger` with the green play arrow and the project will run.
### CMake
- Extract the zip of this project
- Type the follow command:
```sh
cmake -S . -B build
```
> if you want with debug symbols put the flag `-DCMAKE_BUILD_TYPE=Debug`
- After CMake config your project build:
```sh
cmake --build build
```
- Inside the build folder are another folder (named the same as the project name on CMakeLists.txt) with the executable and resources folder.
- In order for resources to load properly, cd to `src` and run the executable (`../build/${PROJECT_NAME}/${PROJECT_NAME}`) from there.
- cmake will automatically download a current release of raylib but if you want to use your local version you can pass `-DFETCHCONTENT_SOURCE_DIR_RAYLIB=`
## $(Game Title)
### Description
$(Your Game Description)
### Features
- $(Game Feature 01)
- $(Game Feature 02)
- $(Game Feature 03)
### Controls
Keyboard:
- $(Game Control 01)
- $(Game Control 02)
- $(Game Control 03)
### Screenshots
_TODO: Show your game to the world, animated GIFs recommended!._
### Developers
- $(Developer 01) - $(Role/Tasks Developed)
- $(Developer 02) - $(Role/Tasks Developed)
- $(Developer 03) - $(Role/Tasks Developed)
### Links
- YouTube Gameplay: $(YouTube Link)
- itch.io Release: $(itch.io Game Page)
- Steam Release: $(Steam Game Page)
### License
This game sources are licensed under an unmodified zlib/libpng license, which is an OSI-certified, BSD-like license that allows static linking with closed source software. Check [LICENSE](LICENSE) for further details.
$(Additional Licenses)
*Copyright (c) $(Year) $(User Name) ($(User Twitter/GitHub Name))*