mirror of
https://github.com/tiennm99/tiennm99bot.git
synced 2026-10-15 08:17:21 +00:00
tiennm99
d2f09ecb33
The beta wish renders an 8-second astrology-themed night sky in toon shading through a perspective action camera: it dollies toward a hero cloud, a comet lights the cloud's rim from behind and bursts through it, the camera chases the comet as its flare builds to a starburst, and the label appears with an S, SS, or SSS rank. It shares the /api/gacha request contract and render slots.
168 lines
4.5 KiB
Markdown
168 lines
4.5 KiB
Markdown
# wheelofnames
|
|
|
|
Self-hosted API that renders wheel-of-names GIF animations and gacha wish
|
|
MP4 animations with Remotion.
|
|
|
|
## API
|
|
|
|
```http
|
|
POST /api/gif
|
|
Content-Type: application/json
|
|
Accept: image/gif
|
|
Authorization: Bearer change-me
|
|
```
|
|
|
|
```json
|
|
{
|
|
"options": ["alice", "bob", "carol"],
|
|
"winnerIndex": 1,
|
|
"durationMs": 6500,
|
|
"holdMs": 1200,
|
|
"fps": 15,
|
|
"size": 512,
|
|
"theme": "classic"
|
|
}
|
|
```
|
|
|
|
Response is `image/gif` with winner metadata headers:
|
|
|
|
- `X-Wheel-Winner-Index`
|
|
- `X-Wheel-Winner`
|
|
- `X-Render-Duration-Ms`
|
|
|
|
`X-Wheel-Winner` is URL-encoded so non-ASCII labels are safe in HTTP headers.
|
|
|
|
### Gacha wish
|
|
|
|
```http
|
|
POST /api/gacha
|
|
Content-Type: application/json
|
|
Accept: video/mp4
|
|
Authorization: Bearer change-me
|
|
```
|
|
|
|
```json
|
|
{
|
|
"label": "Pizza",
|
|
"rarity": 5,
|
|
"fps": 24,
|
|
"width": 640
|
|
}
|
|
```
|
|
|
|
Renders a 7-second wish animation in the style of a gacha game: a meteor
|
|
coloured by rarity (blue 3★, purple 4★, gold 5★) flies in from the left across
|
|
a night sky and bursts in a white flash where the rank emblem appears, and the label is revealed beside a rank emblem (`B`,
|
|
`A`, `S`) with its stars popping in. Each tier is louder than the one below:
|
|
4★ adds a bigger meteor, a lens flare, impact shake, and a double shockwave;
|
|
5★ adds a rainbow sunburst before landing, a gold sky flood, a starburst, counter
|
|
rotating rays, falling sparkles, and a sheen across the emblem. The per-tier
|
|
table lives in `src/remotion/gacha-timeline.js`.
|
|
`rarity` is required; `fps` is `24` or `30`; `width` is `640` (360 tall) or
|
|
`854` (480 tall). Optional `seed` (integer, `0` to `2147483647`) lays out the
|
|
twinkling stars and particles; when omitted the service picks a random one, so
|
|
every roll draws a different sky. The caller chooses the result and its rarity — the service
|
|
only draws it.
|
|
|
|
### Gacha wish beta
|
|
|
|
`POST /api/gachabeta` takes the same body and returns the same response as
|
|
`/api/gacha`, rendering an 8-second beta style instead: a cosmic, astrology
|
|
themed night sky in toon shading (flat colour bands, no outlines) seen through
|
|
a perspective action camera. The camera dollies toward a hero cloud, a comet
|
|
lights its rim from behind and bursts through it, the camera chases the comet
|
|
as its flare builds, and after the burst the label appears with a rank
|
|
(`S`, `SS`, `SSS` for rarity 3, 4, 5).
|
|
|
|
Response is a silent H.264 `video/mp4` (Telegram plays it as an animation)
|
|
with `X-Gacha-Rarity` and `X-Render-Duration-Ms` headers. Both routes share the
|
|
`MAX_CONCURRENT_RENDERS` slots. All visuals are drawn procedurally; no game
|
|
assets are used.
|
|
|
|
## Local
|
|
|
|
Install dependencies and Chromium once:
|
|
|
|
```sh
|
|
npm install
|
|
npm run browser:ensure
|
|
```
|
|
|
|
Start the local API:
|
|
|
|
```sh
|
|
npm run dev
|
|
```
|
|
|
|
### Generate GIF files locally
|
|
|
|
Generate the quick smoke fixtures at the git-ignored paths
|
|
`fixtures/smoke.gif` and `fixtures/gacha-5-star.mp4`:
|
|
|
|
```sh
|
|
npm run render:smoke
|
|
```
|
|
|
|
Generate the complete fixture set at `fixtures/smoke.gif`,
|
|
`fixtures/vietnamese.gif`, `fixtures/sixteen-options.gif`, and
|
|
`fixtures/gacha-{3,4,5}-star.mp4`:
|
|
|
|
```sh
|
|
npm run render:fixtures
|
|
```
|
|
|
|
Render a custom GIF directly without starting the API server:
|
|
|
|
```powershell
|
|
npm run render:local -- `
|
|
--output wheel.gif `
|
|
--option "Chiều nay uống CraneTea" `
|
|
--option "Chiều nay uống CraneTea" `
|
|
--option "Cà phê" `
|
|
--winner 1
|
|
```
|
|
|
|
macOS, Linux, or Git Bash:
|
|
|
|
```sh
|
|
npm run render:local -- \
|
|
--output wheel.gif \
|
|
--option "Chiều nay uống CraneTea" \
|
|
--option "Chiều nay uống CraneTea" \
|
|
--option "Cà phê" \
|
|
--winner 1
|
|
```
|
|
|
|
`--winner` is a zero-based index and is random when omitted. Run
|
|
`npm run render:local -- --help` for duration, hold, FPS, size, theme, and timeout
|
|
options. The documented root `wheel.gif` and `fixtures/*.gif`/`*.mp4` outputs are
|
|
git-ignored and safe to delete; custom output paths may need their own ignore
|
|
rule.
|
|
|
|
### Verify
|
|
|
|
Run the API smoke test and quality gates:
|
|
|
|
```sh
|
|
npm run api:smoke
|
|
npm run lint
|
|
npm run typecheck
|
|
npm test
|
|
```
|
|
|
|
## Deploy
|
|
|
|
Use a container runtime first. Static-only platforms cannot satisfy
|
|
`POST /api/gif` because Remotion server rendering needs Node, Chromium/runtime
|
|
dependencies, and FFmpeg/compositor support.
|
|
|
|
```sh
|
|
docker build -t wheelofnames .
|
|
docker run --rm -p 3000:3000 -e API_TOKEN=change-me wheelofnames
|
|
```
|
|
|
|
Recommended starting resources: 1-2 vCPU and 1-2 GB RAM, with
|
|
`MAX_CONCURRENT_RENDERS=1`. `RENDER_TIMEOUT_MS` defaults to `15000` and is
|
|
raised to Remotion's `7000ms` browser timeout floor when configured lower.
|
|
`API_TOKEN` is required when `NODE_ENV=production`.
|