README.md

gacha-codes-notifier

Watches for new gacha redemption codes (Genshin Impact, Honkai: Star Rail, Zenless Zone Zero, Honkai Impact 3rd, Wuthering Waves, and Arknights: Endfield) and posts them to Discord webhooks on a schedule. Codes come from community HoYoverse APIs plus an optional self-hosted OpenGachaCodes instance (opengachaBaseUrl) — the sole source for non-HoYo games like Wuthering Waves and Arknights: Endfield. See Sources.

Run

cp config.example.yaml config.yaml    # then add your webhook(s) + messages

docker build -t gacha-codes-notifier .
docker run -d --name gacha-codes-notifier \
  -e TZ=Europe/Amsterdam \
  -v "$PWD/config.yaml:/app/config.yaml:ro" \
  -v "$PWD/data:/app/data" \
  gacha-codes-notifier

Or without Docker: CONFIG_FILE=config.yaml go run .

Configuration lives in config.yaml — see config.example.yaml for the fully-commented template.

Architecture, config reference, and development notes: AGENTS.md.

Sources

Codes are merged from every source that serves a given game and de-duplicated by code (case-insensitive). The first source to report a code wins; a later one only fills in rewards the earlier one left blank. One source failing is tolerated — a game is skipped only when all of its sources fail.

Source	Serves	Notes
hoyoverse-api by @torikushiii	HoYoverse titles	Public API at api.ennead.cc.
hoyo-codes by @seriaati	HoYoverse titles	Public API at hoyo-codes.seria.moe; codes are validated against HoYoLAB before being served.
OpenGachaCodes by @torikushiii	All titles, incl. non-HoYo	Self-hosted, opt-in via opengachaBaseUrl. The only source for Wuthering Waves and Arknights: Endfield.

Credits

This project is a thin notifier — the actual work of finding and validating codes belongs to others:

• hoyoverse-api (AGPL-3.0) and OpenGachaCodes by @torikushiii.
• hoyo-codes (GPL-3.0) by @seriaati, built for Hoyo Buddy.

License

AGPL-3.0 © Alisa Frelia @exec-astraea.