**Show HN：** 長時間戦略ゲーム「FreeCiv」を友人とプレイする

Freeciv Longturn Server

自己ホスト型の Freeciv 3.2.3 マルチプレイヤーサーバーで、長時間ターン（23 時間）を想定しています。
Fly.io 上で動作し、メール通知・ライブステータスページ・AI が生成する新聞機能があります。

• ライブデモ： https://freeciv.andrewmcgrath.info
• 現在 16 人が参加しているアクティブゲームが稼働中です。ライブランキングやターンカウントダウン、ヒストリーチャート、外交追跡、AI が作成した戦時新聞などはステータスページでご確認いただけます。

Longturn とは？

Longturn は Freeciv のマルチプレイヤー形式の一つで、1 ターンが数分ではなく約 23 時間続きます。
プレイヤーは毎日ログインし、行動を決定したら Turn Done をクリックして生活に戻ります。
全員がターン終了（またはタイマー切れ）すると次のターンへ移行します。

アーキテクチャ概要

┌─────────────────────────────────────────────────┐
│  Fly.io コンテナ                               │
│                                                 │
│  entrypoint.sh                                  │
│    ├── busybox crond (ステータスページ更新)   │
│    └── start.sh                                 │
│         ├── freeciv-server (ポート 5556)          │
│         ├── busybox httpd (ポート 8080 → 80/443) │
│         ├── FIFO コマンドライター                │
│         ├── Turn change watcher                  │
│         ├── Auto‑saver (5 分ごと)               │
│         └── Turn reminder checker               │
│                                                 │
│  /data/saves (永続ボリューム)                   │
│    ├── lt-game-*.sav.gz   – セーブファイル      │
│    ├── freeciv.sqlite      – プレイヤー認証DB   │
│    ├── status.json         – ライブゲーム状態  │
│    ├── history.json        – ターンごとの統計  │
│    ├── attendance.json    – 欠席したターン     │
│    ├── diplomacy.json     – 関係性             │
│    └── gazette.json       – AI 新聞記事         │
└─────────────────────────────────────────────────┘

サーバーは FIFO パイプ (

/tmp/server-input

スクリプト

start.sh

ステータスページ

status.json

history.json

attendance.json

diplomacy.json

status.json

通知

turn_notify.sh

プレイヤー管理

ユーティリティ

./fix_turn_timer.sh 4

./change_gold.sh andrew 50

設定ファイル

true

false

generate_status_json.sh

セットアップガイド

前提条件

• Fly.io CLI (

  flyctl

  )
• Docker（ローカルビルド／テスト用）
• AWS アカウントに SES を設定済み（メール通知用）
• OpenAI API キー（AI 新聞機能オプション）

1. クローン＆設定

   git clone <repo‑url>
   cd freeciv-server
   cp .env.sample .env
   

   .env

   を編集し認証情報を入力します：

   SES_SMTP_USER=your-ses-smtp-username
   SES_SMTP_PASS=your-ses-smtp-password
   SES_SMTP_HOST=email-smtp.us-east-1.amazonaws.com
   OPENAI_API_KEY=your-openai-key  # optional, for gazette
   

2. ゲーム設定をカスタマイズ
   

   longturn.serv

   を編集：

   timeout 82800          # ターン長（秒） 23 時間
   unitwaittime 36000     # ダブルムーブ防止 10 時間
   victories ALLIED       # 勝利条件
   

   プレイヤーコマンドを末尾に追加。

3. プレイヤー追加

   cp players.conf.sample players.conf
   

   players.conf

   を編集：

   PLAYERS=(
     "player1:pass123:player1@example.com:Australian"
     "player2:pass456:player2@example.com:Canadian"
     # … add one line per player
   )
   

   フォーマットは

   "username:password:email:nation"

   。
   このファイルは git‑ignore され、認証情報はローカルに残ります。
   

   longturn.serv

   と

   start.sh

   の

   aitoggle

   エントリに対応する

   create

   コマンドを追加してください（

   HOWTO-PROVISION-PLAYERS.md

   を参照）。

4. Fly.io へデプロイ

   fly launch --name your-app-name
   fly volumes create freeciv_saves --size 1 --region your-region
   fly secrets set \
     SES_SMTP_USER=your-ses-smtp-username \
     SES_SMTP_PASS=your-ses-smtp-password \
     OPENAI_API_KEY=your-openai-key
   fly deploy
   

5. プレイヤーアカウント作成

   ./manage_players.sh create-all    # すべてのアカウント + ウェルカムメール送信
   # 単一プレイヤーの場合：
   ./manage_players.sh create username password email@example.com
   

   SQLite 認証 DB に書き込み、各プレイヤーへ接続手順付きウェルカムメールを送信します。

6. 接続情報共有
   プレイヤーは Freeciv 3.2.3 クライアントで次の設定を使用して接続します：

   • ホスト：

     your-app-name.fly.dev

   • ポート：

     5556

   • ユーザー名／パスワード：作成時に指定したもの

   ステータスページは

   https://your-app-name.fly.dev

   で確認できます。

よくある操作

# 変更をデプロイ
fly deploy

# コンテナへ SSH
fly ssh console --app your-app-name

# 強制セーブ
fly ssh console --app your-app-name -C "sh -c 'echo save > /tmp/server-input'"

# ステータスページ再生成
fly ssh console --app your-app-name -C "/opt/freeciv/generate_status_json.sh"

# サーバーログ確認
fly ssh console --app your-app-name -C "tail -50 /data/saves/server.log"

# ターン締切を 4 AM に変更
./fix_turn_timer.sh 4

# プレイヤーの金額を変更
./change_gold.sh playername 100

# メール通知をオフにする
# `email_enabled.settings` を "false" に編集し、再デプロイ

# サーバー再起動（タイマーは継続）
fly apps restart your-app-name

ゲーム状態の変更方法

ゲーム中に状態を安全に変更する最も確実な手段はセーブファイルを直接編集することです。
FIFO コマンドは約 200 文字を超えると崩れ、サーバー側で多くのコマンドが途中でブロックされます。

1. 強制セーブ

   fly ssh console --app your-app-name -C "sh -c 'echo save > /tmp/server-input; sleep 3'"
   

2. ダウンロード

   fly ssh console --app your-app-name -C "cat /data/saves/save-latest.sav.gz" > /tmp/save.sav.gz
   gzip -dc /tmp/save.sav.gz > /tmp/save.txt
   

3. /tmp/save.txt

   を編集（プレーンテキスト INI 形式）。

4. アップロード＆再起動

   gzip -c /tmp/save.txt > /tmp/save-edited.sav.gz
   cat /tmp/save-edited.sav.gz | base64 | fly ssh console --app your-app-name \
     -C "sh -c 'base64 -d > /data/saves/save-latest.sav.gz'"
   fly apps restart your-app-name
   

再起動時のレジリエンス

サーバーは再起動やリデプロイ時にターンタイマーを保持します。

start.sh

• セーブファイルから

  phase_seconds

  （現在のターン経過秒）を読み取ります。
• 残り時間＝

  timeout - phase_seconds

  を計算し、正しい締切を再設定します。
• プレイヤーがタイムロスしないようにします。

環境変数

SES_SMTP_USER

SES_SMTP_PASS

SES_SMTP_HOST

email-smtp.us-east-1.amazonaws.com

OPENAI_API_KEY

SERVER_HOST

freeciv.andrewmcgrath.info

FROM_EMAIL

freeciv@andrewmcgrath.info

本番環境では Fly.io のシークレットとして設定します：

fly secrets set SES_SMTP_USER=... SES_SMTP_PASS=... OPENAI_API_KEY=...

プロジェクト構成

├── Dockerfile                  # マルチステージビルド（Freeciv コンパイル + ランタイム）
├── fly.toml                    # Fly.io 設定
├── entrypoint.sh               # コンテナエントリーポイント
├── start.sh                    # サーバー起動オーケストレーター
├── longturn.serv               # ゲーム設定
├── fcdb.conf                   # 認証 DB 設定
├── database.lua                # DB 初期化
├── crontab                     # スケジュールタスク
├── email_enabled.settings      # メール通知トグル
├── turn_notify.lua             # ターン変更シグナルハンドラ
├── generate_status_json.sh     # ステータスページデータパイプライン
├── generate_gazette.sh         # AI 新聞生成
├── generate_nations.sh         # 国一覧ページ生成
├── turn_notify.sh              # ターン通知メール送信
├── turn_reminder.sh            # 締切リマインダーメール
├── manage_players.sh           # プレイヤーアカウント管理
├── fix_turn_timer.sh           # 手動締切オーバーライド
├── change_gold.sh              # 金額調整ユーティリティ
├── local_preview.sh            # ローカルステータスページプレビュー
├── .env.sample                 # 環境変数テンプレート
└── www/
    ├── index.html              # ステータスページ（JS 測定）
    ├── changelog.html          # ゲーム変更履歴
    └── cgi-bin/
        └── health              # ヘルスチェックエンドポイント

CLAUDE.md – 運用参考資料。