README.md

• Zig-Platformer
• Prerequisites
  • Zig version
  • Support OS
  • Build and run
  • Key operation
  • Tutorial sources
  • SDL librarys
  • Other SDL game tutorial platfromer project
  • Other project

Zig-Platformer

---

Tutorial: Writing a 2D Platform Game in Zig language with SDL2 / SDL3 / SDL_ttf.

This repository has been inherited from Nim-Platformer, LuaJIT-Platformer and Nelua-Platformer project.

• Document
  English: https://hookrace.net/blog/writing-a-2d-platform-game-in-nim-with-sdl2/
  Japanese: https://postd.cc/writing-a-2d-platform-game-in-nim-with-sdl2/

Skin database https://ddnet.org/skins

Prerequisites

Versions

---

zig-0.15.2
SDL2: 2.32.10
SDL2: 3.2.26
SDL_ttf: 3.2.2

Support OS

---

	Windows	Linux	MacOS
SDL2	YES	YES	YES
SDL3	YES	YES	?

• Windows11

  • MSys2/MinGW basic commands (make, rm, cp, strip ...)

• Linux: Debian families

  $ sudo apt install libopengl-dev libgl1-mesa-dev
  $ sudo apt install libsdl2-dev libsdl2-ttf-dev
  

  See SDL3 intallation on Linux

• MacOS: P.R.

Build and run

---

git clone https://github.com/dinau/zig-platformer
cd zig-platformer/tutorial

For instance,

cd sdl3/part3
make run       

or

cd sdl3/part3
zig build --release=fast
cd zig-out/bin 
part3.exe

You can build SDL2 tutorials same as SDL3.

Key operation

---

Key	Function
Up,Space, J, K	Jump
Left, A, H	Left
Right, D, L	Right
R	Restart
Q	Quit, Esc

Tutorial sources

---

	Part1	Part2	Part3 (Showing item)	Part4	Part5 (Moving item)	Part6	Part7	Part8 (Almost completed)	Part9
SDL2	part1	part2	part3	part4	part5	part6	part7	part8	-
SDL3	part1	part2	part3	part4	part5	part6	part7	part8	-

SDL librarys

---

https://github.com/libsdl-org/SDL/releases

Other SDL game tutorial platfromer project

---

Language		Project
Nim	Compiler	Nim-Platformer / sdl3_nim
LuaJIT	Script	LuaJIT-Platformer
Nelua	Compiler	NeLua-Platformer
Zig	Compiler	Zig-Platformer
C3	Compiler	C3-Platformer WIP
Ruby	Script	Ruby-Platformer WIP

Other project

---

Language		Project
Nim	Compiler	ImGuin, Nimgl_test, Nim_implot
Lua	Script	LuaJITImGui
Zig, C lang.	Compiler	Dear_Bindings_Build
Zig	Compiler	ImGuinZ
NeLua	Compiler	NeLuaImGui
Python	Script	DearPyGui for 32bit WindowsOS Binary
Ruby	Script	IgRuby-Examples