# LunaEngine 🚀
A modern, optimized 2D game engine built with Python and Pygame featuring advanced UI systems, procedural lighting, and embedded asset management.
## 📋 Features
| Feature | Description | Status |
|---------|-------------|---------|
| **Advanced UI** | Roblox Studio-like UI components | ✅ Functional |
| **OpenGL Rendering** | Hardware-accelerated graphics | ✅ Functional |
| **Performance Tools** | FPS monitoring, hardware detection | ✅ Functional |
| **Themes** | The engine have pre-built themes | ✅ Functional |
| **Lighting System** | Dynamic lights and shadows | 🔄 WIP |
| **Particle Effects** | Particle system | 🔄 WIP |
| **Image Embedding** | Convert assets to Python code | ⚠️ Buggy |
| **Modular Architecture** | Easy to extend and customize | |
# Code
[See this file](./lunaengine/CODE_STATISTICS.md)
[TestPyPi](https://test.pypi.org/project/lunaengine/)
[PyPi](https://pypi.org/project/lunaengine/)
## 🚀 Quick Start
### Installation
```bash
# Install dependencies
pip install -r requirements.txt
# Run a basic example
python examples/basic_game.py
```
## Requirements
### Core Dependencies (required):
```bash
pygame>=2.5.0
numpy>=1.21.0
PyOpenGL>=3.1.0
PyOpenGL-accelerate>=3.1.0
```
### Development Tools (optional):
```bash
black>=22.0.0
flake8>=4.0.0
pytest>=7.0.0
setuptools>=65.0.0
wheel>=0.37.0
twine>=4.0.0
```
## Build
```bash
# Make build
python -m build
# Check files
twine check dist/*
# Upload testpypi
twine upload --config-file .pypirc --repository testpypi dist/*
# Upload PyPi
twine upload --config-file .pypirc --repository pypi dist/*
```
## OpenGL
- Require OpenGL 3.3+
- ``LunaEngine("Game Title", screen_width, screen_height, use_opengl=True)``
Raw data
{
"_id": null,
"home_page": "https://github.com/MrJuaumBR/lunaengine",
"name": "lunaengine",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "game, engine, 2d, graphics, pygame",
"author": "MrJuaum",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/de/17/7c64e5186c6b3bdd05eac7faab6fa4cb7cf386d7c726c289358cda70737b/lunaengine-0.1.1.tar.gz",
"platform": null,
"description": "# LunaEngine \ud83d\ude80\r\n\r\nA modern, optimized 2D game engine built with Python and Pygame featuring advanced UI systems, procedural lighting, and embedded asset management.\r\n\r\n## \ud83d\udccb Features\r\n\r\n| Feature | Description | Status |\r\n|---------|-------------|---------|\r\n| **Advanced UI** | Roblox Studio-like UI components | \u2705 Functional |\r\n| **OpenGL Rendering** | Hardware-accelerated graphics | \u2705 Functional |\r\n| **Performance Tools** | FPS monitoring, hardware detection | \u2705 Functional |\r\n| **Themes** | The engine have pre-built themes | \u2705 Functional |\r\n| **Lighting System** | Dynamic lights and shadows | \ud83d\udd04 WIP |\r\n| **Particle Effects** | Particle system | \ud83d\udd04 WIP |\r\n| **Image Embedding** | Convert assets to Python code | \u26a0\ufe0f Buggy |\r\n| **Modular Architecture** | Easy to extend and customize | |\r\n\r\n# Code\r\n[See this file](./lunaengine/CODE_STATISTICS.md)\r\n[TestPyPi](https://test.pypi.org/project/lunaengine/)\r\n[PyPi](https://pypi.org/project/lunaengine/)\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\n# Install dependencies\r\npip install -r requirements.txt\r\n\r\n# Run a basic example\r\npython examples/basic_game.py\r\n```\r\n\r\n## Requirements\r\n\r\n### Core Dependencies (required):\r\n\r\n```bash\r\npygame>=2.5.0\r\nnumpy>=1.21.0\r\nPyOpenGL>=3.1.0\r\nPyOpenGL-accelerate>=3.1.0\r\n```\r\n\r\n### Development Tools (optional):\r\n\r\n```bash\r\nblack>=22.0.0\r\nflake8>=4.0.0\r\npytest>=7.0.0\r\nsetuptools>=65.0.0\r\nwheel>=0.37.0\r\ntwine>=4.0.0\r\n```\r\n\r\n## Build\r\n```bash\r\n# Make build\r\npython -m build\r\n\r\n# Check files\r\ntwine check dist/* \r\n\r\n# Upload testpypi\r\ntwine upload --config-file .pypirc --repository testpypi dist/*\r\n\r\n# Upload PyPi\r\ntwine upload --config-file .pypirc --repository pypi dist/*\r\n```\r\n\r\n## OpenGL\r\n- Require OpenGL 3.3+\r\n- ``LunaEngine(\"Game Title\", screen_width, screen_height, use_opengl=True)``\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A modern 2D game engine with advanced UI and graphics",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://mrjuaumbr.github.io/lunaengine/",
"Issue Tracker": "https://github.com/MrJuaumBR/lunaengine/issues",
"Repository": "https://github.com/MrJuaumBR/lunaengine"
},
"split_keywords": [
"game",
" engine",
" 2d",
" graphics",
" pygame"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ffa28d35f017be3ef1d726c917b91fb2890d5ad16afbfc660badec60ffcf6ea4",
"md5": "77a96b606c849bf1315f3154c99c423a",
"sha256": "63d2ad1be59591741e567e2003737cf9f4bd0e08959d4e7e81b1e1673c611738"
},
"downloads": -1,
"filename": "lunaengine-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "77a96b606c849bf1315f3154c99c423a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 81119,
"upload_time": "2025-11-02T19:22:41",
"upload_time_iso_8601": "2025-11-02T19:22:41.848935Z",
"url": "https://files.pythonhosted.org/packages/ff/a2/8d35f017be3ef1d726c917b91fb2890d5ad16afbfc660badec60ffcf6ea4/lunaengine-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "de177c64e5186c6b3bdd05eac7faab6fa4cb7cf386d7c726c289358cda70737b",
"md5": "c3a8406a456cf438fdbe42c954a8070d",
"sha256": "289fc31b8db90794a515ef85f092caf9a034f4a4b321970af021e231203430e9"
},
"downloads": -1,
"filename": "lunaengine-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "c3a8406a456cf438fdbe42c954a8070d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 72713,
"upload_time": "2025-11-02T19:22:43",
"upload_time_iso_8601": "2025-11-02T19:22:43.361378Z",
"url": "https://files.pythonhosted.org/packages/de/17/7c64e5186c6b3bdd05eac7faab6fa4cb7cf386d7c726c289358cda70737b/lunaengine-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-02 19:22:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MrJuaumBR",
"github_project": "lunaengine",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pygame",
"specs": [
[
">=",
"2.5.0"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.21.0"
]
]
},
{
"name": "PyOpenGL",
"specs": [
[
">=",
"3.1.0"
]
]
},
{
"name": "PyOpenGL-accelerate",
"specs": [
[
">=",
"3.1.0"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"22.0.0"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "setuptools",
"specs": [
[
">=",
"65.0.0"
]
]
},
{
"name": "wheel",
"specs": [
[
">=",
"0.37.0"
]
]
},
{
"name": "twine",
"specs": [
[
">=",
"4.0.0"
]
]
}
],
"lcname": "lunaengine"
}
JSON
