開発者向け
キャラッシュテキスト
- v2（2026/10/08〜）: 読み方 ／ フォーマット 能力値の補正が「増減」「その他」の 2 列に。7 版に MOV増減・MOVその他、6 版に【作成の記録】。2026/10/12 から 10_st に【契約悪魔】（名前・性格・階層・見た目）
- v1（2026/09/19〜）: 読み方 ／ フォーマット 選択ルールと自由記述は出ない
過去のバージョンの txt も取り込めます。
キャラッシュ形式のテキストを取り込む外部ツールが v2 に未対応でも、v1 で書き出せば今までどおり連携できます。
| システム | ID | txt・画面の表記 | 正式名 | 出典 |
|---|---|---|---|---|
| 6版 | supp_2010 | クトゥルフ2010 | クトゥルフ2010 | サプリメント |
| 6版 | supp_2015 | クトゥルフ2015 | クトゥルフ2015 | サプリメント |
| 6版 | student_investigator | 学生探索者 | 補遺1：学生探索者の創造 | クトゥルフ2010 140ページ |
| 6版 | investigators_traits | 探索者の特徴 | 選択ルール 探索者の特徴 | クトゥルフ2015 17ページ |
| 6版 | strange_investigators | 奇妙な探索者たち | 選択ルール 奇妙な探索者たち | クトゥルフ2015 55ページ |
| 7版 | supp_2020 | クトゥルフ2020 | クトゥルフ2020 | サプリメント |
| 7版 | supp_2026 | クトゥルフ2026 | クトゥルフ2026 | サプリメント |
| 7版 | point_buy | ポイント購入 | 選択4：ポイントで能力値を購入する | 新クトゥルフ神話TRPG ルールブック 46ページ |
| 7版 | peak_human_potential | 潜在能力の頂点 | 選択6：人間の潜在能力の頂点を極める | 新クトゥルフ神話TRPG ルールブック 46ページ |
| 7版 | child_investigator | 年少探索者 | 選択ルール 年少探索者の創造とプレイ | クトゥルフ2020 71ページ |
| 7版 | experienced_investigators | 経験を重ねた探索者 | 選択ルール：経験を重ねた探索者 | クトゥルフ2020 42ページ |
| 7版 | second_occupation | 副業 | 選択ルール 副業 | クトゥルフ2026 69ページ |
| 7版 | unique_traits | 異才なエントリー | 選択ルール バックストーリー「特徴」の異才なエントリー | クトゥルフ2026 71ページ |
キャラッシュ形式（JSON）
- v1（2026/10/12〜）: 読み方 ／ 定義書（JSON Schema） ／ 見本: エモクロア・クトゥルフ6版・クトゥルフ7版 2026/10/12 から systems.10_st に demon（契約悪魔: name・nature・layer・appearance。layer は B10_ck[1]〜[7] か空）
キャラクター 1 人分を ZIP（character.json＋images/）で書き出し、同じ ZIP を取り込めます。 共通部（profile）・システム別部（systems）・キャラッシュ固有部（charash。外部ツールは無視してよい）の 3 層で、 数値は最終値（value）と内訳の両方を持ちます。読むだけなら value、書き戻すなら内訳を書きます。
取り込みの規則はキャラッシュテキストと同じです。項目が無ければ維持、空なら空にする、一覧は丸ごと置き換え、技能は書いた行だけ更新します。 形が変わるときは版（formatVersion）を上げ、過去の版も取り込めます。
公開API
| メソッド | パス | 内容 |
|---|---|---|
| GET | /api/v1/characters/{characterId} | 公開キャラクター 1 人のキャラッシュ形式（JSON）。画像は images[].url |
| GET | /api/v1/characters/{characterId}/images/{n} | 画像本体（n は 1 から。1 がメイン） |
| POST | /api/v1/characters/{characterId}/unlock | 合言葉で保護された欄 1 つの本文。{ target, password } → { body } |
| GET | /api/v1/schema/character-1.json | 形式の定義書（JSON Schema） |
| GET | /api/v1/samples/{emoklore|coc6|coc7}.json | 見本 |
- 認証はありません。返す範囲は閲覧画面と同じです（非公開は 404。参加セッションは公開設定のときだけ）。CORS は全許可
- キャラクターのデータと画像は作成者（権利者）のものです。利用は 利用規約第 3 条のとおり、各権利者の許諾の範囲で行ってください
- 合言葉で保護された欄は本文が空で locked・hint・lockTarget が付きます。lockTarget と合言葉を POST …/unlock に送ると本文が返ります
- GET の応答は 60 秒キャッシュできます。ETag を If-None-Match で送ると変更がなければ 304 です
- 目安は 1 分あたり 300 回（IP 単位）。超えると 429 と Retry-After が返ります。サーバーで動くツールは応答をキャッシュしてください
- エラーは { "error": { "code", "message" } } の 1 形式。版はパスの v1 で、形が変わるときは v2 を足し v1 は残します
取り込み方法
- キャラクター一覧の設定メニュー（歯車）から「インポート」を開く
- ファイル（txt・キャラッシュ形式の ZIP・駒データの JSON）をドロップするか選ぶ。本文や駒データを貼り付けてもよい
- 確認画面で取り込むキャラクターを確かめて実行する
キャラッシュテキストは 2 行目のキャラクター ID、キャラッシュ形式（JSON）は charash.sourceToken で取り込み先が決まります。無ければ新しいキャラクターとして作成します（同名のキャラクターがいればまとめる）。