https://github.com/broothers-inc/narrata
a way to make terminal based role-play games that stand out
https://github.com/broothers-inc/narrata
customization game-development pyfiglet python3 rich rpg-maker terminal text-based
Last synced: 12 months ago
JSON representation
a way to make terminal based role-play games that stand out
- Host: GitHub
- URL: https://github.com/broothers-inc/narrata
- Owner: Broothers-Inc
- License: bsd-3-clause
- Created: 2025-04-01T03:07:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-04T08:10:09.000Z (about 1 year ago)
- Last Synced: 2025-04-04T09:24:21.674Z (about 1 year ago)
- Topics: customization, game-development, pyfiglet, python3, rich, rpg-maker, terminal, text-based
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎭 Narrata – A Text-Based Game Maker
### ⚠️ Still in initial development – Expect Bugs ⚠️
### Current Version: v0.1.0-pre-alpha
Alright, so Narrata is **not** just an RPG Maker. It’s a full-on **text-based game engine** that lets you build whatever thing you want. **Turn-based battles?** Yep. **Branching dialogue?** Easy. **Something completely different?** Yeah ok, I hope it works. No templates, no weird restrictions—just a bunch of tools for making the game **you** want.
## 💡 Why Narrata Though?
- **Fluxura-Powered Styling** – Colors, bold text, animations, make it look cool.
- **Make It Your Own** – Custom combat, enemies, UI, dialogue—yeah do what you want.
- **Actually Fun to Use** – No complicated setup, just Python.
## 🎮 What Can You Do With It?
✔ **Turn-Based Battles** – Build fights with enemies, attacks, and effects.
✔ **Choices That Matter** – Make branching stories that actually change things.
✔ **Text Effects** – Bold, colors, animations, make the terminal look cool.
✔ **Menus & UI** – Shops, settings, whatever you need.
✔ **Completely Customizable** – Just tools to build what **you** want.
## 📦 How to Install
Super easy:
```sh
pip install narrata
```
Narrata uses **Rich** for styling, **PyFiglet** for fancy text effects, and **Fluxura** for text customization, so those will get installed too.
(Yeah Rich does text customisation too but fluxura is our library so 😛)
## 🔥 Get Something Running in Seconds
Here’s a **tiny** game:
```python
# Yeah I'm still making the API lol
```
Run that, and boom—you’ve got something.
---
## 🎨 Customize Everything
You can go crazy with it:
- ⚔️ **Combat System** – Build your own battle mechanics.
- 📝 **Story & Dialogue** – Let players make choices that actually matter.
- 🎭 **Styling & Effects** – Add color, animations, and text effects with **Rich** and **Fluxura**.
- 🎒 **Custom Systems** – Make inventories, skills, puzzles, whatever.
- 🖼️ **Fancy ASCII Titles** – Use **PyFiglet** to generate sick title screens.
## 🔮 What’s Next?
🚀 **Coming Soon:**
- More battle mechanics (status effects, magic, skills).
- Random dungeon generation.
- A quest system with inventory & rewards.
- Even cooler text effects.
## 💬 Wanna Help?
Found a bug? Got a cool idea? **Jump in.** Open an issue, Do something else about it, or just start messing around with it!
## 📜 License
BSD 3-Clause License. **Do whatever you want with it, just keep the credits.**
## 🔥 **Try it out, maybe you'll like it?**
It gives us some motivation to make big projects such as this ;)
