SpritePro

SpritePro - a powerful and flexible game development library built on top of Pygame. Provides a comprehensive set of tools for creating 2D games with advanced capabilities.

🎮 Key Features

• Sprite System: Flexible sprite management with built-in physics and game logic
• Physics Engine: Realistic physics simulation with collision detection and handling
• Animation System: Smooth animations with tweening and state management
• UI Components: Ready-to-use buttons, text elements, and interactive components
• Timer System: Precise time management for game events and animations
• Health System: Complete health management with damage, healing, and callbacks
• Mouse Interaction: Simple mouse handling with hover and click detection
• Surface Utilities: Advanced tools for working with surfaces
• Color Effects: Dynamic color effects and animations for visual appeal

🚀 Quick Start

Installation

pip install pygame
git clone https://github.com/NeoXider/SpritePro.git
cd SpritePro

Basic Usage

import spritePro as s
import pygame

# Initialize the library
s.init()

# Create a window
s.get_screen((800, 600), "My Game")

# Create a basic sprite
player = s.Sprite(
    "",
    size=(100, 100),
    pos=s.WH_C,
    speed=3,
)

# Main game loop
while True:
    s.update(fill_color=(0, 0, 100))
    player.handle_keyboard_input()
    player.update()

📚 Documentation

Core Components

• Sprite System - Basic sprite functionality
• Game Sprite - Extended sprites with game logic
• Physics Sprite - Sprites with physics support

UI Components

• Button - Interactive button component
• ToggleButton - Toggle switch component
• Text - Text rendering and management
• Mouse Interaction - Mouse interaction handling

Game Systems

• Animation - Animation and state management
• Tweening - Smooth transitions and easing
• Timer - Time system and scheduling
• Health - Health and damage management

Utilities

• Surface Utilities - Tools for working with surfaces
• Color Effects - Dynamic color effects and animations

Ready Sprites

• Ready Sprites Overview - Pre-built game components guide
• Text_fps - Ready-to-use FPS counter with automatic updates

🎯 Demo Games

Explore our demo games to see SpritePro in action:

• Animation Demo - Sprite animation demonstration
• Physics Demo - Physics simulation example
• Pymunk Demo - Advanced physics with Pymunk
• Ping Pong - Classic Pong game
• Tweening Demo - Animation tweening examples
• Toggle Demo - Interactive toggle buttons showcase
• Color Effects Demo - Dynamic color effects showcase
• Color Text Demo - Text with color effects
• FPS Camera Demo - FPS counter and camera system
• Text FPS Demo - Ready-to-use FPS counter showcase

🛠️ Requirements

• Python 3.7+
• Pygame 2.0+
• Optional: Pymunk (for advanced physics)

📖 API Reference

For detailed API documentation, visit our documentation folder.

🤝 Contributing

We welcome contributions! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is open source. Please check the license file for more information.

Start working with SpritePro today and bring your game ideas to life! 🚀