@nekosuneprojects/gaming-infos 2.1.0

package/README.md

@@ -0,0 +1,206 @@
+# 🌐 @nekosuneprojects/gaming-infos
+
+A simple Node.js module to load **community game data** — Worlds, Groups, Players, and Characters — for multiple games.
+Started as VRChat-only (`vrchat-infos`), now built to grow across games. Currently covers **VRChat**,
+**Genshin Impact**, **Neverness to Everness (NTE)**, and **Honkai: Star Rail** — with more to come.
+
+Data is fetched **live from the NekoSuneVR V5 API** first, so the list of games/entries can be updated in real time
+without needing a new npm release. If the API can't be reached, it falls back to the JSON bundled in this package.
+
+---
+
+## ✨ Features
+
+- 🎮 Multi-game: every lookup is scoped by `game` (`vrchat`, `genshinimpact`, ...)
+- 🌐 API-first with offline fallback — reads from `data/<game>/...` locally when the API is unavailable
+- 🧠 Easy-to-use async API
+- ❤️ Designed with each game's Terms of Service / Community Guidelines in mind
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @nekosuneprojects/gaming-infos
+```
+
+## 💡 Usage
+
+```js
+const gamingInfos = require('@nekosuneprojects/gaming-infos');
+
+(async () => {
+  const games = await gamingInfos.Games();          // every supported game's meta info
+  const game = await gamingInfos.Game('vrchat');
+  const world = await gamingInfos.Worlds('vrchat', 'theblackcat');
+  const group = await gamingInfos.Groups('vrchat', 'nekosunecommunity');
+  const player = await gamingInfos.Players('vrchat', 'nekosunevr');
+  const allCharacters = await gamingInfos.List('genshinimpact', 'characters'); // every character for a game
+
+  console.log(games, game, world, group, player, allCharacters.length);
+})();
+```
+
+This reads (or falls back to reading) data from:
+
+```
+data/
+└── <game>/
+    ├── meta.json
+    ├── worlds/<name>.json
+    ├── groups/<name>.json
+    ├── players/<name>.json
+    └── characters/<name>.json   (for character-driven games, e.g. Genshin Impact)
+```
+
+### API functions
+
+| Function | Description |
+|---|---|
+| `Games()` | Every supported game's meta info, in one array |
+| `Game(game)` | Game-level info, e.g. `data/vrchat/meta.json` |
+| `Worlds(game, name)` | A world entry |
+| `Groups(game, name)` | A group entry |
+| `Players(game, name)` | A player entry |
+| `Characters(game, name)` | A character entry (games like Genshin Impact) |
+| `Get(game, type, name)` | Generic escape hatch for any other entity type a future game needs |
+| `List(game, type)` | Every entry of a type for a game, e.g. `List('genshinimpact', 'characters')` |
+
+An entry with no verified working image simply has `"image": ""` — check for a blank string, not a placeholder value, before using it.
+
+### Configuration (env vars)
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `GAMING_INFOS_API_BASE` | `https://api.nekosunevr.co.uk` | Base URL of the NekoSuneVR V5 API |
+| `GAMING_INFOS_API_PATH` | `/v5/games/api/gaming-infos` | Path prefix for the gaming-infos endpoint |
+| `GAMING_INFOS_DISABLE_API` | unset | Set to `1`/`true` to force local-only lookups (no network calls) |
+| `GAMING_INFOS_TIMEOUT_MS` | `4000` | API request timeout before falling back to local JSON |
+
+## 📘 Example JSON Formats
+
+## 🌍 Worlds (`data/<game>/worlds/worldname.json`)
+
+```json
+{
+  "name": "The Black Cat",
+  "title": "Main Hall",
+  "creator": "spookyghostboo",
+  "aliases": "Black Cat",
+  "image": "https://example.com/images/world.jpg",
+  "description": "A cozy hangout world for friends.",
+  "url": "VRCHAT WORLD URL"
+}
+```
+
+## 👥 Groups (`data/<game>/groups/groupname.json`)
+
+```json
+{
+  "name": "NekoSune Community",
+  "owner": "NekoSuneVR",
+  "image": "https://example.com/images/group.png",
+  "description": "A friendly VRChat group for chill vibes and fun events.",
+  "url": "VRCHAT GROUP URL"
+}
+```
+
+## 🧍 Players (`data/<game>/players/playername.json`)
+
+```json
+{
+    "name": "NekoSuneVR",
+    "title": "The Cutie Streamer",
+    "species": "half human - half catgirl",
+    "gender": "Male",
+    "aliases": "ChisdealHDYT, Chisdeal2013, Chisdeal2014, ChisdealHD, progamer-gr, DarkBlackWolfs",
+    "image": "https://media.discordapp.net/attachments/794229972490387496/794231249652678696/VRChat_1920x1080_2020-09-14_09-22-18.855.png",
+    "description": "A long time ago, Wild Player Chisdeal2013 (later known as ChisdealHDYT). He had been hanging out in a place called [The Black Cat](https://vrchat-legends.fandom.com/wiki/The_Black_Cat), [The Great Pug](https://vrchat-legends.fandom.com/wiki/The_Great_Pug) and [Japan Shrine (ITOAR)](https://vrchat-legends.fandom.com/wiki/Japan_Shrine_(ITOAR)). He had been talking about how he wanted to be Popular on [Twitch](https://twitch.tv/chisdealhdyt) and [TikTok](https://www.tiktok.com/@chisdealhd) / [YouTube](https://www.youtube.com/chisdealhd). Then he did started to streaming on Twitch and Upload Videos on TikTok / YouTube. He loves interest Cryptocurrency Money making and has lot support from [ZENZO Community](https://zenzo.io). He building Community with VRChat, Warframe and many more. He want become as VTuber as Twitch and doing a lot of VR Gaming. That dream is coming very soon in stage getting VR Headset and Brand new VR Ready PC.\n\nYou should Support this Cutie Streamer much on your Heart it can go.",
+    "url": "https://creator.nekosunevr.co.uk"
+}
+```
+
+## 🧝 Characters (`data/<game>/characters/charactername.json`)
+
+For character-driven games like Genshin Impact:
+
+```json
+{
+    "name": "Amber",
+    "quote": "Outrider Amber, at the ready!",
+    "cv": "Iwami Manaka",
+    "description": "A perky, straightforward girl, who is also the only Outrider of the Knights of Favonius.",
+    "image": "https://uploadstatic-sea.mihoyo.com/contentweb/20191009/2019100914372396510.png",
+    "city": "Mondstadt",
+    "url": "https://genshin.mihoyo.com/en/character/mondstadt?char=1",
+    "element": "Pyro",
+    "weapon": "Bow",
+    "rating": 4
+}
+```
+
+`element` is a plain string (Pyro/Hydro/Electro/Cryo/Anemo/Geo/Dendro) — icon mapping is left to
+whatever app consumes this data. `rating` is the in-game star rarity (1-5) as a number. Fields
+like `cv` (voice actor) or `city` only apply to some games — include whatever's relevant, drop what isn't.
+
+## 🤝 Pull Requests (PRs)
+
+We welcome contributions, but please follow these important rules carefully — see [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
+
+✅ Permission & Source Rules
+
+- Only include data that is publicly available or that you have permission to include.
+- If the data is not public (e.g., from private profiles, Discords, or DMs), do not include it.
+- If unsure, ask the world/group/player/character owner first.
+- Use only public sources (official game pages/wikis, official listings/profiles).
+
+🚫 Respect & Safety
+
+- No harassment, bullying, or doxxing.
+- Any PR containing harassment, defamation, or private information will be rejected and reported.
+- Respect each game's Terms of Service and Community Guidelines.
+- Do not include private details, logs, or non-public data.
+
+## 🖼️ Image Requirement
+
+Each entry must include a valid image URL in its JSON:
+```json
+"image": "https://example.com/images/item.png"
+```
+
+## 📄 Format Consistency
+
+Follow the exact folder and field structure:
+
+```
+data/
+└── <game>/
+    ├── meta.json
+    ├── worlds/
+    ├── groups/
+    ├── players/
+    └── characters/
+```
+
+Each JSON should match the examples above.
+
+## 🔍 Accuracy
+
+Ensure all data is accurate, current, and permissioned.
+
+## ⚠️ Disclaimer
+
+This project is not affiliated with or endorsed by VRChat Inc., Genshin Impact/HoYoverse, or any other game covered here.
+All names, logos, and related elements are property of their respective owners.
+Always follow each game's official Terms of Service and Community Guidelines
+(e.g. [VRChat](https://hello.vrchat.com/legal) / [VRChat Community Guidelines](https://hello.vrchat.com/community-guidelines)).
+
+## 🧠 Credits
+
+Maintained by NekoSune Projects
+🐾 Contributions welcome — stay 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)

package/data/genshinimpact/characters/albedo.json

@@ -0,0 +1,11 @@
+{
+    "name": "Albedo",
+    "cv": "Kenji Nojima",
+    "description": "Known as the 'Kreideprinz' (Chalk Prince), Albedo serves as Chief Alchemist and Captain of the Investigation Team of the Knights of Favonius. A synthetic human created by the alchemist Rhinedottir, he prefers quiet research in Dragonspine over Mondstadt's social life.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://wiki.hoyolab.com/pc/genshin/entry/47",
+    "element": "Geo",
+    "weapon": "Sword",
+    "rating": 5
+}

package/data/genshinimpact/characters/alhaitham.json

@@ -0,0 +1,12 @@
+{
+    "name": "Alhaitham",
+    "quote": "Only the best are humble.",
+    "cv": "Umehara Yuichiro",
+    "description": "Scribe of the Sumeru Akademiya and a graduate of the Haravatat Darshan, Alhaitham is a brilliant but famously blunt scholar who wields a sword and shares an apartment with his old classmate Kaveh.",
+    "image": "https://upload.wikimedia.org/wikipedia/en/thumb/2/24/Genshin_Impact_Alhaitham.png/250px-Genshin_Impact_Alhaitham.png",
+    "city": "Sumeru",
+    "url": "https://en.wikipedia.org/wiki/Alhaitham_(Genshin_Impact)",
+    "element": "Dendro",
+    "weapon": "Sword",
+    "rating": 5
+}

package/data/genshinimpact/characters/aloy.json

@@ -0,0 +1,11 @@
+{
+    "name": "Aloy",
+    "cv": "Ayahi Takagaki",
+    "description": "The protagonist of Horizon Zero Dawn, Aloy is an outlander who crossed into Teyvat as part of a collaboration between HoYoverse and Guerrilla Games. A skilled hunter raised by the Nora tribe, she wields a bow infused with Cryo energy and continues her adventures as a wandering heroine.",
+    "image": "https://www.pockettactics.com/wp-content/sites/pockettactics/2023/10/Genshin-Impact-Aloy-550x309.jpg",
+    "city": "Outlander (Horizon Zero Dawn crossover, not native to Teyvat)",
+    "url": "https://www.pockettactics.com/genshin-impact/aloy",
+    "element": "Cryo",
+    "weapon": "Bow",
+    "rating": 5
+}

package/data/genshinimpact/characters/amber.json

@@ -0,0 +1,12 @@
+{
+    "name": "Amber",
+    "quote": "Outrider Amber, at the ready!",
+    "cv": "Iwami Manaka",
+    "description": "A perky, straightforward girl, who is also the only Outrider of the Knights of Favonius.Her amazing mastery of the glider has made her a three-time winner of the Gliding Champion in Mondstadt. As a rising star within the Knights of Favonius, Amber is always ready for any challenging tasks.",
+    "image": "https://uploadstatic-sea.mihoyo.com/contentweb/20191009/2019100914372396510.png",
+    "city": "Mondstadt",
+    "url": "https://genshin.mihoyo.com/en/character/mondstadt?char=1",
+    "element": "Pyro",
+    "weapon": "Bow",
+    "rating": 4
+}

package/data/genshinimpact/characters/aratakiitto.json

@@ -0,0 +1,12 @@
+{
+    "name": "Arataki Itto",
+    "quote": "The first and greatest head of the Arataki Gang, famed throughout Inazuma City's Hanamizaka!",
+    "cv": "Takanori Nishikawa",
+    "description": "Self-proclaimed leader of the Arataki Gang and a descendant of the crimson oni, as loud and proud as he is good-natured. He dreams of proving the Arataki Gang's name across all of Inazuma.",
+    "image": "",
+    "city": "Inazuma",
+    "url": "https://genshin-impact.fandom.com/wiki/Arataki_Itto",
+    "element": "Geo",
+    "weapon": "Claymore",
+    "rating": 5
+}

package/data/genshinimpact/characters/arlecchino.json

@@ -0,0 +1,12 @@
+{
+    "name": "Arlecchino",
+    "quote": "We don't want to make the children cry...",
+    "cv": "Nanako Mori",
+    "description": "Also known as \"The Knave,\" Arlecchino is the fourth of the Fatui Harbingers and head of the House of the Hearth, an orphanage and intelligence agency in Fontaine where the children call her \"Father.\" Ruthless in her duties yet devoted to those in her care, she is regarded as one of Teyvat's most formidable and morally complex figures.",
+    "image": "https://upload.wikimedia.org/wikipedia/en/f/fa/Genshin_Impact_Arlecchino.png",
+    "city": "Fontaine",
+    "url": "https://en.wikipedia.org/wiki/Arlecchino_(Genshin_Impact)",
+    "element": "Pyro",
+    "weapon": "Polearm",
+    "rating": 5
+}

package/data/genshinimpact/characters/baizhu.json

@@ -0,0 +1,12 @@
+{
+    "name": "Baizhu",
+    "quote": "Living with many maladies, where will one find a cure?",
+    "cv": "Yusa Kouji",
+    "description": "A well-known physician and owner of Bubu Pharmacy in Liyue Harbor, trusted to cure any disease. He is accompanied everywhere by his pet snake, Changsheng, and secretly bears a curse that shortens his own lifespan the longer he lives.",
+    "image": "https://upload.wikimedia.org/wikipedia/en/f/f1/Genshin_Impact_Baizhu_and_Changsheng.png",
+    "city": "Liyue",
+    "url": "https://en.wikipedia.org/wiki/Baizhu_(Genshin_Impact)",
+    "element": "Dendro",
+    "weapon": "Catalyst",
+    "rating": 5
+}

package/data/genshinimpact/characters/barbara.json

@@ -0,0 +1,11 @@
+{
+    "name": "Barbara",
+    "cv": "Akari Kito",
+    "description": "The Deaconess of the Church of Favonius and a beloved idol of Mondstadt, Barbara is a cheerful Hydro healer whose stage performances lift the spirits of the city, all while she remains genuinely devoted to helping and healing anyone in need.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://genshin-impact.fandom.com/wiki/Barbara",
+    "element": "Hydro",
+    "weapon": "Catalyst",
+    "rating": 4
+}

package/data/genshinimpact/characters/beidou.json

@@ -0,0 +1,12 @@
+{
+    "name": "Beidou",
+    "quote": "Remember this day, you almost won money from the Captain of the Crux.",
+    "cv": "Ami Koshimizu",
+    "description": "Captain of the mercenary crew known as the Crux, renowned throughout Liyue as the Uncrowned Lord of the Ocean for her strength and daring exploits at sea.",
+    "image": "",
+    "city": "Liyue",
+    "url": "https://genshin-impact.fandom.com/wiki/Beidou",
+    "element": "Electro",
+    "weapon": "Claymore",
+    "rating": 4
+}

package/data/genshinimpact/characters/bennett.json

@@ -0,0 +1,11 @@
+{
+    "name": "Bennett",
+    "cv": "Ryota Osaka",
+    "description": "A relentlessly optimistic young adventurer of Mondstadt's Adventurers' Guild whose extraordinarily bad luck has never dampened his passion for helping others and searching for treasure.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://wiki.hoyolab.com/pc/genshin/entry/26",
+    "element": "Pyro",
+    "weapon": "Sword",
+    "rating": 4
+}

package/data/genshinimpact/characters/candace.json

@@ -0,0 +1,12 @@
+{
+    "name": "Candace",
+    "quote": "The oath of the guardians is more stalwart yet than the shields they inherit.",
+    "cv": "Yuzuki Ryoka",
+    "description": "A guardian of Aaru Village in Sumeru's desert, Candace protects the descendants of an ancient civilization from monsters and looters, wielding a polearm infused with Hydro.",
+    "image": "https://static.icy-veins.com/images/genshin-impact/characters/candace.webp",
+    "city": "Sumeru",
+    "url": "https://www.icy-veins.com/genshin-impact/candace-profile-talents-constellations",
+    "element": "Hydro",
+    "weapon": "Polearm",
+    "rating": 4
+}

package/data/genshinimpact/characters/charlotte.json

@@ -0,0 +1,11 @@
+{
+    "name": "Charlotte",
+    "cv": "Waki Azumi",
+    "description": "An enthusiastic reporter for Fontaine's newspaper The Steambird, always on the hunt for an exclusive scoop. She first appeared as a non-playable character in version 3.7 before becoming playable in version 4.2.",
+    "image": "https://img.gamewith.net/article/thumbnail/rectangle/40688.png",
+    "city": "Fontaine",
+    "url": "https://gamewith.net/genshin-impact/article/show/40688",
+    "element": "Cryo",
+    "weapon": "Catalyst",
+    "rating": 4
+}

package/data/genshinimpact/characters/chasca.json

@@ -0,0 +1,11 @@
+{
+    "name": "Chasca",
+    "cv": "Yūko Kaida",
+    "description": "A well-known peacekeeper from the Flower-Feather Clan, one of the six tribes of Natlan, serving as an aerial scout and marksman known as the Skyborne Arbiter.",
+    "image": "",
+    "city": "Natlan",
+    "url": "https://genshin-impact.fandom.com/wiki/Chasca",
+    "element": "Anemo",
+    "weapon": "Bow",
+    "rating": 5
+}

package/data/genshinimpact/characters/chevreuse.json

@@ -0,0 +1,11 @@
+{
+    "name": "Chevreuse",
+    "cv": "Shimoji Shino",
+    "description": "A musketeer and the hardworking captain of the Special Security and Surveillance Patrol, a law enforcement branch of the Maison Gardiennage in Fontaine, known for her unorthodox but firm sense of justice.",
+    "image": "",
+    "city": "Fontaine",
+    "url": "https://gamewith.net/genshin-impact/article/show/41820",
+    "element": "Pyro",
+    "weapon": "Polearm",
+    "rating": 4
+}

package/data/genshinimpact/characters/chiori.json

@@ -0,0 +1,11 @@
+{
+    "name": "Chiori",
+    "cv": "Ayana Taketatsu",
+    "description": "An independent fashion designer originally from Inazuma who now runs the Chioriya boutique in Fontaine's Romaritime Harbor. Frank, headstrong, and fiercely proud of her craft, she aims to make her label recognized across all of Teyvat.",
+    "image": "",
+    "city": "Fontaine",
+    "url": "https://genshin-impact.fandom.com/wiki/Chiori",
+    "element": "Geo",
+    "weapon": "Sword",
+    "rating": 5
+}

package/data/genshinimpact/characters/chongyun.json

@@ -0,0 +1,12 @@
+{
+    "name": "Chongyun",
+    "quote": "We shouldn't focus only on the gains and losses of our journey. The things you see and the events you encounter along the way are equally important rewards.",
+    "cv": "Soma Saito",
+    "description": "A boy born with a naturally pure yang constitution that repels evil spirits but makes him prone to overheating, so he trains constantly to master his own excess energy despite wielding a Cryo Vision.",
+    "image": "",
+    "city": "Liyue",
+    "url": "https://genshin-impact.fandom.com/wiki/Chongyun",
+    "element": "Cryo",
+    "weapon": "Claymore",
+    "rating": 4
+}

package/data/genshinimpact/characters/citlali.json

@@ -0,0 +1,11 @@
+{
+    "name": "Citlali",
+    "cv": "Asami Tano",
+    "description": "The high priestess of the Masters of the Night-Wind and the adoptive grandmother of Ororon, who lives in seclusion from the rest of her tribe.",
+    "image": "",
+    "city": "Natlan",
+    "url": "https://genshin-impact.fandom.com/wiki/Citlali",
+    "element": "Cryo",
+    "weapon": "Catalyst",
+    "rating": 5
+}

package/data/genshinimpact/characters/clorinde.json

@@ -0,0 +1,11 @@
+{
+    "name": "Clorinde",
+    "cv": "Ishikawa Yui",
+    "description": "An undefeated Champion Duelist in Fontaine who once served as Furina's personal bodyguard.",
+    "image": "https://img.gamewith.net/article/thumbnail/rectangle/40682.png",
+    "city": "Fontaine",
+    "url": "https://gamewith.net/genshin-impact/article/show/40682",
+    "element": "Electro",
+    "weapon": "Sword",
+    "rating": 5
+}

package/data/genshinimpact/characters/collei.json

@@ -0,0 +1,12 @@
+{
+    "name": "Collei",
+    "quote": "Trainee Forest Ranger Collei, reporting for duty! I will ensure your safe passage through this forest.",
+    "cv": "Maekawa Ryoko",
+    "description": "A trainee Forest Ranger active in Sumeru's Avidya Forest, Collei fights with a Dendro-infused bow and was once used as a test subject in one of the Akademiya's experiments.",
+    "image": "https://static.icy-veins.com/images/genshin-impact/characters/collei.webp",
+    "city": "Sumeru",
+    "url": "https://www.gamepur.com/guides/who-is-the-voice-actor-for-collei-in-genshin-impact",
+    "element": "Dendro",
+    "weapon": "Bow",
+    "rating": 4
+}

package/data/genshinimpact/characters/cyno.json

@@ -0,0 +1,12 @@
+{
+    "name": "Cyno",
+    "quote": "Good deeds and bad... In the end, all will be placed upon the scales.",
+    "cv": "Irino Miyu",
+    "description": "General Mahamatra and leader of the Matra, the Akademiya's disciplinary force, Cyno is also a graduate of the Spantamad Darshan who occasionally moonlights as a fortune-teller, fighting with an Electro-infused polearm.",
+    "image": "https://static.icy-veins.com/images/genshin-impact/characters/cyno.webp",
+    "city": "Sumeru",
+    "url": "https://www.icy-veins.com/genshin-impact/cyno-guide-best-builds",
+    "element": "Electro",
+    "weapon": "Polearm",
+    "rating": 5
+}

package/data/genshinimpact/characters/dahlia.json

@@ -0,0 +1,10 @@
+{
+    "name": "Dahlia",
+    "description": "Herald of Barbatos and a high-ranking member of the Church of Favonius, Dahlia carries himself with a carefree, drink-loving demeanor. He was introduced as a boosted 4-star Hydro sword character in Version 5.7, released alongside the Skirk and Emilie banner.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://gamerant.com/genshin-impact-dahlia-release-date/",
+    "element": "Hydro",
+    "weapon": "Sword",
+    "rating": 4
+}

package/data/genshinimpact/characters/dehya.json

@@ -0,0 +1,11 @@
+{
+    "name": "Dehya",
+    "cv": "Fukuhara Ayaka",
+    "description": "A mercenary of the Eremites nicknamed \"Flame-Mane,\" Dehya hails from the Great Red Sand desert region of Sumeru and works as a bodyguard, wielding fire and a claymore to protect those in need.",
+    "image": "https://upload.wikimedia.org/wikipedia/en/2/22/Dehya_%28Genshin_Impact%29.png",
+    "city": "Sumeru",
+    "url": "https://en.wikipedia.org/wiki/Dehya",
+    "element": "Pyro",
+    "weapon": "Claymore",
+    "rating": 5
+}

package/data/genshinimpact/characters/diluc.json

@@ -0,0 +1,11 @@
+{
+    "name": "Diluc",
+    "cv": "Kensho Ono",
+    "description": "Owner of the Dawn Winery and a former Knight of Favonius who secretly protects Mondstadt by night as the vigilante known as the Darknight Hero, having grown disillusioned with the Knights after his father's death.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://wiki.hoyolab.com/m/genshin/entry/43?lang=en-us",
+    "element": "Pyro",
+    "weapon": "Claymore",
+    "rating": 5
+}

package/data/genshinimpact/characters/diona.json

@@ -0,0 +1,11 @@
+{
+    "name": "Diona",
+    "cv": "Shiori Izawa",
+    "description": "A feline-blooded bartender at Mondstadt's Cat's Tail tavern who paradoxically despises alcohol and strives to concoct the world's most delicious non-alcoholic drinks, driven by her disillusionment with her father's drinking.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://wiki.hoyolab.com/pc/genshin/entry/44/",
+    "element": "Cryo",
+    "weapon": "Bow",
+    "rating": 4
+}

package/data/genshinimpact/characters/dori.json

@@ -0,0 +1,11 @@
+{
+    "name": "Dori",
+    "cv": "Kaneda Tomoko",
+    "description": "Known throughout Sumeru City as \"Lord Sangemah Bay,\" Dori is a shrewd young merchant who can procure almost anything for a price, and fights using Electro-charged claymore techniques alongside her own mechanical gadgets.",
+    "image": "https://static.icy-veins.com/images/genshin-impact/characters/dori.webp",
+    "city": "Sumeru",
+    "url": "https://www.icy-veins.com/genshin-impact/dori-guide-best-builds",
+    "element": "Electro",
+    "weapon": "Claymore",
+    "rating": 4
+}

package/data/genshinimpact/characters/durin.json

@@ -0,0 +1,11 @@
+{
+    "name": "Durin",
+    "cv": "Chiaki Kobayashi",
+    "description": "A dragon created within the storybook world of Simulanka by the Hexenzirkel witch Andersdotter, originally cursed to turn everything it touched into building blocks. After being freed from his fate as an 'Evil Dragon' and granted a synthetic human body through Albedo's alchemy, Durin integrated himself into Mondstadt society.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://genshin.hoyoverse.com/en/news/detail/161105",
+    "element": "Pyro",
+    "weapon": "Sword",
+    "rating": 5
+}

package/data/genshinimpact/characters/emilie.json

@@ -0,0 +1,11 @@
+{
+    "name": "Emilie",
+    "cv": "Hikasa Yoko",
+    "description": "A renowned perfumer whose products are highly sought after by Fontaine's fashionistas; she also works quietly in the background as a forensic cleaner.",
+    "image": "https://img.gamewith.net/article/thumbnail/rectangle/41281.png",
+    "city": "Fontaine",
+    "url": "https://gamewith.net/genshin-impact/article/show/41281",
+    "element": "Dendro",
+    "weapon": "Polearm",
+    "rating": 5
+}

package/data/genshinimpact/characters/escoffier.json

@@ -0,0 +1,12 @@
+{
+    "name": "Escoffier",
+    "quote": "I came up with a 'Lily sugar-glazed opera cake,' and Lady Furina actually liked it and said she would remember me.",
+    "cv": "Sato Satomi",
+    "description": "The strict and talented ex-head chef of Hotel Debord, whose precision gastronomy is famed throughout Fontaine and whose exacting standards make her feared by kitchen staff who waste food.",
+    "image": "https://www.destructoid.com/wp-content/uploads/2025/04/escoffier-va-in-genshin-impact.jpg",
+    "city": "Fontaine",
+    "url": "https://www.sportskeeda.com/esports/escoffier-va-genshin-impact-official-japanese-voice-actor-notable-works",
+    "element": "Cryo",
+    "weapon": "Polearm",
+    "rating": 5
+}

package/data/genshinimpact/characters/eula.json

@@ -0,0 +1,11 @@
+{
+    "name": "Eula",
+    "cv": "Rina Sato",
+    "description": "Known as the Spindrift Knight, Eula is a descendant of the disgraced Lawrence Clan who severed ties with her family and now serves as Captain of the Reconnaissance Company within the Knights of Favonius, hunting down threats to Mondstadt out in the wild.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://wiki.hoyolab.com/pc/genshin/entry/6",
+    "element": "Cryo",
+    "weapon": "Claymore",
+    "rating": 5
+}

package/data/genshinimpact/characters/faruzan.json

@@ -0,0 +1,12 @@
+{
+    "name": "Faruzan",
+    "quote": "Before you ask a question, do call me 'Madam.'",
+    "cv": "Horie Yui",
+    "description": "A young but accomplished engineer of the Sumeru Akademiya's Rtawahist Darshan, Faruzan designed wind-catching devices to protect the desert from sandstorms and fights with an Anemo-infused bow.",
+    "image": "https://static.icy-veins.com/images/genshin-impact/characters/faruzan.webp",
+    "city": "Sumeru",
+    "url": "https://www.icy-veins.com/genshin-impact/faruzan-profile-talents-constellations",
+    "element": "Anemo",
+    "weapon": "Bow",
+    "rating": 4
+}

package/data/genshinimpact/characters/fischl.json

@@ -0,0 +1,12 @@
+{
+    "name": "Fischl",
+    "quote": "It is I, Fischl, Prinzessin der Verurteilung!",
+    "cv": "Maaya Uchida",
+    "description": "An investigator for Mondstadt's Adventurers' Guild who speaks in an embellished, prophetic manner as the self-proclaimed 'Prinzessin der Verurteilung' (Princess of Condemnation) of the realm Immernachtreich, accompanied everywhere by her raven companion Oz.",
+    "image": "",
+    "city": "Mondstadt",
+    "url": "https://wiki.hoyolab.com/m/genshin/entry/38?lang=en-us",
+    "element": "Electro",
+    "weapon": "Bow",
+    "rating": 4
+}

package/data/genshinimpact/characters/freminet.json

@@ -0,0 +1,11 @@
+{
+    "name": "Freminet",
+    "cv": "Toki Shunichi",
+    "description": "A shy diver well known in Fontaine for his focus and expertise underwater. He is the adoptive younger brother of Lyney and Lynette.",
+    "image": "https://img.gamewith.net/article/thumbnail/rectangle/40278.png",
+    "city": "Fontaine",
+    "url": "https://gamewith.net/genshin-impact/article/show/40278",
+    "element": "Cryo",
+    "weapon": "Claymore",
+    "rating": 4
+}