# Monopoly — Spritesheet Guide

Three image files need to be created or extended. All dimensions are exact — the engine reads pixel-perfect frame boundaries.

---

## 1. `assets/images/monopoly-pawns.png`

**Total sheet size:** 320 × 80 px  
**Frame size:** 80 × 80 px  
**Layout:** 4 frames in a single horizontal row  
**Displayed at:** 32 × 32 px on the board (the image is scaled down, so keep art centered and avoid fine detail near the edges)

Each frame is a single player token on a transparent background. The token should be centered in the 80 × 80 cell with roughly 8–10 px of breathing room on all sides so it doesn't clip when scaled.

| Frame | X offset | Player | Color theme | Suggested token |
|-------|----------|--------|-------------|-----------------|
| 0 | x=0 | Player 1 | Red `#E53935` | Top hat |
| 1 | x=80 | Player 2 | Blue `#1565C0` | Racing car |
| 2 | x=160 | Player 3 | Green `#2E7D32` | Scottie dog |
| 3 | x=240 | Player 4 | Gold `#F57F17` | Battleship |

### Visual guidance per token

**Top hat (frame 0 — red):**  
Iconic tall cylinder hat. Brim at bottom, oval crown at top. Deep red or black body with a red highlight/shadow. Works well as a simple 2-tone silhouette.

**Racing car (frame 1 — blue):**  
Classic 1930s open-wheel racer viewed at a slight 3/4 angle. Blue body, yellow or silver wheels. Keep it chunky and readable at 32 × 32 px — avoid thin spokes.

**Scottie dog (frame 2 — green):**  
Side-on silhouette of a Scottish Terrier with wiry fur. Body in dark green or black-green; eyes as a small white or yellow dot. The iconic bushy-beard chin and erect tail are the key recognition cues.

**Battleship (frame 3 — gold):**  
Top-down or slight 3/4 view of a naval destroyer. Gold hull, dark gray turrets, small white wake lines. Keep it horizontal/landscape within the square cell.

---

## 2. `assets/images/monopoly-cards.png`

**Total sheet size:** 400 × 300 px  
**Frame size:** 200 × 300 px  
**Layout:** 2 frames side by side in one row  
**Displayed at:** 340 × 220 px inside the card popup (the engine scales the frame to fit the top area of a 360 × 480 popup)

The code overlays its own text labels on top — "CHANCE" or "COMMUNITY CHEST" is printed at the top by the engine, and the card's effect text is printed in the lower half. **The image only needs to fill the upper ~220 px of visible space** — think of it as providing the background art and mood, not the text.

| Frame | X offset | Card type | Background color | Icon |
|-------|----------|-----------|------------------|------|
| 0 | x=0 | Chance | Orange `#E77A2C` | Large "?" |
| 1 | x=200 | Community Chest | Blue `#1565C0` | Treasure chest |

### Frame 0 — Chance (200 × 300 px)

- **Background:** Warm orange gradient, darker toward the top and bottom edges
- **Border:** A thin ornate gold or cream inner border rect (≈ 8 px from each edge)
- **Central icon:** A large bold "?" character, roughly 100 × 140 px, in cream or white with a slight drop shadow. The "?" should be centered horizontally and sit in the lower ⅔ of the frame (the engine prints "CHANCE" at the very top, so leave the top 40–50 px relatively clean)
- **Decorative touches (optional):** Small radiating lines or sunburst behind the "?", art deco corner flourishes

### Frame 1 — Community Chest (200 × 300 px)

- **Background:** Rich blue gradient, `#1565C0` center fading to `#0D3A6E` at edges
- **Border:** Same style ornate inner border as Chance, in gold or cream
- **Central icon:** A wooden treasure chest, slightly open, with a warm interior glow or gold coins visible. Roughly 80 × 70 px, centered horizontally, sitting in the lower ⅔ of the frame. Classic Monopoly Community Chest chests are brown/tan with gold hardware
- **Decorative touches (optional):** Small star or coin scattered around the chest, "art deco" corner ornaments matching the Chance card style for consistency

---

## 3. `assets/images/game-icons.png` — extend existing sheet

**Current sheet size:** 660 × 660 px  
**Grid:** 15 columns × 15 rows of 44 × 44 px cells  
**Current frames:** 0 – 47 (48 icons)  
**Monopoly frame index:** **48**

### Where to paint frame 48

Frame 48 falls at:

```
Column = 48 % 15 = 3    →  x = 3 × 44 = 132 px
Row    = 48 / 15 = 3    →  y = 3 × 44 = 132 px
```

**Paint the Monopoly icon into the cell at (132, 132) — a 44 × 44 px region — in your existing game-icons PSD.**

### Monopoly icon design (44 × 44 px)

The icon is shown at 44 × 44 px in the game menu next to the game title. Suggested design:

- **Background:** Deep green `#1F3D1F` or a classic Monopoly board green
- **Foreground:** A small white/cream Monopoly board viewed from above — simplified to just the four corner squares (a white square outline with the four corner squares indicated) OR simply the red "M" monogram from the Monopoly logo
- **Alternative:** A gold top hat silhouette centered on a dark background — very legible at small size and immediately recognizable

Keep the art to 2–3 colors at most. At 44 × 44 the icon is tiny; bold shapes with strong contrast read far better than detailed illustrations.

---

## Checklist

- [ ] `monopoly-pawns.png` — 4 tokens, 320 × 80 px, transparent background per token
- [ ] `monopoly-cards.png` — 2 card arts, 400 × 300 px, no text (engine adds text)
- [ ] `game-icons.png` — add Monopoly icon at pixel (132, 132) in the existing 660 × 660 sheet