Enhanced Renpy Inventory System

This inventory system is the next step in my previous work, Simple Ren'Py Inventory,but with added functionality and greater customization. Whether you're building a small visual novel or a complex RPG, this system is designed to scale with your needs, offering advanced features while remaining simple enough for beginners to implement.

 

Key Features

1. Interactive In-Game Tutorial

• A fun and easy-to-follow tutorial built directly into the system that walks you through how to add, remove, and manage items in your inventory.
• Includes tips on unlocking additional slots and customizing the system. While the tutorial has a bit of personality (with some quirky jokes thrown in), it’s designed to make sure you understand the system quickly and easily.
• Ideal for those new to Ren'Py or inventory systems, with an engaging approach that makes learning less intimidating.

2. Dynamic Slot Management

• Unlock and Lock Slots: Dynamically unlock and lock inventory slots during gameplay using simple methods like unlock_slots(count) and lock_slots(count).
• Expand Inventory Capacity: Add more slots to the inventory on the fly with increase_slot_count(additional_slots), which can be used as part of gameplay progression, allowing players to increase their inventory capacity as they advance.

3. Smart Item Management

• Item Stacking: Automatically stacks items up to 99 per slot. Excess items will automatically be distributed to available slots, ensuring your inventory stays neat and organized.
• Auto Sorting: After removing an item, the system automatically reorders the inventory, placing empty slots at the end for a cleaner, more organized interface.

4. Fully Customizable

• This system is easily customizable, allowing you to adjust the initial number of slots, the maximum number of items per slot, and much more to fit your game's needs.
• The visual appearance of the inventory can also be tailored to match the style of your game, with easy integration of custom notifications and icons.

5. Custom notification system for your Renpy inventory

• Modular notification system and easy to customize.
• Notifications for error handling and different scenarios.
• Easy to add sound and custom design notification pop-ups.
• Super simple notification function to avoid complexity.

Why Use This System?

If you’re building a Ren'Py game and need an easy-to-implement yet flexible inventory system, this is the solution for you. It’s designed to work with any kind of Ren'Py game, from simple visual novels to intricate RPGs. With an interactive tutorial, dynamic slot management, and smart item handling, you can focus on creating your game, while this inventory system takes care of all the heavy lifting.

It’s built with scalability in mind, so it can evolve with your game. Whether you need a simple item manager or a more complex inventory system, it adapts to your needs.

How to use it?

Download the tutorial project from this page.

Run the tutorial game and follow the instructions.

Here’s an example of how to implement the inventory system into your game:

# Sample code for an inventory system
label start:
    # Add items to inventory
    $ inventory.add_item("apple", 1)
    $ inventory.add_item("orange", 1)
    
    # Remove an item
    $ inventory.remove_item("orange", 1)
    
    # Unlock additional slots
    $ inventory.unlock_slots(7)
    
    # Expand inventory capacity
    $ inventory.increase_slot_count(7)

Folder Structure

The system is organized for quick integration, with all necessary components (scripts, sounds, images) in their own directories, ready for plug-and-play.

YourGameProject/
│
├── game/
│   ├── components/           # Modular components
│   │   ├── inventory_system/
│   │   │   ├── images/       # Icons and UI images
│   │   │   ├── inventory.rpy # Core inventory logic
│   │   │   └── screens.rpy   # UI screens for inventory
│   │   └── custom_notification/
│   │       ├── images/       # Notification system assets
│   │       └── custom_notification.rpy
│   ├── script.rpy            # Main game script
│   └── README.md             # Documentation

Compatibility & Requirements

• Engine: Ren'Py (Tested on version 8.0 and above)
• Language: Python (Integrated with Ren'Py scripting)

Final Thoughts

This inventory system was created as a gift to the Ren'Py development community. My goal is to save you time, so you can focus more on the storytelling and gameplay aspects of your project. I hope this system helps you get up and running faster and that it provides a foundation for you to learn from, expand on, and adapt to fit your unique needs.

It’s open for customization, so whether you’re new to Ren'Py or a seasoned developer, you can tweak it to suit your game’s requirements. If you have any feedback, ideas for improvements, or questions, feel free to reach out. I’d love to hear how you use it in your projects or if you come up with creative ways to make it even better!

Enjoy, and happy game development!

Original GitHub project link