Game Data Structure

Overview

The games.json file contains the core data for all game countdowns. It stores information about version releases, patch notes, visual themes, and timing for each supported game.

File Location

src/data/games.json

Schema

The root object contains a single games array with game objects.

Root Object

games

Game[]

required

Array of game objects containing version countdown data

Game Object

Each game object in the games array has the following structure:

Show Core Fields

slug

string

required

Unique identifier for the game (used in URLs)Examples: "genshin-impact", "wuthering-waves", "honkai-star-rail", "zenless-zone-zero"

nombre

string

required

Display name for the game countdown pageExample: "Genshin Impact New Version Countdown"

descripcion

string

Optional SEO description for the game pageExample:

"Zenless Zone Zero 2.7 Countdown for all region like America, Europe, Asia. Zenless Banner Countdown, Patch Notes, and more."

href

string

required

Relative URL path for the game pageExamples: "/genshin", "/wuwa", "/hsr", "/zzz"

Show Version Information

version_actual

string

required

Current version number in semver formatExamples: "6.4", "3.1", "4.0", "2.6"

proxima_version

string

required

Next version number in semver formatExamples: "6.5", "3.2", "4.1", "2.7"

nombre_version_actual

string

required

First part of the version name/titleExample: "Homeward, He Who", "For You Who"

slogan_name

string

required

Second part of the version name/titleExample: "Caught the Wind", "Walk in Snow"

slogan_desc

string

required

Short description or tagline for the versionExample: "Varka is finally here", "Get ready for new region Lahai-Roi."

Show Timing Fields

fecha_inicio

string

required

ISO 8601 timestamp for version start date (in UTC)Format: "YYYY-MM-DDTHH:mm:ssZ"Example: "2026-02-24T01:30:00Z"

duracion_dias

number

required

Duration of the version in daysRange: Typically between 41-46 daysExample: 42

Show Visual & Content

tema

string

required

Hex color code for the game’s theme colorFormat: "#RRGGBB"Examples:

"#4ade80" (Genshin - green)
"#818cf8" (Wuthering Waves - indigo)
"#22d3ee" (Star Rail - cyan)
"#facc15" (ZZZ - yellow)

imagen

string

required

Full URL to the version’s banner/hero imageExample: "https://fastcdn.hoyoverse.com/content-v2/plat/162828/c50d8c6e2597e9f88a66e06c3c32c5c5_5184430120368326656.jpg"

patch_notes

string

required

Full URL to official patch notesExample: "https://genshin.hoyoverse.com/es/news/detail/162806"

banner_phase_I

string

Optional text describing Phase I banner characters/contentExample: "Columbina and Ineffa"

Complete Example

{
  "slug": "genshin-impact",
  "nombre": "Genshin Impact New Version Countdown",
  "version_actual": "6.4",
  "proxima_version": "6.5",
  "nombre_version_actual": "Homeward, He Who",
  "slogan_name": "Caught the Wind",
  "slogan_desc": "Varka is finally here",
  "fecha_inicio": "2026-02-24T01:30:00Z",
  "duracion_dias": 42,
  "banner_phase_I": "Columbina and Ineffa",
  "tema": "#4ade80",
  "imagen": "https://fastcdn.hoyoverse.com/content-v2/plat/162828/c50d8c6e2597e9f88a66e06c3c32c5c5_5184430120368326656.jpg",
  "patch_notes": "https://genshin.hoyoverse.com/es/news/detail/162806",
  "href": "/genshin"
}

Usage in Components

The game data is imported and used throughout the application:

import gamesData from "@/data/games.json";

const games = gamesData.games;

In GameCard Component

<GameCard
  title={game.nombre}
  current={game.version_actual}
  upcoming={game.proxima_version}
  imagen={game.imagen}
  fecha_inicio={game.fecha_inicio}
  duracion_dias={game.duracion_dias}
  tema={game.tema}
  href={game.href}
/>

Version Number Format

Version numbers follow a major.minor format:

Major version: Significant game updates
Minor version: Regular patch cycles (0-8)

When minor version reaches 8, it cycles to the next major version (e.g., 3.8 → 4.0). See the avanzarVersion() utility in src/utils/change-version.ts for version increment logic.

Data Structures

Utilities

Overview

File Location

Schema

Root Object

Game Object

Complete Example

Usage in Components

In GameCard Component

Version Number Format

Build docs developers (and LLMs) love

Data Structures

Utilities

​Overview

​File Location

​Schema

​Root Object

​Game Object

​Complete Example

​Usage in Components

​In GameCard Component

​Version Number Format

Build docs developers (and LLMs) love

Overview

File Location

Schema

Root Object

Game Object

Complete Example

Usage in Components

In GameCard Component

Version Number Format