Mod Grid Sizing Per Star

Each ship hull’s mod backpack grid expands as the hull’s star rating increases. Stars only unlock grid space for installed mods — per-star stats are not scaled.

Per-star dimensions

StarCols × RowsTotal cells
★13 × 39
★24 × 312
★34 × 416
★45 × 420
★55 × 525

Source of truth

Defined in GRID_DIMS_BY_STAR at src/starship-survivors/data/ship-progression.ts. Index 0 is unused; valid stars are 1–5.

The gridForStar(star) helper returns the [cols, rows] tuple for a given star and throws on out-of-range stars (anything outside 1–5). No silent fallback — callers must pass a valid star.

Consumers

  • modGridService — uses the per-star dims to allocate / resize the active grid when a hull levels up.
  • modGridStore — persists the current grid shape per hull, keyed off the hull’s current star.
  • XP-to-star curve: STAR_XP_THRESHOLDS (same file) — ★1 at 0 XP, ★5 at 17 cumulative dupes.
  • starFromXp(xp) and xpToNextStar(xp) map XP to current star and remaining XP.