System Requirements Document (SRD) for neon-game

1. Introduction

The neon-game is an innovative multiplayer horror game concept envisioned by Ghala Khalid. Set in a spooky ice cream and cotton candy shop, the game pits players against a terrifying zombie in a suspenseful and cooperative environment. The game is designed to deliver a thrilling experience with unique roles, engaging gameplay mechanics, and a vibrant yet eerie aesthetic. This document outlines the system requirements for the development and delivery of the neon-game.

2. System Overview

The neon-game is a real-time multiplayer horror game where players assume one of three roles: a worker, a protector, or a zombie. The worker focuses on completing tasks to secure the shop, the protector defends the shop using a bat, and the zombie relentlessly hunts the other players. The game emphasizes teamwork, strategy, and suspense, with a unique setting that contrasts the cheerful ambiance of an ice cream and cotton candy shop with the horror of a zombie attack.

The game will be developed for both web and mobile platforms, ensuring accessibility and a seamless gaming experience. The system will support real-time multiplayer interactions, dynamic gameplay mechanics, and an immersive visual and audio design.

3. Functional Requirements

• As a Worker, I should be able to barricade doors to slow down the zombie.
• As a Worker, I should be able to gather supplies like ice cream and cotton candy to distract the zombie.
• As a Worker, I should be able to unlock escape routes to win the game.
• As a Protector, I should be able to use a bat with unlimited durability to fend off the zombie.
• As a Zombie, I should be able to hunt and attack the Worker and Protector.
• As a Player, I should be able to join a multiplayer session with friends or random players.
• As a Player, I should be able to communicate with teammates using in-game chat or voice.
• As a Player, I should be able to customize my character's appearance.
• As a Player, I should be able to select my role (Worker, Protector, or Zombie) before the game starts.
• As a Player, I should experience dynamic lighting and sound effects to enhance the horror atmosphere.
• As a Developer, I should deliver a fully functional game.

4. User Personas

Worker

• Description: A shop employee tasked with securing the shop and completing objectives to ensure survival.
• Primary Actions: Barricading doors, gathering supplies, unlocking escape routes.
• Goal: Survive and complete tasks to win the game.

Protector

• Description: A brave individual dedicated to defending the shop and the Worker from the zombie.
• Primary Actions: Using a bat to fend off the zombie, protecting the Worker.
• Goal: Protect the Worker and survive the zombie attack.

Zombie

• Description: The relentless antagonist hunting the Worker and Protector.
• Primary Actions: Hunting and attacking other players.
• Goal: Eliminate the Worker and Protector to win the game.

5. Visuals Colors and Theme

The neon-game will feature a vibrant yet eerie color palette to create a unique contrast between the cheerful shop setting and the horror elements. Below is the custom color palette:

• Background: #1A1A2E (Dark Midnight Blue)
• Surface: #16213E (Deep Navy)
• Text: #E94560 (Vivid Crimson)
• Accent: #0F3460 (Electric Indigo)
• Muted Tones: #53354A (Dusky Plum)

This palette will evoke a sense of suspense while maintaining the playful essence of the shop setting.

6. Signature Design Concept

The neon-game will feature an unforgettable "Living Candy Nightmare" homepage design. Upon launching the game, players will be greeted with an interactive 3D candy shop environment. The shop will appear cheerful at first, with bright neon signs, spinning cotton candy machines, and ice cream cones floating in mid-air. However, as players hover over different elements, the scene will subtly transform — the neon lights will flicker, the candy will melt into eerie shapes, and the background music will shift to a haunting tune.

Key features of the design:

• Dynamic Transitions: Smooth animations as the shop transitions from cheerful to spooky.
• Interactive Elements: Players can click on objects like ice cream cones or candy jars to reveal hidden messages or clues.
• Zombie Shadow: A shadow of the zombie will occasionally dart across the screen, adding suspense.
• Lighting Effects: Neon lights will pulse and flicker, creating a sense of unease.

This design will set the tone for the game and immerse players in the world of neon-game from the very first interaction.

7. Non-Functional Requirements

• The game must support up to 10 players in a single session.
• The system should ensure low latency for real-time multiplayer interactions.
• The game should be optimized for both web and mobile platforms.
• The user interface should be intuitive and accessible for players of all skill levels.
• The system should maintain a 99.9% uptime for multiplayer servers.
• The game should load within 5 seconds on average devices.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

AI Tools

• Langchain
• Litellm for LLM Routing

Local Orchestration

• Docker
• docker-compose

Server-Side Orchestration

• Kubernetes

9. Assumptions and Constraints

• The game will be developed and tested in the UAE timezone (GMT+4).
• The primary language for the game will be English.
• The game will require an internet connection for multiplayer functionality.
• Development will adhere to a 6-month timeline for the initial release.
• The game will target devices with at least 4GB of RAM and modern browsers.

10. Glossary

• Worker: A player role focused on completing tasks to secure the shop and survive.
• Protector: A player role focused on defending the Worker and the shop from the zombie.
• Zombie: The antagonist role hunting the Worker and Protector.
• Barricade: A defensive measure to block the zombie's path.
• Escape Routes: Paths that the Worker can unlock to win the game.
• Neon-game: The project name for this multiplayer horror game.