X Tutup
Skip to content

trobugno/pandora_plus

Repository files navigation

Pandora+ Documentation

Welcome to the Pandora+ documentation! This comprehensive guide will help you build production-ready RPG systems for Godot Engine.

🎯 What is Pandora+?

Pandora+ extends Pandora by BitBrain with specialized RPG-oriented data properties and runtime systems. It provides everything you need to create complex RPG mechanics without reinventing the wheel.

✨ Key Features

📊 Runtime Stats System

Dynamic stat calculation with support for temporary and permanent modifiers. Perfect for buffs, debuffs, equipment bonuses, and level-up systems.

var runtime_stats := PPRuntimeStats.new(base_stats)
var buff := PPStatModifier.create_percent("attack", 50.0, "potion", 60.0)
runtime_stats.add_modifier(buff)

Learn more →

📓 Recipe System

Want to create crafting recipes? Potions? Anything that can be created by combining items? Then the Recipe system is for you!

var wood := Pandora.get_entity(EntityIds.WOOD) as PPItemEntity
var stone := Pandora.get_entity(EntityIds.STONE) as PPItemEntity
var sword := Pandora.get_entity(EntityIds.STONE_SWORD) as PPItemEntity

var wood_ingredient := PPIngredient.new(.., ..)
var stone_ingredient := PPIngredient.new(.., ..)
var sword_result = PandoraReference.new(.., ..)

var ingredients := [wood_ingredient, stone_ingredient]
var recipe := PPRecipe.new(ingredients, sword_result, 0, "CRAFTING")

if PPRecipeUtils.can_craft(player_inventory, recipe):
    PPRecipeUtils.craft_recipe(player_inventory, recipe)

At the end of the process, the used items will automatically disappear from your inventory and the newly created one will appear!

Learn more →

🎒 Inventory System

Flexible inventory with weight limits, auto-stacking, and comprehensive serialization.

var inventory := PPInventory.new()
var health_potion := Pandora.get_entity(EntityIds.HEALTH_POTION) as PPItemEntity
inventory.add_item(health_potion, 5)

Learn more →

🎮 Use Cases

Pandora+ is perfect for:

  • Action RPGs - Real-time combat with stats and effects
  • Turn-Based RPGs - Classic JRPG mechanics
  • Roguelikes - Procedural items and effects
  • MMORPGs - Multiplayer-ready serialization
  • Card Games - Effect stacking and modifiers
  • Strategy Games - Unit stats and abilities

🤝 Contributing

Pandora+ (Core) is open source and welcomes contributions!

💬 Community & Support

  • GitHub Discussions: Ask questions and share projects
  • GitHub Issues: Report bugs and request features
  • Ko-fi: Support development

📄 License

Pandora+ (Core) is licensed under the MIT License.

🙏 Credits

About

RPG-oriented property extensions for BitBrain's Pandora

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

X Tutup