Pedre Documentation¶

Welcome to the Pedre documentation! Pedre is a Python RPG framework built on Arcade with seamless Tiled map editor integration.

What is Pedre?¶

Pedre provides everything you need to build Zelda-like RPG games with:

• Tiled Map Integration - Load .tmx maps with automatic layer detection
• NPC Plugin - Animated NPCs with dialog trees and pathfinding
• Dialog Plugin - Multi-page conversations with character names
• Event-Driven Scripting - JSON-based cutscenes and interactive sequences
• Inventory Management - Item collection and categorization
• Portal Plugin - Map transitions with conditional triggers
• Save/Load Plugin - Automatic game state persistence
• Audio Management - Background music and sound effects
• Camera Plugin - Smooth camera following with optional bounds
• Particle Effects - Visual feedback plugin for interactions

Installation¶

pip install pedre

Or with uv:

uv add pedre

Quick Start¶

from pedre import run_game

if __name__ == "__main__":
    run_game()

Configure your game settings with settings.py in your project root:

SCREEN_WIDTH=1280
SCREEN_HEIGHT=720
WINDOW_TITLE="My RPG"
INITIAL_MAP="my_map.tmx"

Documentation Overview¶

Resources¶

• GitHub Repository: msaizar/pedre
• PyPI Package: pypi.org/project/pedre
• Issue Tracker: GitHub Issues
• License: BSD 3-Clause

Credits¶

Built with:

• Python Arcade - 2D game framework
• Tiled Map Editor - Level design tool