Inspiration

Our inspiration came from a desire to elevate the traditional galgame (romance simulation) genre. We wanted to create a realistic, mature, and deeply narrative-driven game set in modern Tokyo, moving beyond simple dialogue trees. We were inspired by the challenge of simulating the complex, real-life balancing act of university, personal finances, and the intricate web of adult relationships.

Technically, we drew inspiration from the robust, state-driven architecture of simulation games, ensuring that every player action and stat change would have a meaningful and persistent impact on the game world and its characters.

alt text

What it does

Ririka's Secret is a PC and web-based romance simulation where players take on the role of a university student who moves to Tokyo. He finds himself living in a host family with his mother's friend, the alluring 40-year-old professor Ririka, and her 19-year-old daughter, Mei.

The game tasks the player with:

Managing Core Stats: Juggling six key attributes: Academics, Money, Stamina, Stress, and Charm. Failing in academics can lead to a "Bad End."

Strategic Time Management: Planning a daily schedule across "Morning," "Afternoon," and "Evening" slots to attend classes, work a part-time job, study, or socialize.

Building Deep Relationships: Pursuing relationships with five unique and complex heroines, including the mature professor, the "tsundere" classmate, the professional colleague, the mysterious "ice queen," and a popular cosplayer.

Making Meaningful Choices: Engaging in a deep dialogue system where choices directly impact affection levels, character stats, and unlock new event branches.

Experiencing Tokyo: Exploring iconic locations like Shibuya, Shinjuku, and Akihabara to go on dates, work, and advance the plot.

alt text

How we built it

We built Ririka's Secret on a foundation of a centralized state-management engine. This design was crucial for handling the game's high level of complexity.

Data-Driven Architecture: The entire game's content is separated from its logic using a series of JSON files:

characters: Stores all attributes, relationship statuses, background stories, and states for the player and every NPC.

events: Defines the entire narrative structure. This includes all event trigger conditions, dialogue trees, player choices, and the corresponding outcomes (e.g., +10 Affection, -5 Stress).

game_data: Contains all information for in-game locations, items, gifts, and their associated costs or effects.

Core Game Loop: The engine operates on a simple loop:

The player makes a choice (e.g., "Study at the library").

The engine updates the central gameState (e.g., Stamina -10, Academics +5, Time advances to "Evening").

The engine then re-evaluates the new gameState to check for any new event triggers.

Finally, it renders the next scene and set of available options for the player.

This architecture makes it highly scalable and allows us to manage thousands of potential narrative branches and stat combinations.

alt text

Challenges we ran into

Balancing the "Life Sim" Economy: The biggest challenge was balancing the core stats. We had to ensure players felt a realistic "squeeze" between needing to earn money, study for exams, and still have enough stamina and time to pursue relationships. It required extensive tuning to prevent one strategy (e.g., "only work") from breaking the game.

Narrative Complexity: Managing the branching logic for five separate heroines—each with her own multi-stage relationship, unique events, and potential "rival" events—was a massive undertaking. We had to develop a rigorous system for flagging event pre-conditions to prevent plot holes or contradictions.

Tonal Consistency: Writing for characters at different stages of life (from a 19-year-old student to a 40-year-old single mother) while maintaining a consistent, mature, and respectful tone was a significant writing challenge.

Accomplishments that we're proud of

A Truly Dynamic World: We are incredibly proud of the dynamic relationship system. The heroines don't just interact with the player; they interact with each other, and the world feels alive and responsive to the player's choices.

High-Freedom Player Agency: The robust stat and schedule system gives players genuine control to shape their own protagonist. They can be a bookworm, a socialite, a hard worker, or anything in between, and the game will react accordingly.

Deep, Character-Driven Storytelling: We successfully created five unique and compelling narrative lines that go beyond simple romance tropes. Each heroine has a deep, personal story, and guiding them to a happy ending feels like a genuine achievement.

What we learned

A Solid Foundation is Everything: We learned that a clean, centralized state-management system is the only way to build a complex narrative game without getting lost.

Data-Driven Design is Freedom: Separating the game's story content from its logic (engine) was the best decision we made. It allowed our writers to work independently and empowered us to easily add or tweak events without touching the core code.

Balancing is a Never-Ending Process: A life-sim is never "perfectly" balanced. We learned that the "feel" of the game's difficulty is subjective and requires constant iteration and player feedback.

alt text

What's next for Ririka's Secret - An AI-driven Galgame

The current version of Ririka's Secret is a robust, data-driven framework. The next and most exciting phase is to evolve it into a truly AI-driven Galgame.

Dynamic AI Dialogue: We plan to integrate a Large Language Model (LLM) to power the dialogue system. Instead of selecting from 3-4 pre-scripted options, players will be able to type or choose from dynamically generated responses. The AI, acting as the heroine, will respond in real-time based on her defined personality and the current game state.

Emergent Event Generation: We want to use AI to create a truly "endless" game. The AI could analyze the player's current stats and relationships to generate small, unique, and emergent random events that are not pre-scripted, making every playthrough unique.

Full Production: Alongside AI development, we plan to add full voice acting for all main characters, increase the number of high-quality CG art scenes, and expand the world with new locations and side characters.