fp-space

A functional space shooter game library

Installation

$ npm install --save fp-space

Usage

const game = require('fp-space');

// Initialize game state (default: 15x15 grid)
let state = game.init(15, 15);

// Handle key input: 'left', 'right', 'up' (fire), 'space' (pause)
state = game.key('left', state);

// Advance one tick (moves missiles up, meteorite down every 3rd tick)
state = game.tick(state);

// Merge all panels into a 2D array for rendering
const grid = game.join(state);
grid.forEach(row => {
  console.log(row.map(item => game.isBlankItem(item) ? '  ' : '■ ').join(''));
});

API

init(rows?, columns?)

Creates the initial game state. Defaults to a 15×15 grid.

Returns an object with three panels:

• shuttlePanel — the player's ship (magenta, T-shape, centered at the bottom)
• meteoritePanel — a row of meteorites (blue) falling from the top
• missilePanel — missiles (yellow) fired by the player

tick(state)

Advances the game by one frame:

• Moves all missiles one step up
• Moves the meteorite one step down every 3rd tick
• Detects collisions (overlapping missiles and meteorites cancel each other)
• Spawns a new meteorite row when all meteorites are destroyed

key(keyName, state)

Applies a key input to the game state. Valid keys:

| Key | Action | |---|---| | left | Move shuttle left (blocked by edge or meteorite) | | right | Move shuttle right (blocked by edge or meteorite) | | up | Fire a missile from the shuttle | | space | Toggle pause |

join(state)

Merges missilePanel, shuttlePanel, and meteoritePanel into a single 2D array for rendering.

isBlankItem(item)

Returns true if the cell is empty.

Demo GIF 업데이트

터미널 동작 미리보기를 자동으로 재생성합니다.

# 의존 도구 설치 (최초 1회)
brew install asciinema
brew install agg
brew install gh && gh auth login

# 데모 생성 및 GitHub Releases 업로드
npm run release

npm run release 실행 순서:

1. scripts/autoplay.js — AI가 게임을 자동 플레이하고 자동 종료
2. asciinema rec — 터미널 출력을 demo.cast로 녹화
3. agg — demo.cast → demo.gif 변환
4. gh release upload — GitHub Releases demo-assets 태그에 업로드
5. README.md — GIF URL을 GitHub Releases 경로로 교체

master 브랜치에 푸시하면 .github/workflows/demo.yml이 위 과정을 자동으로 실행합니다.

License

MIT © Bob Hwang