All Projects → ryanpcmcquen → Basque

ryanpcmcquen / Basque

Licence: mpl-2.0
A top-down 2d game engine, written from scratch in under 1000 lines of C. Development of the game based on this engine is streamed on Twitch: https://www.twitch.tv/ryanpcmcquen

Programming Languages

c
50402 projects - #5 most used programming language

Projects that are alternatives of or similar to Basque

Obengine
2D Game Engine with Lua Scripting made on top of SFML !
Stars: ✭ 335 (-13.66%)
Mutual labels:  hacktoberfest, game-engine, 2d-game-engine
tnt
A 2d Game Engine written in C++20.
Stars: ✭ 30 (-92.27%)
Mutual labels:  sdl2, 2d-game-engine
nodesnim
The Nim GUI/2D framework, based on OpenGL and SDL2.
Stars: ✭ 127 (-67.27%)
Mutual labels:  sdl2, 2d-game-engine
RendererEngine
2D - 3D Renderer Engine builds with OpenGL, SDL2, C++
Stars: ✭ 17 (-95.62%)
Mutual labels:  sdl2, 2d-game-engine
Nothing
A simple platformer about nothing
Stars: ✭ 249 (-35.82%)
Mutual labels:  hacktoberfest, sdl2
Dome
A lightweight game development environment where games can be written in Wren
Stars: ✭ 251 (-35.31%)
Mutual labels:  hacktoberfest, sdl2
DeccanEngine
💠 Deccan Engine is an Open-Source Cross-Platform 2D Game Engine written in C11. Powered by SDL2.
Stars: ✭ 30 (-92.27%)
Mutual labels:  sdl2, 2d-game-engine
Radixengine
A free and open game engine.
Stars: ✭ 126 (-67.53%)
Mutual labels:  hacktoberfest, game-engine
Base
Base environment for Red Eclipse and associated source files.
Stars: ✭ 273 (-29.64%)
Mutual labels:  hacktoberfest, game-engine
Terasology
Terasology - open source voxel world
Stars: ✭ 3,247 (+736.86%)
Mutual labels:  hacktoberfest, game-engine
Litiengine
LITIENGINE 🕹 The pure 2D java game engine.
Stars: ✭ 384 (-1.03%)
Mutual labels:  game-engine, 2d-game-engine
Thunder
An open-source game engine is written in C++ with a flexible architecture
Stars: ✭ 182 (-53.09%)
Mutual labels:  hacktoberfest, game-engine
Plasma
Cyan Worlds's Plasma game engine
Stars: ✭ 153 (-60.57%)
Mutual labels:  hacktoberfest, game-engine
RawSalmonEngine
A game engine utilising "Tiled" map files
Stars: ✭ 15 (-96.13%)
Mutual labels:  sdl2, 2d-game-engine
Gosu
2D game development library for Ruby and C++
Stars: ✭ 1,762 (+354.12%)
Mutual labels:  hacktoberfest, game-engine
ArchGE
A 2D and 3D C++ Game Engine using SDL2 and OpenGL
Stars: ✭ 15 (-96.13%)
Mutual labels:  sdl2, 2d-game-engine
Defold
Defold is a completely free to use game engine for development of desktop, mobile and web games.
Stars: ✭ 1,938 (+399.48%)
Mutual labels:  hacktoberfest, game-engine
Gamedev4noobs
Olá, sejam bem-vindos ao repositório _gamedev4noobs_ do Estúdio Vaca Roxa. O propósito desse repositório, além de contribuir para o projeto 4noobs, é ensinar o básico do desenvolvimento de jogos para iniciantes. Apresentando boas práticas e insumos para criar games incríveis.
Stars: ✭ 122 (-68.56%)
Mutual labels:  hacktoberfest, game-engine
Ja2 Stracciatella
The continuation of the venerable JA2-Stracciatella project.
Stars: ✭ 258 (-33.51%)
Mutual labels:  hacktoberfest, sdl2
Limonengine
3D FPS game engine with full dynamic lighting and shadows
Stars: ✭ 331 (-14.69%)
Mutual labels:  hacktoberfest, game-engine

Basque

Basque is a cross-platform top-down 2d game engine.


Running on Windows:

Basque Windows demo

Running on Mac:

Basque Mac demo

Running on Linux:

Basque Linux demo

Running in your browser (thanks to WebAssembly and Emscripten):

Basque Wasm demo

Play Basque Wasm

Now with touch controls!


Packages for all platforms are available under the GitHub Action here:

Compiling ...

Or on Itch:

https://ryanpcmcquen.itch.io/basque


Too lazy to do local setup? You can give it a spin using Gitpod, the only downfall will be lack of audio.

Open in Gitpod


Global keyboard shortcuts:

: Move player North

: Move player East

: Move player South

: Move player West

q: Quit

e: Toggle edit mode

Edit mode shortcuts:

l: Toggle map library

Mouse button 1 (left click): Place tile

Mouse button 2 (right click): Select tile


Why do this?

Why not just use Godot/Unity/et cetera? Basque has a very different priority list than these engines. It is not a generic engine. There isn't much here, but it is a good starting point if you are looking to roll your own engine, here is what it does:

  • Compiles cross platform (Linux/Mac/Windows/WebAssembly, see Esoteric ports for other platforms).
  • Visual map editing (with an easy to understand plain text format).
  • Spritesheet animation.
  • Background music.
  • Scrolling.
  • Collision detection.
  • Rudimentary frame rate limiting.
  • Accepts command line arguments (currently only for enabling fullscreen mode).
  • Resolution detection (estimates window size to 80% of the screen or uses the full resolution for fullscreen mode, this can be switched off).
  • High DPI awareness. By default the game will not run in high DPI mode, but it will be aware of high DPI contexts. This prevents things from looking fuzzy with weird scaling settings.
  • Automated GitHub and GitLab packaging pipelines.
  • Scancode based movement (rather than event loop key states). This keeps the controls from being susceptible to operating system key repeat rates and delays.

Everything that is here should not be considered a final or optimal solution, but rather, a simple approach that can be morphed into a better solution. At this point the engine will become more specific to the game I am building, which is why I see this as the best time to open source it. Hopefully, it can be useful to others, either as a starting point, or as a reference of some things you can accomplish with SDL2.


Map editing/layouts/attributes:

The current map system utilizes three main files:

  • map_attributes.txt
  • map_layout.txt
  • map_library.txt

While editing the map, you may use the visual map editor (available in DEBUG_MODE by pressing e) or edit the text files directly. Basque checks the timestamps of the files, and will reload them if they change, you do not need to recompile or relaunch Basque to do this. map_layout.txt also has suffixed versions created, with the intention of supporting future redo/undo functionality. The current number of versions that are kept is 100. This is of course, configurable.

map_attributes.txt follows the following format (all items are integers):

TILE_INDEX:
{ X_CLIP, Y_CLIP }, { NORTH_BORDER, EAST_BORDER, SOUTH_BORDER, WEST_BORDER },

Comments preceded with // in the attributes file are allowed. The other file types do not allow comments.

map_layout.txt and map_library.txt are comma separated integers, representing the tile indices. Newlines represent new rows.

For example:

  0,  1,  2,  3,  4,  1,  5,  _
 27, 16, 16, 16, 16, 16, 17,  _
 27, 16, 16, 16, 16, 16, 17,  _
 27, 16, 28, 16, 16, 16, 17,  _

The visual map editor (available in DEBUG_MODE by pressing e) automatically writes the indices with even spacing. _ is a shortcut for a blank tile (the index for which is configurable under configuration.h).

map_library.txt is intended to be a resource for picking tiles (available in DEBUG_MODE -> EDIT_MODE by pressing l), while editing the world map (map_layout.txt). It has a few special properties. It will not show the player, and it always appears starting at the top left corner of the screen. It is also not editable by the map editor.


Basque currently requires:

  • SDL2
  • SDL2_image
  • SDL2_mixer
  • SDL2_ttf

Getting SDL2 installed:

Linux:

apt:
sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev
dnf:
sudo dnf install SDL2-devel SDL2_image-devel SDL2_mixer-devel SDL2_ttf-devel
eopkg:
sudo eopkg install sdl2-devel sdl2-image-devel sdl2-mixer-devel sdl2-ttf-devel
nix:
nix-env --install SDL2 SDL2_image SDL2_mixer SDL2_ttf

Or whatever the equivalent package is for your distro.

Mac:

brew install sdl2 sdl2_image sdl2_mixer sdl2_ttf

Windows:

Run the script here: install_sdl_on_windows.cmd


Or follow one of the below procedures:

Cmd or Powershell:
nuget install sdl2.nuget -NonInteractive -ExcludeVersion -OutputDirectory C:\INCLUDE\
nuget install sdl2_image.nuget -NonInteractive -ExcludeVersion -OutputDirectory C:\INCLUDE\
nuget install sdl2_mixer.nuget -NonInteractive -ExcludeVersion -OutputDirectory C:\INCLUDE\
nuget install sdl2_ttf.nuget -NonInteractive -ExcludeVersion -OutputDirectory C:\INCLUDE\
mkdir C:\INCLUDE\SDL2\

:: Headers:
robocopy C:\INCLUDE\sdl2.nuget\build\native\include\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_image.nuget\build\native\include\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_mixer.nuget\build\native\include\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_ttf.nuget\build\native\include\ C:\INCLUDE\SDL2\

:: Libs:
robocopy C:\INCLUDE\sdl2.nuget\build\native\lib\x64\dynamic\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_image.nuget\build\native\lib\x64\dynamic\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_mixer.nuget\build\native\lib\x64\dynamic\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_ttf.nuget\build\native\lib\x64\dynamic\ C:\INCLUDE\SDL2\

:: DLLs:
robocopy C:\INCLUDE\sdl2.nuget.redist\build\native\bin\x64\dynamic\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_image.nuget.redist\build\native\bin\x64\dynamic\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_mixer.nuget.redist\build\native\bin\x64\dynamic\ C:\INCLUDE\SDL2\
robocopy C:\INCLUDE\sdl2_ttf.nuget.redist\build\native\bin\x64\dynamic\ C:\INCLUDE\SDL2\

Cmd or Powershell as admin:

:: System DLLs:
robocopy C:\INCLUDE\sdl2.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\System32\ *.dll
robocopy C:\INCLUDE\sdl2.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\SysWOW64\ *.dll

robocopy C:\INCLUDE\sdl2_image.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\System32\ *.dll
robocopy C:\INCLUDE\sdl2_image.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\SysWOW64\ *.dll

robocopy C:\INCLUDE\sdl2_mixer.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\System32\ *.dll
robocopy C:\INCLUDE\sdl2_mixer.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\SysWOW64\ *.dll

robocopy C:\INCLUDE\sdl2_ttf.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\System32\ *.dll
robocopy C:\INCLUDE\sdl2_ttf.nuget.redist\build\native\bin\x64\dynamic\ C:\Windows\SysWOW64\ *.dll
Old school:
  1. Download the latest VC development files from: https://libsdl.org

  2. Place the entire contents of include and lib under C:\INCLUDE\SDL2.

  3. Copy all DLLs under lib to C:\Windows\System32 and C:\Windows\SysWOW64.

  4. Repeat for SDL2_image, SDL2_mixer, and SDL2_ttf.

  5. Profit.


Compiling:

Linux & Mac:

make

Windows:

nmake

Packaging:

To produce a zip containing the binary and all assets, run the below commands.

This should run on any system, as it includes SDL2 and the like, but every system is different, so nothing is guaranteed.

Linux:

make && make --always-make linux

Mac:

make && make --always-make mac

Windows:

nmake && nmake /a windows

WebAssembly (requires emsdk: https://github.com/emscripten-core/emsdk):

make --always-make wasm

Running:

After compiling for your platform, you can launch with ./basque (or basque.exe on Windows). Passing -f or --fullscreen will launch the app in fullscreen, rather than the resolution specified in configuration.h.

Esoteric ports:

BSD:

Basque on BSD

Pocketchip:

Basque on a PocketCHIP

Haiku:

Basque on Haiku Basque on Haiku

In progress:

  • ReactOS
  • Solaris
  • TempleOS
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].