CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Coffee Crisis is a C++20 arcade game built with SDL2. The player controls a character defending the UPV (university) from bouncing coffee-ball enemies across 10 stages. Supports 1-2 players, keyboard and gamepad input, and multiple languages (Spanish, Basque, English).

Build Commands

Dependencies: libsdl2-dev and g++ (Linux) or clang++ (macOS).

# Linux
make linux           # Release build → ./coffee_crisis
make linux_debug     # Debug build (defines DEBUG and PAUSE) → ./coffee_crisis_debug

# macOS
make macos           # Release build with clang++
make macos_debug     # Debug build

# Windows (MinGW)
make windows         # Release build → coffee_crisis.exe
make windows_debug   # Debug build

# Release packaging
make linux_release   # Builds and creates .tar.gz
make macos_release   # Builds Intel + Apple Silicon .dmg files
make windows_release # Builds and creates .zip

There is also a CMakeLists.txt available as an alternative build system.

There are no tests or linter configured.

Architecture

All source code is in source/. The game uses a section-based architecture controlled by the Director class:

Director (director.h/cpp): Top-level controller. Initializes SDL, manages the window/renderer, and runs sections in sequence: Logo → Intro → Title → Game → Quit. Owns all shared objects (Screen, Input, Lang, Asset).
Game (game.h/cpp): Core gameplay logic. Manages players, balloons (enemies), bullets, items, stages, menace level, and collision detection. Contains its own update/render loop plus sub-loops for pause and game over screens.
Screen (screen.h/cpp): Rendering abstraction. Manages a virtual canvas (256×192) that gets scaled to the actual window. Handles fullscreen/windowed modes, border rendering, and fade effects.
Input (input.h/cpp): Abstracts keyboard and gamepad input.
Asset (asset.h/cpp): Resource file index. Files are registered with add() and retrieved by name with get(). All paths are relative to the executable.
Lang (lang.h/cpp): i18n system loading text strings from files in data/lang/.

Sprite hierarchy

Sprite → base class for drawing from a PNG spritesheet
AnimatedSprite → extends Sprite with frame-based animation (loaded from .ani files)
MovingSprite → sprite with movement
SmartSprite → sprite with autonomous behavior (score popups, thrown items)

Game entities

Player (player.h/cpp): Player character state and rendering
Balloon (balloon.h/cpp): Enemy entities with multiple types and split-on-pop behavior
Bullet (bullet.h/cpp): Projectiles fired by the player (left/center/right)
Item (item.h/cpp): Collectible items (points, clock, coffee, power-ups)

Audio

jail_audio (jail_audio.h/cpp): Custom audio library wrapping SDL2 audio. Uses stb_vorbis for OGG decoding. Provides JA_* functions for music and sound effects with channel-based mixing.

Key constants

Defined in const.h: block size (8px), virtual canvas (256×192), play area bounds, section/subsection IDs, and color definitions.

Data Directory

data/gfx/ — PNG spritesheets and .ani animation definition files
data/font/ — bitmap font files
data/music/ and data/sound/ — audio assets
data/lang/ — language files (es_ES, ba_BA, en_UK)
data/config/ — gamecontroller DB, demo recording data
data/menu/ — menu definition files

Language

Code comments and variable names are primarily in Spanish/Catalan-Valencian. README is in Catalan-Valencian.

3.7 KiB Raw Blame History Unescape Escape