@hackforplay/common

HackForPlay でステージを構築するための共通パッケージ

概要

@hackforplay/common は、教育用プログラミングゲーム「HackForPlay」でステージを構築するためのパッケージです。 ゲームオブジェクト、ルール、イベント処理などの機能を提供し、インタラクティブなゲーム作成を可能にします。

プロジェクト構造

packages/game/
├── src/
│   ├── hackforplay/      # コアモジュール
│   │   ├── object/       # オブジェクト関連クラス
│   │   ├── rule.ts       # ルールシステム
│   │   ├── rpg-map.ts    # マップシステム
│   │   ├── skin.ts       # スキンシステム
│   │   └── ...
│   ├── register.js       # エントリーポイント
│   └── index.ts          # メインエクスポート
├── test/                 # テストファイル
├── dist/                 # ビルド成果物
└── package.json          # 依存関係

主要コンポーネント

• RPGObject: すべてのゲームエンティティの基底クラス
• Rule: イベント駆動型のゲームロジック管理システム
• RPGMap: タイルベースのマップ管理と衝突検出
• Player: ユーザー入力とキャラクター制御
• スキンシステム: アセット管理とスプライト制御

開発環境のセットアップ

# 依存関係のインストール
npm install

# 開発サーバーの起動
npm start

# ライブラリの使用
# http://localhost:8080/register.js から利用可能

ビルドプロセス

# パッケージのビルド
npm run build

# 以下のサブタスクが実行されます
# 1. webpack: ブラウザ用コードのバンドル
# 2. babel: Node.js用コードの変換
# 3. definition: 型定義ファイルの生成

テスト

# テストの実行
npm test

# 特定のファイルのテスト
npx ava test/specific-test-file.js

デプロイプロセス

デプロイは以下の 2 つの場所に対して行われます：

1. npm registry: Node.js アプリケーションで使用するためのパッケージ
2. Google Cloud Storage: ブラウザで直接使用するための CDN ホスティング

semantic-release を使用して、コミットメッセージに基づいて自動的にバージョンが決定されます。