Files
hikari 79c4b99e8a
Security Scan and Upload / Security & DefectDojo Upload (push) Failing after 11s
CI / Lint, Build & Test (push) Successful in 1m2s
feat: add essence infusion upgrades as late-prestige essence sink (#77)
## Summary

Closes #62

Adds five **Essence Infusion** upgrades (I–V) to give essence an ongoing meaningful use deep into a prestige run, when gold upgrades are all purchased and essence reserves are in the trillions with nowhere to go:

| Upgrade | Cost | Multiplier |
|---|---|---|
| Essence Infusion I | 1T essence | ×2 global |
| Essence Infusion II | 5T essence | ×2 global |
| Essence Infusion III | 25T essence | ×2 global |
| Essence Infusion IV | 100T essence | ×3 global |
| Essence Infusion V | 500T essence | ×5 global |

All five start `unlocked: true` (no prerequisite boss or quest required) and cost zero gold and zero crystals — they are purely essence sinks. Combined, they provide a ×120 global income multiplier for players willing to pour their essence reserves into the guild. The About panel's Upgrades section is also updated to inform players these exist.

CDN art assets will need to be generated for IDs `essence_sink_1` through `essence_sink_5` in the `upgrades` folder.

 This issue was created with help from Hikari~ 🌸

Reviewed-on: #77
Co-authored-by: Hikari <hikari@nhcarrigan.com>
Co-committed-by: Hikari <hikari@nhcarrigan.com>
2026-03-19 15:39:04 -07:00

2.1 KiB

Elysium Project Notes

CI Requirements

Never commit without first confirming the full pipeline passes locally:

  1. pnpm lint — zero errors, zero warnings
  2. pnpm build — all packages build cleanly
  3. pnpm test — all tests pass with 100% coverage on apps/api and packages/types

Art Assets

Game art is generated via the Gemini API (gemini-3-pro-image-preview, ~$0.134/image at 1K resolution) and hosted on the CDN at https://cdn.nhcarrigan.com/elysium/.

Process

  1. Generate images with curl to https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key=<API_KEY>, requesting soft-shaded anime style
  2. Save responses to /home/naomi/code/naomi/elysium/img/<category>/<id>.jpg
  3. Upload to R2 with the AWS CLI — credentials are in the global ~/.claude/CLAUDE.md (never commit them here)
  4. Delete the local img/ directory before committing (images live on CDN only)

CDN URL Helper

apps/web/src/utils/cdn.ts exports cdnImage(folder, id)https://cdn.nhcarrigan.com/elysium/<folder>/<id>.jpg

Directory → Category Mapping

Game entity CDN folder
Zones zones
Bosses bosses
Quests quests
Adventurers adventurers
Companions companions
Equipment equipment
Upgrades upgrades
Prestige upgrades prestige-upgrades
Transcendence upgrades transcendence-upgrades
Achievements achievements
Explorations explorations
Materials materials
Recipes recipes
Story chapter banners story-chapters

API Rate Limits

  • 250 images/day per API key — use a second key if quota is hit
  • Free-tier keys cannot use gemini-3-pro-image-preview; key must be on a billing-linked project

About Page

The About page (apps/web/src/components/game/aboutPanel.tsx) contains a How to Play guide that should be kept up to date as new features are added to the game. When implementing new game systems, zones, mechanics, or significant UI features, update the HOW_TO_PLAY array in aboutPanel.tsx to include a description of the new feature.