1
0
Fork 0
forked from waifu/kemoverse
kemoverse/readme.md
2025-05-23 00:59:42 -03:00

2.6 KiB

Kemoverse

A gacha-style bot for the Fediverse built with Python. Users can roll for characters, trade, duel, and perhaps engage with popularity-based mechanics. Currently designed for use with Misskey. Name comes from Kemonomimi and Fediverse.

Fediverse Gacha Bot Logo

🔧 Features

Implemented

  • 🎲 Character roll system
  • 🎴 Cards stats system
  • 🧠 Core database structure for characters and stats
  • 📦 Basic support for storing pulls per user

🧩 In Progress

  • 📝 Whitelist system to limit access
  • ⏱️ Time-based limitations on rolls
  • ⚔️ Dueling system

🧠 Planned Features (Long Term)

🛒 Gameplay & Collection

  • 🔁 Trading system between users
  • Favorite characters (pin them or set profiles)
  • 📢 Public post announcements for rare card pulls
  • 🧮 Leaderboards
    • Most traded Characters
    • Most owned Characters
    • Most voted Characters
    • Most popular Characters (via usage-based popularity metrics)
    • Users with the rarest Characters

🎨 Card Aesthetics

  • 🖼️ Simple card template for character rendering
  • 🌐 Web app to generate cards from images

🌍 Fediverse Support

Anyone from the fediverse can play, but the server only works using a Misskey instance. Want to rewrite the program in Elixir for Pleroma? Let us know!

🗃️ Tech Stack

  • Python (3.11+)
  • SQLite
  • Fediverse API integration (via Misskey endpoints)
  • Flask
  • Modular DB design for extensibility

💡 Philosophy

The bot is meant to feel light, fun, and competitive. Mixing social, gacha and duel tactics.

🧪 Getting Started (coming soon)

Instructions on installing dependencies, initializing the database, and running the bot locally will go here.