Popochiu

A Godot plugin for making point-and-click adventure games, inspired by Adventure Game Studio and PowerQuest.

🌎👉🏽 Lee la versión en Español 👈🏽🌎

---

🔍 Read the documentation to learn what you can do with the plugin.

❤️ Join the Carenalgas Discord to keep up with updates and releases.

About

Popochiu consists of two parts: the runtime engine and the editor plugin. Together, they help you create the nodes and resources needed to build classic adventure games in Godot.

It is inspired by well-established adventure game creation tools such as Adventure Game Studio and PowerQuest, a Unity plugin by Powerhoof. Popochiu organizes games into Rooms, where Characters can move around and interact with Props and Hotspots, and it also provides built-in Inventory and Dialogue systems.

Features

Engine

• Seamless support for retro-style, pixel-art, and high-resolution 2D games
• Character management, including support for different emotions during dialogues
• Tunable text speed and auto-advance
• Rooms filled with interactive props, hotspots, local characters, multiple walkable areas, reactive regions, and position markers
• Inventory management for your main character
• Script-based dialogues for complex cutscenes and interactions
• Save and load support for game sessions
• Actions history management
• Customizable room transitions
• Multiple out-of-the-box graphical interfaces, with the freedom to create your own
• Command-based GUI framework
• Easy management of background music and sound effects
• 100% pure Godot code and resources, with no lock-in

Editor

• Popochiu Dock for easy access to all game elements
• Intuitive, modern GDScript-based scripting API, with autocomplete features
• Visual creation of all the game elements, with custom gizmos for special properties
• Dialogue tree management
• Audio management for background music and sound effects
• Import rooms, characters, and inventory items from Aseprite source files with their full structure

And much more is on the way. Popochiu is in active development, and we maintain a public release roadmap.

Releases

The latest stable public release is Popochiu 2.1.0, which targets Godot 4.6.

Use the table below to determine which version to download for your Godot version:

| Required Godot version | Popochiu Release | | --- | --- | | 4.6 | Popochiu 2.1.0 | | 4.3 | Popochiu 2.0.3 |

Support for Godot 3 is officially dropped. Releases are still available for legacy versions, but they won't receive any update or bugfix and usage is discouraged.

Installation

1. Download the correct release for your Godot version.
2. Extract it and copy the addons folder into your project folder.
3. Open your Godot project and enable the Popochiu plugin: Project > Project Settings then select the Plugins tab on top.
4. You will see the game setup wizard. Follow the instructions and choose the options that best fit your project.
5. Once the setup is complete, you will see the Popochiu dock in the top-left area of the editor. That's it!

Getting started

Once Popochiu is installed:

1. Run the setup wizard.
2. Create your first room.
3. Create a character and place it in the room.
4. If it is your first time using the plugin, follow the getting-started guide.

Documentation

• Find the documentation for the latest version here.

Made with Popochiu

• Gustavo the Shy Ghost - English.
• Detective Paws - English.
• The Sunnyside Motel in Huttsville Arkansas - English.
• Zappin' da Mubis - English.
• Reality-On-The-Norm: Ghost of Reality's Past (password: popochiu) - English.
• Breakout (demo) - English.
• Poin'n'Sueldo - Spanish.
• Dr. Rajoy - Spanish.
• I'm Byron Mental - Spanish.
• Benito Simulator - Spanish.
• Pato & Lobo - English and Spanish (this was the first game made with Popochiu!).

Credits

Popochiu is a project by Carenalga. It is now maintained by Carenalga and StickGrinder, with many contributions from other members of our lovely community.

:heart::heart::heart: Special thanks to :heart::heart::heart:

• Edmundito, Whyschuck, and Turquoise for their monthly contribution to our Ko-fi
• Illiterate Code Games, @vonagam, @JuannFerrari, and Whyschuck for their many valuable contributions

Contributing

Contributions are welcome. If you would like to help, please start with the documentation:

• Contributing to Popochiu
• Definition of Done

License

This project is licensed under the terms of the MIT License.