Skip to content

NerineDev/cupid-hex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

Cupid Hex - Chat Otome Game

"A blursed romance where fate plays dirty."

Cupid Hex is a supernatural chat-based otome where one choice locks your fate. Swipe once, commit fully, and let the hex decide how love plays out.

"The die is cast. There is no turning back."

A supernatural chat-based otome mobile game built on Ren'Py, featuring timed conversations, meaningful choices, and a swipe-to-match dating app interface where commitment is permanent and fate is fluid.

🎮 Project Status

Current Phase: Demo Development (Days 1-3)
Engine: Ren'Py 8.0.3 + Mysterious Messenger Framework
Platform Target: Mobile (Android/iOS)
Demo Scope: ~10,000 words, 3 love interests, 3 in-game days


🌙 Core Concept

Players interact with a supernatural dating app where they swipe through potential matches. Once committed to a character, the route locks—mirroring real dating app exclusivity but with supernatural consequences. The game embraces timed chats, meaningful choices without hand-holding, and fair monetization that never sells "correct" answers directly.

Key Differentiators:

  • Swipe-to-match mechanic (MeChat-inspired)
  • 3-day common route before route lock
  • Dual currency system (farmable + premium)
  • Timeline/save mechanics framed narratively
  • Meta-awareness without punishment
  • Realistic phone interface (WhatsApp-style chat hub)

🎯 Demo Love Interests

Character Type Route Theme
Merman Paranormal Ocean mystery, isolation vs connection
Werewolf Paranormal Duality, instinct vs control
Human Human Grounded reality, normalcy vs extraordinary

Non-chosen characters appear as silhouettes after commitment.


🎨 Core Features

✅ Confirmed for Demo

  • Swipe-based character selection
  • Phone interface with contacts screen (tap for profiles, quick call/poke)
  • WhatsApp-style chat hub (tap to open chats)
  • Timed chat unlocks with notifications
  • Poke system (3/day per character)
  • Basic choice system
  • Video calls (modified from phone calls)
  • Character profile screens with current route CG viewing
  • Cupid Cat mascot - Tap the floating two-toned cat for random Fate Threads (and rare Starlight Essence!)

📋 Planned for Full Game

  • "Alea iacta est" commitment screen (route locking)
  • CG Gallery in history mode (unlocks after first route completion)
  • Multi-season content (new characters)
  • Timeline Jump system (chapter restart + exact moment)
  • Meta-awareness progression (subtle → full awareness)
  • Instability system for secret content
  • History mode with choice logging
  • Advanced monetization features

💰 Monetization

Free Currency: Fate Threads

  • Earn: Daily login (5), watch ads (3 per ad, max 5 ads/day), achievements (10-50)
  • Uses: Time skip tickets, basic choice reveals, chapter restart (50 threads)

Premium Currency: Starlight Essence

  • Purchase: Real money only
  • Uses: Route restart cooldown bypass, exact moment timeline jump (150), spicy CGs, max chat speed, premium choice reveals

Ad System

  • 5 ads per day for currency
  • 2 ads per day to reduce route restart cooldown (each ad = -1 day)

🔄 Route & Save System

Route Commitment

  • Days 1-3: Common route, chat with all characters
  • After Day 3: Lock into character with highest affection
  • Tie: Bad ending (need to choose one path)
  • After Lock: Other characters unavailable (future: friendly chats only)

Route Restart

  • Free: 5-day cooldown (reduceable to 3 days with ads)
  • Paid: Bypass cooldown immediately with Starlight Essence

Save System

  • 5 manual save slots (Demo)
  • +1 slot per character (Full game: 8 slots for 3 characters, scales with seasons)
  • 1 auto-save (separate, always active)
  • No punishment for saving/loading
  • Meta-awareness: Characters notice reloads (flavor, not punishment)

🛠️ Technical Stack

  • Engine: Ren'Py 8.0.3
  • Framework: Mysterious Messenger (chat otome engine)
  • Language: Python (Ren'Py Script)
  • Platform: Cross-platform (Windows/Mac/Linux/Android/iOS)

📚 Documentation

  • GAME_DESIGN.md - Detailed mechanics, systems, and implementation specs
  • TODO.md - Development checklist and roadmap

🎭 Philosophy

"Reuse the proven Mystic Messenger system 'brain.' Hide hard mechanics behind narrative meaning. Make commitment feel intentional, not restrictive. Small, polished demo first. Scale later."


🚀 Quick Start

Prerequisites

  • Ren'Py 8.0.3 SDK
  • Python 3.9+

Running the Demo

# Clone repository
git clone [repository-url]

# Open in Ren'Py Launcher
# Select project folder
# Click "Launch Project"

🤝 Contributing

This project is currently in early development. Documentation will be updated as systems are implemented.


🙏 Credits

Built on:

  • Ren'Py Engine by Tom "PyTom" Rothamel
  • Mysterious Messenger Framework by Shauna P.

Inspired by:

  • Mystic Messenger (Cheritz)
  • MeChat
  • Love and Deepspace (Infold Games)
  • Otome Chat Connection
  • Love of fantasy and mythology
  • Love of visual novels

Status Legend:

  • ✅ Confirmed and locked
  • 🚧 In active development
  • 📋 Planned for future
  • 🤔 Under team discussion

About

"A blursed romance where fate plays dirty." Cupid Hex is a supernatural chat-based otome where one choice locks your fate. Swipe once, commit fully, and let the hex decide how love plays out.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors