lunaengine 0.1.9

A modern 2D game engine with advanced UI and graphics

LunaEngine 🚀

A modern, optimized 2D game engine built with Python and Pygame featuring advanced UI systems, procedural lighting, and embedded asset management.

PyGame Renderer is no longer supported, only OpenGL!

📋 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
Filters	We home a huge amount of filters for your game(Blur, Neon, ...)	✅ Functional
Lighting System	Dynamic lights and shadows	🔄 WIP
Particle Effects	Particle system	🔄 WIP
Image Embedding	Convert assets to Python code	⚠️ Useless
Modular Architecture	Easy to extend and customize	:)

Code Statistics

See this file

TestPyPi

PyPi

🚀 Quick Start

Installation

# First of all, install python 3.9+ (Not tested on older versions)
# Then you can install either from pypy or testpypi
pip install lunaengine
pip install -i https://test.pypi.org/simple/ lunaengine

Ignore

# Install dependencies
pip install -r requirements.txt

# Run a basic example
python examples/ui_comprehensive_demo.py

Requirements

Core Dependencies (required):

pygame>=2.5.0
numpy>=1.21.0
PyOpenGL>=3.1.0
PyOpenGL-accelerate>=3.1.0

Development Tools (optional):

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

# 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+
• OpenGL come actvated by default

Network

Example usage of server scripts:

def auto_save_script(server: Server):
    """Example server script for auto-saving"""
    # This would save game state periodically
    save_data = {
        'timestamp': time.time(),
        'player_count': len(server.clients),
        'game_state': 'running'
    }
    print(f"Auto-save: {save_data}")
    return save_data

def day_night_cycle_script(server: Server):
    """Example server script for day/night cycle"""
    # Calculate current cycle phase (0-1)
    cycle_time = time.time() % 3600  # 1 hour cycle
    cycle_phase = cycle_time / 3600
    
    # Broadcast cycle update to all clients
    cycle_msg = GameStateMessage({'day_night_cycle': cycle_phase})
    server.broadcast(cycle_msg)
    
    return {'cycle_phase': cycle_phase, 'cycle_time': cycle_time}