# 箱庭諸島２ TypeScript 版

> 懐かしの Web ブラウザゲーム「箱庭諸島２」を TypeScript で書き直し、Cloudflare Workers にワンクリックで設置できるようにしたものです。

## Docs

- [クレジットとライセンス](https://hakoniwajs.github.io/hakoniwa/credits): オリジナルの箱庭諸島２の作者の方々への謝辞と、スクリプト・画像の利用条件です。

## 設置する

- [設置方法の選び方](https://hakoniwajs.github.io/hakoniwa/setup): 箱庭諸島２ TypeScript 版を設置する 3 つの方法と、それぞれに必要なものを紹介します。
- [Cloudflare にワンクリックでデプロイする](https://hakoniwajs.github.io/hakoniwa/setup/cloudflare): Deploy to Cloudflare ボタンで、箱庭諸島２を自分の Cloudflare アカウントに設置します。いちばん簡単な方法です。
- [Cloudflare に手動でデプロイする](https://hakoniwajs.github.io/hakoniwa/setup/cloudflare-manual): @hakoniwajs/cloudflare をインストールした Worker プロジェクトを作り、Wrangler でデプロイします。
- [Node.js で自前のサーバーに設置する](https://hakoniwajs.github.io/hakoniwa/setup/node): @hakoniwajs/node をインストールし、npx hakoniwa serve で HTTP サーバーを起動します。
- [ログイン方法の設定](https://hakoniwajs.github.io/hakoniwa/setup/login-methods): X (Twitter)・Discord・メール (マジックリンク) の各ログイン方法を有効にする手順です。
- [環境変数一覧](https://hakoniwajs.github.io/hakoniwa/setup/environment-variables): 箱庭諸島２ TypeScript 版で設定できる環境変数の一覧です。

## 運営する

- [管理画面](https://hakoniwajs.github.io/hakoniwa/operation/admin): 管理画面 (/admin) でできることの一覧です。ゲームの開始・終了、設定の変更、ログイン方法の切り替え、バックアップなどを行えます。
- [ゲームとシーズン](https://hakoniwajs.github.io/hakoniwa/operation/season): ゲームの開始から結果発表までの流れと、複数のゲームを続けて開催する方法です。
- [CLI](https://hakoniwajs.github.io/hakoniwa/operation/cli): Node.js 版の hakoniwa コマンドで、ゲームの開始・終了、ターンの操作、バックアップを行います。
- [バックアップ](https://hakoniwajs.github.io/hakoniwa/operation/backup): ゲームのデータをバックアップし、必要なときに復元する方法です。

## 遊ぶ

- [遊び方](https://hakoniwajs.github.io/hakoniwa/play): 島を発見して開発計画を登録するまでの、プレイヤー向けの基本的な遊び方です。
- [URL 構成](https://hakoniwajs.github.io/hakoniwa/play/urls): ゲームの各ページの URL の一覧です。

## 開発者向け

- [開発者向けドキュメント](https://hakoniwajs.github.io/hakoniwa/development): 箱庭諸島２ TypeScript 版の開発に参加する方向けに、リポジトリの構成を説明します。
- [ローカル開発](https://hakoniwajs.github.io/hakoniwa/development/local): Node.js の開発サーバーと wrangler dev で、手元でゲームを動かす方法です。
- [テストと静的検査](https://hakoniwajs.github.io/hakoniwa/development/testing): Vitest によるテストと、vp によるフォーマット・lint・型チェックの実行方法です。
- [内部の仕組み](https://hakoniwajs.github.io/hakoniwa/development/architecture): ターン進行の排他制御、島の放棄、OGP 画像の生成など、実装の要点を説明します。
- [キャッシュの仕組み](https://hakoniwajs.github.io/hakoniwa/development/cache): Workers Cache のエントリポイント構成と既定の no-store 方針、未ログイン・ログイン中のページのキャッシュ、画像の長期キャッシュを説明します。
- [リリースとドキュメント公開](https://hakoniwajs.github.io/hakoniwa/development/release): npm パッケージのリリース、テンプレートリポジトリへの追従、このドキュメントサイトの公開の流れです。

## Agent resources

- [llms-full.txt](https://hakoniwajs.github.io/hakoniwa/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://hakoniwajs.github.io/hakoniwa/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://hakoniwajs.github.io/hakoniwa/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://hakoniwajs.github.io/hakoniwa/openapi.json.
- [API catalog](https://hakoniwajs.github.io/hakoniwa/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://hakoniwajs.github.io/hakoniwa/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://hakoniwajs.github.io/hakoniwa/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://hakoniwajs.github.io/hakoniwa/sitemap.xml): Every indexable page URL with its last-modified date.