@nekosuneprojects/gaming-infos 2.2.0 → 2.4.0

package/README.md

@@ -2,172 +2,186 @@
 
 [![npm version](https://img.shields.io/npm/v/@nekosuneprojects/gaming-infos.svg)](https://www.npmjs.com/package/@nekosuneprojects/gaming-infos)
 
-A Node.js data package for **game information, VRChat community data, characters, redeem codes, and creator codes**.
+A Node.js data package for **multi-game information, Fortnite skins/NPCs/maps, Call of Duty characters/NPCs/maps, VRChat community data, redeem codes, and creator codes**.
 
-The package is **API-first**: it reads from the NekoSuneVR V5 API whenever possible, then automatically falls back to bundled JSON when the API is unavailable. The fallback data in this repository is mirrored from APINODE once per day using an atomic add/change/remove synchronization system.
+The package is **API-first**: it reads from the NekoSuneVR V5 API whenever possible, then automatically falls back to bundled JSON when the API is unavailable. The fallback repository checks APINODE every hour and only commits real add/change/remove data updates.
 
-Current package version: **2.2.0**
+Current package source version: **2.4.0**
 
----
+> Published npm releases are immutable. The GitHub source can be ahead of the version currently available from the npm registry until a new package release is published.
 
-## ✨ What it provides
+## Installation
 
-- 🎮 Multi-game metadata and character data
-- 🌐 Live NekoSuneVR V5 API lookups
-- 💾 Automatic local JSON fallback when the API is unavailable
-- 🔄 Daily APINODE → repository cache synchronization
-- 🧹 Add/change/remove mirroring so deleted API entries disappear from the next successful fallback snapshot
-- 🛡️ Last-good-cache protection if APINODE is down or a sync only partially succeeds
-- 👤 VRChat players
-- 👥 VRChat groups
-- 🌍 VRChat worlds
-- 🧍 VRChat avatars
-- 🧝 Character/roster datasets for supported games
-- 🎁 Redeem-code and creator-code helpers
-- 📊 Game-code directory, counts, aliases, status, and source-cache information
-- 🧪 Offline smoke tests for cache replacement and failure recovery
+```bash
+npm install @nekosuneprojects/gaming-infos
+```
 
----
+Requires Node.js 18+.
 
-## 🎮 Gaming Infos coverage
+## Gaming Infos coverage
 
-| Game | Slug | Data |
+| Game / franchise | Slug | Datasets |
 |---|---|---|
-| VRChat | `vrchat` | players, groups, worlds, avatars |
-| Genshin Impact | `genshinimpact` | characters |
-| Honkai: Star Rail | `honkaistarrail` | characters |
-| Neverness to Everness | `nte` | characters |
-| Wuthering Waves | `wutheringwaves` | Resonators under `characters` |
-| Warframe | `warframe` | Warframes under `characters` |
-| Fortnite | `fortnite` | current/released Battle Royale characters |
-| Zenless Zone Zero | `zenlesszonezero` | Agents under `characters` |
-| Tower of Fantasy | `toweroffantasy` | Simulacra under `characters` |
-| Arknights: Endfield | `arknightsendfield` | Operators under `characters` |
-
-The Game Codes system is separate and its supported game list is returned dynamically by the APINODE `/codes` directory endpoint.
-
----
+| VRChat | `vrchat` | `players`, `groups`, `worlds`, `avatars` |
+| Genshin Impact | `genshinimpact` | `characters` |
+| Honkai: Star Rail | `honkaistarrail` | `characters` |
+| Neverness to Everness | `nte` | `characters` |
+| Wuthering Waves | `wutheringwaves` | `characters` (Resonators) |
+| Warframe | `warframe` | `characters` (Warframes) |
+| **Fortnite** | `fortnite` | `characters` = released skins/Outfits, `npcs` = Battle Royale NPCs, `maps` = Named Locations/maps |
+| **Call of Duty mainline** | see table below | `characters`, `npcs`, `maps` per title |
+| Zenless Zone Zero | `zenlesszonezero` | `characters` (Agents) |
+| Tower of Fantasy | `toweroffantasy` | `characters` (Simulacra) |
+| Arknights: Endfield | `arknightsendfield` | `characters` (Operators) |
+
+## Call of Duty mainline coverage
+
+Version 2.4.0 adds the mainline PC/console Call of Duty series from the original **Call of Duty (2003)** through **Black Ops 7**, plus **Modern Warfare 4 (2026)** public beta/official announcement data.
+
+| Title | Slug | Year/status |
+|---|---|---:|
+| Call of Duty | `cod2003` | 2003 |
+| Call of Duty 2 | `cod2` | 2005 |
+| Call of Duty 3 | `cod3` | 2006 |
+| Call of Duty 4: Modern Warfare | `cod4modernwarfare` | 2007 |
+| Call of Duty: World at War | `codworldatwar` | 2008 |
+| Call of Duty: Modern Warfare 2 | `codmodernwarfare2` | 2009 |
+| Call of Duty: Black Ops | `codblackops` | 2010 |
+| Call of Duty: Modern Warfare 3 | `codmodernwarfare3` | 2011 |
+| Call of Duty: Black Ops II | `codblackops2` | 2012 |
+| Call of Duty: Ghosts | `codghosts` | 2013 |
+| Call of Duty: Advanced Warfare | `codadvancedwarfare` | 2014 |
+| Call of Duty: Black Ops III | `codblackops3` | 2015 |
+| Call of Duty: Infinite Warfare | `codinfinitewarfare` | 2016 |
+| Call of Duty: WWII | `codwwii` | 2017 |
+| Call of Duty: Black Ops 4 | `codblackops4` | 2018 |
+| Call of Duty: Modern Warfare (2019) | `codmodernwarfare2019` | 2019 |
+| Call of Duty: Black Ops Cold War | `codblackopscoldwar` | 2020 |
+| Call of Duty: Vanguard | `codvanguard` | 2021 |
+| Call of Duty: Modern Warfare II | `codmodernwarfareii2022` | 2022 |
+| Call of Duty: Modern Warfare III | `codmodernwarfareiii2023` | 2023 |
+| Call of Duty: Black Ops 6 | `codblackops6` | 2024 |
+| Call of Duty: Black Ops 7 | `codblackops7` | 2025 |
+| Call of Duty: Modern Warfare 4 | `codmodernwarfare4` | 2026 beta / announced launch |
+
+### Call of Duty dataset rules
+
+Each Call of Duty title uses the same three public datasets:
 
-## 📦 Installation
-
-```bash
-npm install @nekosuneprojects/gaming-infos
+```text
+<cod-slug>/characters → playable/main characters, protagonists, Operators and Specialists
+<cod-slug>/npcs       → other campaign/game character and NPC records
+<cod-slug>/maps       → multiplayer, Zombies, Warzone and other public map/mission records
 ```
 
-Requires **Node.js 18 or newer**.
+Historical released titles are populated from public Call of Duty Wiki game-specific categories. APINODE excludes categories marked cut, unused, cancelled, unreleased, non-canon, prototype/concept, screenshot/image-only, or file-only.
 
----
+`codmodernwarfare4` is handled more strictly while the game is pre-release: only **officially published Activision beta/public announcement information** is accepted. Leaks, datamines, hidden APIs, and unofficial unreleased lists are not imported. Campaign NPCs are not invented; they only appear once publicly identified by an allowed source.
 
-# 🚀 Quick start
+Examples:
 
 ```js
-const gamingInfos = require('@nekosuneprojects/gaming-infos');
+const bo2Characters = await info.List('codblackops2', 'characters');
+const mw2CampaignNpcs = await info.List('codmodernwarfare2', 'npcs');
+const cod4Maps = await info.List('cod4modernwarfare', 'maps');
+const mw4PublicMaps = await info.List('codmodernwarfare4', 'maps');
 
-async function main() {
-  const games = await gamingInfos.Games();
-  const vrchat = await gamingInfos.Game('vrchat');
+const oneCharacter = await info.Characters('codblackops2', 'character-slug');
+const oneNpc = await info.NPCs('codblackops2', 'npc-slug');
+const oneMap = await info.Maps('codblackops2', 'map-slug');
+```
 
-  const worlds = await gamingInfos.List('vrchat', 'worlds');
-  const avatars = await gamingInfos.List('vrchat', 'avatars');
-  const genshinCharacters = await gamingInfos.List('genshinimpact', 'characters');
-  const wuwaCharacters = await gamingInfos.List('wutheringwaves', 'characters');
+## Fortnite dataset rules
 
-  console.log({
-    gameCount: games.length,
-    vrchat,
-    worlds: worlds.length,
-    avatars: avatars.length,
-    genshinCharacters: genshinCharacters.length,
-    wuwaCharacters: wuwaCharacters.length
-  });
-}
+Fortnite is deliberately separated into three API/package datasets:
 
-main();
+```text
+fortnite/characters  → released Outfit cosmetics / skins
+fortnite/npcs        → Battle Royale NPCs / Characters
+fortnite/maps        → Named Locations / map locations
 ```
 
----
-
-# 🧠 Gaming Infos API
-
-## `Games()`
+A map/location should never appear in the skins dataset. APINODE also removes legacy NPC duplicates when a title is confirmed by the Fortnite Named Locations catalog.
 
-Returns every game with bundled/API Gaming Infos metadata.
+## Quick start
 
 ```js
-const games = await gamingInfos.Games();
-```
-
-Live endpoint:
+const info = require('@nekosuneprojects/gaming-infos');
 
-```http
-GET /v5/games/api/gaming-infos
-```
-
-## `Game(game)`
+async function main() {
+  const games = await info.Games();
 
-Returns game-level metadata.
+  const fortniteSkins = await info.List('fortnite', 'characters');
+  const fortniteNpcs = await info.List('fortnite', 'npcs');
+  const fortniteMaps = await info.List('fortnite', 'maps');
 
-```js
-const game = await gamingInfos.Game('warframe');
-```
+  const blackOps2Characters = await info.List('codblackops2', 'characters');
+  const blackOps2Npcs = await info.List('codblackops2', 'npcs');
+  const blackOps2Maps = await info.List('codblackops2', 'maps');
 
-## `List(game, type)`
+  const vrchatWorlds = await info.List('vrchat', 'worlds');
 
-Returns every entity for a game/type.
+  console.log({
+    games: games.length,
+    fortniteSkins: fortniteSkins.length,
+    blackOps2Characters: blackOps2Characters.length,
+    blackOps2Npcs: blackOps2Npcs.length,
+    blackOps2Maps: blackOps2Maps.length,
+    vrchatWorlds: vrchatWorlds.length,
+  });
+}
 
-```js
-const resonators = await gamingInfos.List('wutheringwaves', 'characters');
-const agents = await gamingInfos.List('zenlesszonezero', 'characters');
-const operators = await gamingInfos.List('arknightsendfield', 'characters');
-const vrchatGroups = await gamingInfos.List('vrchat', 'groups');
+main();
 ```
 
-Live endpoint:
+## Gaming Infos API
+
+Live APINODE endpoints:
 
 ```http
+GET /v5/games/api/gaming-infos
 GET /v5/games/api/gaming-infos/:game/:type
+GET /v5/games/api/gaming-infos/:game/:type/:name
 ```
 
-## Single-entity helpers
-
-```js
-await gamingInfos.Worlds('vrchat', 'world-slug');
-await gamingInfos.Groups('vrchat', 'group-slug');
-await gamingInfos.Players('vrchat', 'player-slug');
-await gamingInfos.Avatars('vrchat', 'avatar-slug');
-await gamingInfos.Characters('warframe', 'warframe-slug');
-```
-
-Generic lookup:
+The root endpoint publishes each game's stable `slug` and available `types`. Type-list responses publish stable entity `slug` values for detail lookups.
 
-```js
-await gamingInfos.Get('vrchat', 'worlds', 'world-slug');
-```
-
-Live endpoint:
+Examples:
 
 ```http
-GET /v5/games/api/gaming-infos/:game/:type/:name
+GET /v5/games/api/gaming-infos/codblackops2/characters
+GET /v5/games/api/gaming-infos/codblackops2/npcs
+GET /v5/games/api/gaming-infos/codblackops2/maps
+GET /v5/games/api/gaming-infos/codmodernwarfare4/characters
+GET /v5/games/api/gaming-infos/codmodernwarfare4/maps
 ```
 
-The V5 API returns stable `slug` values for list entries. Use those slugs for detail lookups instead of trying to generate filenames from display names yourself.
+### Main helpers
 
-## `CacheInfo()`
+```js
+await info.Games();
+await info.Game('codblackops2');
 
-Reads information about the last mirrored Gaming Infos fallback snapshot.
+await info.List('codblackops2', 'characters');
+await info.List('codblackops2', 'npcs');
+await info.List('codblackops2', 'maps');
 
-```js
-const cache = await gamingInfos.CacheInfo();
-console.log(cache?.syncedAt, cache?.contentHash);
-```
+await info.Characters('codblackops2', 'character-slug');
+await info.NPCs('codblackops2', 'npc-slug');
+await info.Maps('codblackops2', 'map-slug');
 
----
+await info.Worlds('vrchat', 'world-slug');
+await info.Groups('vrchat', 'group-slug');
+await info.Players('vrchat', 'player-slug');
+await info.Avatars('vrchat', 'avatar-slug');
 
-# 🎁 Game Codes API
+await info.Get('codblackops2', 'maps', 'map-slug');
+await info.CacheInfo();
+```
 
-Version 2.2.0 adds API-first redeem-code and creator-code support using the same fallback model.
+## Game Codes API
 
-APINODE endpoints:
+Game Codes are separate from Gaming Infos and are discovered dynamically from APINODE.
 
 ```http
 GET /v5/games/api/codes
@@ -176,39 +190,19 @@ GET /v5/games/api/codes/:game
 GET /v5/games/api/codes/:game/:code
 ```
 
-`/codes/status` is cache/status data only and does **not** trigger website scraping or a source refresh.
-
-## `Codes()`
-
-Returns the Game Codes directory, including supported games, aliases, metadata, counters, source counts, and endpoint information.
+Package helpers:
 
 ```js
-const directory = await gamingInfos.Codes();
+const directory = await info.Codes();
+const status = await info.CodesStatus();
 
-console.log(directory.games);
-console.log(directory.aliases);
-```
-
-## `CodesStatus()`
-
-Returns the cached source-refresh state.
-
-```js
-const status = await gamingInfos.CodesStatus();
+const codes = await info.GameCodes('fortnite');
+const allCodes = await info.GameCodes('fortnite', { includeUnknown: true });
+const oneCode = await info.GameCode('fortnite', 'SOME-CODE');
+const codeCache = await info.CodeCacheInfo();
 ```
 
-## `GameCodes(game, options)`
-
-Returns code lists using the existing APINODE response shape:
-
-```js
-const fortniteCodes = await gamingInfos.GameCodes('fortnite');
-
-console.log(fortniteCodes.Active);
-console.log(fortniteCodes.Expired);
-```
-
-Default shape:
+Default per-game shape:
 
 ```json
 {
@@ -217,15 +211,7 @@ Default shape:
 }
 ```
 
-Include queued/unknown records:
-
-```js
-const allFortniteCodes = await gamingInfos.GameCodes('fortnite', {
-  includeUnknown: true
-});
-```
-
-Which can return:
+With `includeUnknown: true`:
 
 ```json
 {
@@ -235,189 +221,132 @@ Which can return:
 }
 ```
 
-Filtering is supported:
-
-```js
-const creatorCodes = await gamingInfos.GameCodes('fortnite', {
-  category: 'creator-code',
-  includeUnknown: true
-});
-
-const freeCodes = await gamingInfos.GameCodes('genshin-impact', {
-  claimType: 'free'
-});
-```
-
-Timezone can also be passed through to the live API:
-
-```js
-const codes = await gamingInfos.GameCodes('fortnite', {
-  timezone: 'Europe/London',
-  includeUnknown: true
-});
-```
-
-Cached aliases from the `/codes` directory are resolved during API outages as well, so aliases such as `fn`, `genshin`, `hsr`, or `wuwa` can still map to their canonical cached game dataset.
-
-## `GameCode(game, code, options)`
-
-Looks up one specific code.
-
-```js
-const creator = await gamingInfos.GameCode('fortnite', 'NEKOSUNEVR');
-console.log(creator);
-```
-
-Live endpoint:
-
-```http
-GET /v5/games/api/codes/:game/:code
-```
-
-When APINODE is unavailable, the package searches the locally mirrored Active, Expired, and Unknown code buckets.
-
-## `CodeCacheInfo()`
-
-Returns the local Game Codes cache manifest.
-
-```js
-const codeCache = await gamingInfos.CodeCacheInfo();
-console.log(codeCache?.syncedAt, codeCache?.stats);
-```
-
----
+`GameCodes()` also supports `category`, `claimType`, and `timezone` options.
 
-# 📚 Function reference
+## Function reference
 
 | Function | Purpose |
 |---|---|
 | `Games()` | List Gaming Infos games |
 | `Game(game)` | Get game metadata |
-| `List(game, type)` | List every entry for one game/type |
+| `List(game, type)` | List a complete dataset |
+| `Characters(game, name)` | Get one character/skin/Operator/roster entity |
+| `NPCs(game, name)` | Get one NPC |
+| `Maps(game, name)` | Get one map/location |
 | `Worlds(game, name)` | Get one world |
 | `Groups(game, name)` | Get one group |
 | `Players(game, name)` | Get one player |
 | `Avatars(game, name)` | Get one avatar |
-| `Characters(game, name)` | Get one character/Warframe/Agent/etc. |
-| `Get(game, type, name)` | Generic entity lookup |
+| `Get(game, type, name)` | Generic Gaming Infos detail lookup |
 | `CacheInfo()` | Gaming Infos fallback manifest |
 | `Codes()` | Game Codes directory |
-| `CodesStatus()` | Cached Game Codes source status |
+| `CodesStatus()` | Game Codes source/sync status |
 | `GameCodes(game, options)` | Active/Expired/Unknown code lists |
-| `GameCode(game, code, options)` | One specific redeem/creator code |
+| `GameCode(game, code, options)` | One redeem/creator code |
 | `CodeCacheInfo()` | Game Codes fallback manifest |
 
----
-
-# 💾 API-first fallback behavior
-
-Normal reads follow this path:
+## API-first fallback behavior
 
 ```text
-Application
-   │
-   ▼
-NekoSuneVR V5 API
-   │
-   ├── available ──► return live data
-   │
-   └── unavailable
-          │
-          ▼
+application
+   ↓
+live APINODE
+   ├─ success → use current live data
+   └─ unavailable/error
+          ↓
      bundled data/
-          │
-          ▼
-     return last-good fallback
+          ↓
+     last-good fallback
 ```
 
-The package does not need an API key for the public read endpoints documented above.
-
 Set this to force local-only reads:
 
 ```bash
 GAMING_INFOS_DISABLE_API=1
 ```
 
----
+Useful runtime variables:
 
-# 🔄 Daily fallback synchronization
+| Variable | Default |
+|---|---|
+| `GAMING_INFOS_API_BASE` | `https://api.nekosunevr.co.uk` |
+| `GAMING_INFOS_API_PATH` | `/v5/games/api/gaming-infos` |
+| `GAME_CODES_API_PATH` | `/v5/games/api/codes` |
+| `GAMING_INFOS_TIMEOUT_MS` | `4000` |
 
-The repository automatically runs the cache mirror **once every day at 03:23 UTC** through GitHub Actions.
+## Hourly fallback mirror
 
-The combined command is:
+The GitHub Action checks APINODE **every hour at minute 23**.
 
 ```bash
 npm run sync:cache
 ```
 
-That performs both:
+This mirrors both:
 
 ```bash
 npm run sync:gaming-infos-cache
 npm run sync:game-codes-cache
 ```
 
-The synchronization process is designed to be authoritative and failure-safe:
+Gaming Infos now **auto-discovers games and dataset types** from the APINODE root response. The built-in manifest remains a compatibility/safety baseline for older APINODE deployments, but when the API reports:
 
-1. Download the complete configured API snapshot into a temporary directory.
-2. Validate all required responses.
-3. Calculate content hashes and add/change/remove statistics.
-4. Replace the old fallback only after the new snapshot succeeds completely.
-5. Keep the previous fallback untouched if the API fails, times out, returns an error, or produces an incomplete snapshot.
-6. Commit actual fallback changes back to the repository.
+```json
+{
+  "slug": "codblackops2",
+  "types": ["characters", "npcs", "maps"]
+}
+```
 
-Successful syncs mirror **additions, modifications, and removals**. If APINODE removes an entry, that entry is removed from the fallback during the next successful mirror.
+the mirror automatically includes all three datasets. This is how all Call of Duty titles are picked up without hard-coding 23 package mirror entries, and it also makes future public game/type additions easier to propagate.
 
-Gaming Infos and Game Codes use independent atomic caches so a failure in one dataset cannot destroy the last-good snapshot of the other.
+The mirror is atomic and last-good-safe:
 
-See [CACHE_SYNC.md](CACHE_SYNC.md) for the detailed cache architecture.
+1. Download the root Gaming Infos directory and merge its `slug`/`types` declarations into the effective mirror manifest.
+2. Download every game meta + every discovered/configured dataset to a temporary tree.
+3. Validate all required endpoints and entity slugs.
+4. Calculate hashes and add/change/remove statistics.
+5. Replace the old snapshot only after the new one succeeds completely.
+6. Keep the previous snapshot if APINODE is unavailable or any required dataset fails.
+7. Commit only when stable content actually changed.
 
----
+Game-code countdown seconds are not stored as meaningful repository changes; fallback countdowns are recalculated from stable expiry dates when read.
 
-# 🧪 Cache tests
+See [CACHE_SYNC.md](CACHE_SYNC.md) for the detailed mirror design.
 
-Run all cache safety tests:
+## Cache tests
 
 ```bash
 npm run test:all-cache
-```
-
-Or individually:
-
-```bash
 npm run test:cache-sync
 npm run test:game-code-cache
 ```
 
-The tests cover scenarios including:
+Tests cover additions, updates, removals, duplicate/invalid data, dynamic APINODE dataset discovery, partial HTTP failures, and last-good snapshot preservation.
 
-- new entries appearing
-- existing entries changing
-- upstream entries being removed
-- duplicate/invalid data protection
-- partial API failures
-- simulated HTTP 5xx outages
-- preserving the last-good fallback after a failed sync
+## Fallback structure
 
----
-
-# 📁 Fallback data structure
+After APINODE has populated a title and the hourly mirror has completed successfully, the repository structure includes entries like:
 
 ```text
 data/
-├── genshinimpact/
-│   ├── meta.json
-│   └── characters/
-├── honkaistarrail/
-├── nte/
-├── wutheringwaves/
-├── warframe/
 ├── fortnite/
-├── zenlesszonezero/
-├── toweroffantasy/
-├── arknightsendfield/
-├── vrchat/
 │   ├── meta.json
+│   ├── characters/
+│   ├── npcs/
+│   └── maps/
+├── codblackops2/
+│   ├── meta.json
+│   ├── characters/
+│   ├── npcs/
+│   └── maps/
+├── codmodernwarfare4/
+│   ├── meta.json
+│   ├── characters/
+│   ├── npcs/
+│   └── maps/
+├── ...
+├── vrchat/
 │   ├── players/
 │   ├── groups/
 │   ├── worlds/
@@ -428,108 +357,18 @@ data/
     ├── status.json
     ├── .cache-manifest.json
     └── games/
-        └── <game>.json
 ```
 
-An entity with no verified image can use:
+## Data policy
 
-```json
-{
-  "image": ""
-}
-```
-
-Consumers should treat a blank image string as "no verified image available".
-
----
-
-# ⚙️ Environment variables
-
-## Runtime API reads
-
-| Variable | Default | Purpose |
-|---|---|---|
-| `GAMING_INFOS_API_BASE` | `https://api.nekosunevr.co.uk` | NekoSuneVR APINODE base URL |
-| `GAMING_INFOS_API_PATH` | `/v5/games/api/gaming-infos` | Gaming Infos path |
-| `GAME_CODES_API_PATH` | `/v5/games/api/codes` | Game Codes path |
-| `GAMING_INFOS_DISABLE_API` | unset | `1`/`true` forces local-only operation |
-| `GAMING_INFOS_TIMEOUT_MS` | `4000` | Runtime API timeout before fallback |
-
-## Cache mirror
-
-| Variable | Default | Purpose |
-|---|---|---|
-| `GAMING_INFOS_CACHE_TIMEOUT_MS` | `15000` | Gaming Infos sync request timeout |
-| `GAMING_INFOS_CACHE_RETRIES` | `2` | Gaming Infos retry count |
-| `GAMING_INFOS_CACHE_RETRY_DELAY_MS` | `750` | Gaming Infos retry delay |
-| `GAME_CODES_CACHE_TIMEOUT_MS` | `15000` | Game Codes sync request timeout |
-| `GAME_CODES_CACHE_RETRIES` | `2` | Game Codes retry count |
-| `GAME_CODES_CACHE_RETRY_DELAY_MS` | `750` | Game Codes retry delay |
-| `GAME_CODES_CACHE_GAME_DELAY_MS` | small delay | Delay between per-game code snapshots |
-
----
+Only add publicly available released data, or clearly official public beta/announcement information for a currently pre-release title. Do not add private profiles, private messages, authentication data, leaks, unofficial unreleased lists, datamined content, hidden APIs, or client-memory extraction.
 
-# 📝 Example character entry
+## npm fallback note
 
-Different games expose different fields. Consumers should use the fields relevant to that game rather than assuming every title has the same schema.
+Published npm releases are immutable. The GitHub repository fallback can update hourly, but an already-installed npm release keeps the files bundled with that release until upgraded. Normal package reads still use live APINODE first when it is available.
 
-```json
-{
-  "name": "Example Character",
-  "slug": "examplecharacter",
-  "rarity": "5-star",
-  "element": "Electro",
-  "weapon": "Sword",
-  "description": "Public character information.",
-  "image": "https://example.com/character.webp",
-  "url": "https://example.com/source",
-  "source": {
-    "provider": "Public source",
-    "publicDataOnly": true
-  }
-}
-```
+## Disclaimer
 
----
-
-# 🤝 Contributions
-
-Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).
-
-Please follow these rules:
-
-- Only include publicly available data or data you have permission to publish.
-- Do not include private profiles, private Discord messages, DMs, private logs, authentication data, or personal information.
-- Do not add leaks, datamined/unreleased content, hidden APIs, memory-inspection data, or client-extracted private data.
-- Respect each game's Terms of Service and community rules.
-- Keep sources clear and verifiable.
-- Do not submit harassment, defamation, doxxing, or invasive profile information.
-
----
-
-# ⚠️ Package fallback note
-
-GitHub repository cache snapshots update automatically, but published npm packages are immutable.
-
-An already-installed npm release keeps the fallback JSON bundled with that release until you update the package. While APINODE is online, live API reads still provide current data without requiring a package release.
-
----
-
-# ⚠️ Disclaimer
-
-This project is not affiliated with or endorsed by VRChat Inc., HoYoverse, Kuro Games, Digital Extremes, Epic Games, Hotta Studio, Hypergryph/GRYPHLINE, or any other game publisher represented by the data.
-
-Game names, logos, characters, and related trademarks belong to their respective owners.
-
----
-
-# 🧠 Credits
+This project is not affiliated with or endorsed by Activision, Epic Games, VRChat Inc., HoYoverse, Kuro Games, Digital Extremes, Hotta Studio, Hypergryph/GRYPHLINE, or other publishers represented by the data. Game names, logos, characters, and related trademarks belong to their respective owners.
 
 Maintained by **NekoSune Projects**.
-
-Contributions are welcome — keep the data public, accurate, and game-friendly.
-
-<!-- GitAds-Verify: 2XHQSF1IKOWF4FH8P2TRI5GRWIJG2TJP -->
-
-## GitAds Sponsored
-[![Sponsored by GitAds](https://gitads.dev/v1/ad-serve?source=nekosuneprojects/gaming-infos@github)](https://gitads.dev/v1/ad-track?source=nekosuneprojects/gaming-infos@github)