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

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors