Skip to content

This is where I will place the most stable version of the game for playtesting. ONLY IMPORT STABLE, SEMI-TESTED VERSIONS HERE

Notifications You must be signed in to change notification settings

keysoldtech/Test.QC

Repository files navigation

GHBanner

Quest & Chronicle - Multiplayer Card Game

A multiplayer digital prototype for the Quest & Chronicle card game, now with offline support!

View your app in AI Studio: https://ai.studio/apps/drive/1XbvKpi1-w3zrHql2iyz5-lItdKDa29q8

Features

  • Multiplayer Gameplay: Create or join game rooms with friends
  • Multiple Character Classes: Choose from Barbarian, Cleric, Mage, Ranger, Rogue, or Warrior
  • Progressive Difficulty: Beginner, Advanced, and Custom game modes
  • Voice Chat: Built-in WebRTC voice communication
  • Offline Support: Play the game even when offline thanks to PWA technology
  • Mobile Responsive: Optimized for both desktop and mobile devices

Offline Capabilities

This app is a Progressive Web App (PWA) with full offline support:

  • Service Worker Caching: All core assets are cached for offline access
  • Offline Detection: Visual indicator when you're offline or disconnected
  • Connection Status: Real-time monitoring of network and server connection
  • Installable: Can be installed on your device like a native app
  • Auto-Update: Automatically updates to the latest version when online

How Offline Mode Works

  1. First Visit: The app caches all necessary files (HTML, CSS, JS, images, fonts)
  2. Subsequent Visits: Loads instantly from cache, even without internet
  3. Multiplayer Features: Requires internet connection for room creation/joining and real-time gameplay
  4. Local Features: Menu navigation, game rules, and UI work offline

Connection Status Indicator

The app displays a status banner at the top of the screen:

  • ⚠️ Offline Mode: No internet connection detected
  • ⚠️ Connecting...: Internet available but server connection in progress
  • Hidden: Successfully connected and ready for multiplayer

Run Locally

Prerequisites: Node.js

  1. Install dependencies:

    npm install
  2. Start the server:

    npm start
  3. Open your browser to http://localhost:3000

Installing as PWA

Desktop (Chrome/Edge)

  1. Visit the app in your browser
  2. Click the install icon in the address bar
  3. Click "Install" in the prompt

Mobile (iOS/Android)

  1. Open the app in your mobile browser
  2. iOS: Tap the Share button, then "Add to Home Screen"
  3. Android: Tap the menu (⋮), then "Add to Home Screen"

Technology Stack

  • Backend: Node.js + Express + Socket.IO
  • Frontend: Vanilla JavaScript (no framework dependencies)
  • Real-time: WebSocket communication via Socket.IO
  • Voice: WebRTC for peer-to-peer voice chat
  • PWA: Service Workers for offline functionality
  • Storage: LocalStorage for persistent account data

Game Version

Current Version: v2.0.1 - Offline Ready

About

This is where I will place the most stable version of the game for playtesting. ONLY IMPORT STABLE, SEMI-TESTED VERSIONS HERE

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published