tiennm99
2bb5108151
The bot now reaches the renderer at http://renderer:3000/api/gif on the compose network instead of a separately deployed service. Both share WHEELOFNAMES_API_TOKEN. CI runs the renderer's lint, typecheck, tests, render smoke, and image build.
5.0 KiB
title, date
| title | date |
|---|---|
| Open-source web gacha projects as a code source for /api/gacha | 2026-10-01 16:56 (Asia/Saigon) |
Open-source web gacha projects as a code source for /api/gacha
Answer
No candidate offers reusable code that would make the gacha wish look more like the
real game. The realistic simulators get their look by playing MP4/WebM clips
recorded from the commercial games. Their code is often MIT-licensed, but the
clips belong to the publisher (HoYoverse, Nexon, and others). Mantan21's README
says so directly: "all assets used for this application belongs to Hoyoverse".
The projects with their own art (original games) have simple pixel or HTML
reveals that are weaker than the current gacha wish. Copying either kind of code
would give us one of two things: a <video> player that needs copyrighted
footage, or an animation worse than what we already render.
Candidates
Stars, licences, and dates come from the GitHub API on 2026-10-01.
| # | Project | Stars | Stack | Code licence | How the pull animation is made | Reusable for us? |
|---|---|---|---|---|---|---|
| 1 | Mantan21/Genshin-Impact-Wish-Simulator (live) | 293 | Svelte | MIT | Plays game-recorded clips (3star-single.mp4 … 5star-multi.mp4, bg.webm) through _meteor.svelte |
Code yes, footage no |
| 2 | shadorki/genshin-impact-wish-simulator | 734 | JavaScript | None (all rights reserved) | Plays dist/videos/5starwish.mp4 and similar game clips |
No |
| 3 | Mantan21/HSR-Warp-Simulator (live) | 40 | Svelte | MIT | Same author and approach, built on Star Rail game assets; the warp clip source was not checked | Code yes, assets no |
| 4 | jianzhishendi/Genshin-Impact-Wish-Simulator-1 | — | Svelte | Fork of #1 | Same as #1 | Same as #1 |
| 5 | U1805/ba-gacha | 18 | Vue | MIT | VideoView.vue plays Blue Archive clips per star tier |
Code yes, footage no |
| 6 | dzmuh97/genshin-twitch-wish | 2 | Python | None | Composites game effect.mp4 backgrounds |
No |
| 7 | Eling486/gacha-simulator | 23 | JavaScript | None | Arknights Spine skeletons (.atlas/.skel) extracted from the game |
No |
| 8 | Spelljinxer/nikke-gacha-sim | 9 | HTML | None | Game images, no video | No |
| 9 | Catgenova/browsergacha | 0 | Vanilla JS + canvas | None | Original pixel-art summon screen with free UI packs | No licence, and simpler than ours |
| 10 | HauntedBees/Public-Domains | 1 | JavaScript | AGPL-3.0 | Public-domain art, static reveal; last push 2019 | AGPL would apply to our service; little animation to gain |
| 11 | DragonMarquise/GachaGameSimulator | 7 | HTML/CSS/JS | AGPL-3.0 | Basic CSS reveal | AGPL, and simpler than ours |
Tracker and analyser tools (for example biuuu/genshin-wish-export,
lgou2w/HoYo.Gacha, bhaoo/endfield-gacha) came up in the searches but have
no pull animation, so they are excluded.
What the code would actually give us
- Video player and skip handling (#1, #5). We already render to MP4, so there is nothing to gain.
- Pull rates and pity logic (#1). MIT and realistic. It doesn't fit our
contract, though: the bot picks the winner uniformly and the caller sets
rarity. Adopting it would change bot behaviour, not visuals. - Spine or Lottie playback (#7). The technique could work through
@remotion/lottie, but only with original animation files, and none exist in these repositories.
Honest options from here
- Keep procedural rendering and add original painted textures, as recommended in the previous discussion: images generated once with an image model or supplied by you, animated by the current code.
- Commission or author a Lottie or Spine wish animation and play it
through
@remotion/lottie. This gives the highest fidelity without game assets, but someone must make the animation file. - Use the game's recorded clips as #1–#6 do. Not recommended: HoYoverse owns the footage, the README promises no game assets, and the bot is public.
Method
GitHub search (gh search repos, --topic gacha), repository trees and
READMEs read through the GitHub API, plus two web searches. I checked
animation sources by listing video and Spine files in each tree and reading
Mantan21's meteor-loader.js and _meteor.svelte.
Unresolved questions
- Is there a commercial or Creative Commons Lottie wish animation you would accept, if we went with option 2?
- How does the HSR simulator (#3) source its warp clip? I didn't check, because it would not change the recommendation.