popka 0.0.14
A lightweight and beginner-friendly 2D game engine for the D programming language.
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
This package provides sub packages which can be used individually:
popka:setup - A helper script that automates the project setup.
popka:web - A helper script to assist with the web export process.
Popka
Popka is a lightweight and beginner-friendly 2D game engine for the D programming language. It focuses on providing a simple foundation for building 2D games.
import popka;
bool gameLoop() {
drawDebugText("Hello world!");
return false;
}
void gameStart() {
lockResolution(320, 180);
updateWindow!gameLoop();
}
mixin addGameStart!(gameStart, 640, 360);
[!WARNING] This is alpha software. Use it only if you are very cool.
Supported Platforms
- Windows
- Linux
- MacOS
- Web
Games Made With Popka
Dependencies
Installation
This guide shows how to install Popka and its dependencies using DUB. While DUB simplifies the process, Popka itself doesn't require DUB.
Create a new folder and run inside the following commands:
dub init -n
dub run popka:setup
The final line modifies the default app.d and dub.json files, downloads raylib, and creates the necessary folders for Popka to function properly. The following folders will be created:
- assets: This folder is used to store game assets.
- web: This folder is used for exporting to the web.
Once the installation is complete, you should be able to compile/run with:
dub run
You can pass offline
to the script if you don't want to download raylib.
For more info about exporting to web, read this.
Documentation
For an initial understanding, the examples folder and the engine.d file can be a good starting point. You can also read the TOUR.md file for a more in-depth overview.
Attributes and BetterC Support
This project offers support for some attributes (@safe
, @nogc
, nothrow
) and aims for good compatibility with BetterC.
If you encounter errors with BetterC, try using the -i
flag.
Web Support
For exporting to web, your project needs to be compatible with BetterC. The web folder contains a helper script to assist with the web export process. If you use DUB, you can run the script with:
dub run popka:web
raylib Bindings
Popka provides bindings for raylib that are compatible with BetterC and the web.
import popka.ray;
int main() {
const int screenWidth = 800;
const int screenHeight = 450;
InitWindow(screenWidth, screenHeight, "raylib [core] example - basic window");
SetTargetFPS(60);
while (!WindowShouldClose()) {
BeginDrawing();
ClearBackground(RAYWHITE);
DrawText("Congrats! You created your first window!", 190, 200, 20, LIGHTGRAY);
EndDrawing();
}
CloseWindow();
return 0;
}
Note
I add things to Popka when I need them.
License
The project is released under the terms of the MIT License. Please refer to the LICENSE file.
- 0.0.14 released a month ago
- Kapendev/popka
- MIT
- Copyright © 2024, Alexandros F. G. Kapretsos
- Authors:
- Sub packages:
- popka:setup, popka:web
- Dependencies:
- joka
- Versions:
-
0.0.22 2024-Sep-13 0.0.21 2024-Sep-10 0.0.20 2024-Sep-07 0.0.19 2024-Sep-05 0.0.18 2024-Sep-03 - Download Stats:
-
-
0 downloads today
-
1 downloads this week
-
13 downloads this month
-
53 downloads total
-
- Score:
- 0.9
- Short URL:
- popka.dub.pm