System Requirements Document for gilded-senior

Introduction

The project "gilded-senior" is a mobile-optimized isometric 2.5D survival simulation game set in a Ukrainian apartment. The game is designed to provide an atmospheric and realistic experience of surviving in a typical Ukrainian apartment block, with detailed mechanics and touch controls optimized for mobile devices.

System Overview

The "gilded-senior" project aims to deliver a standalone HTML5 game that runs smoothly on mobile browsers. The game will feature a realistic, atmospheric aesthetic with isometric 2.5D graphics, simulating life in a Ukrainian apartment block. The gameplay involves surviving for 100 days, managing resources, and interacting with the environment and NPCs.

Functional Requirements as Story Points

• As a Player, I should be able to control the character using a virtual joystick on the left side of the screen for movement.
• As a Player, I should be able to interact with objects and NPCs using an "Action" button on the right side of the screen.
• As a Player, I should be able to access my inventory and status using a dedicated button on the right side of the screen.
• As a Player, I should be able to survive for 100 days starting from June 1st, managing health, stamina, and odor levels.
• As a Player, I should be able to navigate a 9-story apartment building, with specific interactions on each floor.
• As a Player, I should be able to manage my character's needs, such as eating, sleeping, and engaging in hobbies.
• As a Player, I should be able to experience dynamic events such as the elevator breaking after 10 days.
• As a Player, I should be able to interact with neighbors and experience random dialogues.
• As a Player, I should be able to shop for necessities at "Shop 41" using in-game currency.
• As a Player, I should be able to work on a 2/2 schedule, with different outcomes based on the character's rest status.

User Personas

• Player: The primary user who interacts with the game, managing the character's survival and engaging with the environment.

Core User Flows

• Player starts the game -> Controls character using virtual joystick -> Interacts with objects/NPCs using action button -> Manages inventory/status -> Navigates apartment building -> Engages in daily survival tasks -> Experiences dynamic events -> Completes work schedule -> Shops for necessities -> Survives for 100 days.

Visuals Colors and Theme

• primary: #2E8B57 (Sea Green)
• primary_light: #66CDAA (Medium Aquamarine)
• secondary: #4682B4 (Steel Blue)
• accent: #FF4500 (Orange Red)
• highlight: #FFD700 (Gold)
• bg: #F5F5F5 (White Smoke)
• surface: #FFFFFF (White)
• text: #000000 (Black)
• text_muted: #696969 (Dim Gray)
• border: #D3D3D3 (Light Gray)

Signature Design Concept

The landing page of "gilded-senior" will feature an interactive isometric apartment building. Users can click and drag to rotate the building, revealing different floors and rooms. Each room will have animated elements that react to user interactions, such as lights turning on or off and characters moving within the space. This interactive model will provide an engaging overview of the game's environment, enticing users to explore further.

Landing Hero Motion Brief

The hero section will feature a continuous loop of the apartment building's exterior, with windows lighting up and shadows moving to simulate the passage of time. As users interact, they will see characters moving within the rooms, highlighting the dynamic nature of the game world. The animation will be built using motion/react for smooth transitions and interactions.

Interaction Model & Motion Direction

The landing page will use an "animated" interaction model, with moderate scroll-triggered reveals and hover transitions. The hero section will include a continuous 2D motion loop, enhancing the storytelling aspect of the game.

Non-Functional Requirements

• The game must run smoothly on mobile browsers without requiring additional plugins.
• The HTML file should be self-contained, including all necessary CSS and JavaScript.
• The game should support touch events for intuitive mobile controls.

Tech Stack

• Frontend: HTML5, CSS, JavaScript (Canvas 2D)
• Backend: Not applicable (single HTML file)
• Database: Not applicable (single HTML file)
• AI Models: Not applicable

Assumptions and Constraints

• The game will be optimized for mobile devices, specifically targeting modern mobile browsers.
• The game will be delivered as a single HTML file for ease of distribution and use.

Glossary

• Isometric 2.5D: A graphical projection that simulates three dimensions on a two-dimensional plane.
• NPC: Non-Playable Character, characters in the game that the player can interact with.
• HUD: Heads-Up Display, the part of the game interface that displays important information to the player.