@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: ユーザー入力とキャラクター制御
- スキンシステム: アセット管理とスプライト制御

開発環境のセットアップ

`bash


依存関係のインストール

npm install

開発サーバーの起動

npm start

ライブラリの使用

http://localhost:8080/register.js から利用可能

`

ビルドプロセス

`bash


パッケージのビルド

npm run build

以下のサブタスクが実行されます

1. webpack: ブラウザ用コードのバンドル

2. babel: Node.js用コードの変換

3. definition: 型定義ファイルの生成

`

テスト

`bash


テストの実行

npm test

特定のファイルのテスト

npx ava test/specific-test-file.js
``

デプロイプロセス

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

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

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