ERN_RelicForge

Elden Ring: Nightreign のセーブファイル (.sl2) から遺物情報を抽出・閲覧・最適化するツール。 CLI パーサー、遺物組み合わせ最適化ツール、Electron ベースの GUI ビューアー、および GitHub Pages 対応の Web 版を提供。

最新版: v1.1.0（ゲームデータは Regulation 1.03.5 に対応）
Web 版: https://cetusk.github.io/ERN_RelicForge/web/index.html （スマートフォンでも利用可能）
Electron 版: Releases から各 OS 用をダウンロード

Folder Structure

ERN_RelicForge/
├── README.md
├── LICENSE
├── requirements.txt             # Python 依存関係
├── .gitignore
│
├── src/
│   ├── relic_parser.py          # セーブファイル解析パーサー
│   └── relic_optimizer.py       # 遺物組み合わせ最適化ツール
│
├── resources/
│   ├── items_data.json          # アイテムデータ (1003件, 日英名称付き)
│   ├── effects_data.json        # エフェクトデータ (1117件, 日英名称・重複可否・備考付き)
│   └── vessels_data.json        # 献器データ (全10キャラ・4汎用献器)
│
├── gui/                         # Electron GUI アプリ (Python 不要)
│   ├── package.json
│   ├── main.js                  # メインプロセス
│   ├── preload.js               # IPC ブリッジ
│   └── renderer/
│       ├── index.html
│       ├── app.js               # UI ロジック
│       ├── relic-parser.js      # JS 版パーサー (web/ と共通)
│       ├── relic-optimizer.js   # JS 版最適化 (web/ と共通)
│       ├── relic-share.js       # 共有リンク・QR コードの作成・読み込み (web/ と共通)
│       ├── lib/
│       │   ├── crypto-js.min.js # AES-CBC 復号化用
│       │   ├── icons.js         # 画面のアイコン (Lucide)
│       │   └── qrcode.js        # QR コード生成 (qrcode-generator)
│       └── style.css            # ダークテーマスタイル
│
├── web/                         # Web 版 (GitHub Pages 対応)
│   ├── index.html
│   ├── app.js                   # UI ロジック (ブラウザ専用)
│   ├── relic-parser.js          # JS 版パーサー (CryptoJS 使用)
│   ├── relic-optimizer.js       # JS 版最適化 (Web Worker 対応)
│   ├── relic-share.js           # 共有リンク・QR コードの作成・読み込み
│   ├── style.css                # ダークテーマスタイル
│   └── lib/
│       ├── crypto-js.min.js     # AES-CBC 復号化用
│       ├── icons.js             # 画面のアイコン (Lucide)
│       ├── qrcode.js            # QR コード生成 (qrcode-generator)
│       └── zxing/               # QR コード読み取り (ZXing の WebAssembly 版、読み取り画面を開いたときだけ読み込む)
│
├── examples/
│   ├── sample_output.json       # パーサーサンプル出力
│   ├── sample_effects_config.json  # 効果指定サンプル
│   └── test_wylder_effects.json    # 追跡者テスト用効果指定
│
├── tools/
│   ├── wiki_effects/            # 効果データ (重ね掛け・備考) の攻略 Wiki 照合ツール
│   └── icons/                   # 画面アイコン (lib/icons.js) の生成
│
└── tests/                       # 回帰テスト (GitHub Actions で自動実行)
    ├── test_*.py                # Python 版パーサー・オプティマイザ・データ整合性
    ├── *.test.js                # JS 版 (web / gui) パーサー・オプティマイザ・共通ファイル一致
    ├── check_real_saves.py      # 実セーブファイルでの確認 (ローカル専用)
    └── fixtures/                # 合成セーブファイル・遺物プール・期待値 (generate.py で生成)

Features

セーブファイル解析

.sl2 セーブファイルの復号化・遺物抽出
遺物の ID、色、タイプ、効果、座標などを JSON 出力
AES 復号キーのキャッシュによる高速化
パターン検索時の負オフセット境界チェック
ソートキーインデックスの O(N) 構築・O(1) ルックアップ
座標計算の O(N) シングルパス処理
データ未収録のアイテム・効果（ゲームアップデートでの追加分など）を含む遺物も除外せず、「未知の遺物 (ID: …)」「未知の効果 (ID: …)」として出力し件数を警告

遺物組み合わせ最適化

献器スロット色制約に基づく 6 スロット（通常 3 ＋深層 3）一括最適化
効果の重複可否を考慮したスコアリング
集中ボーナス: 同一遺物に望ましい効果が複数ある場合にスコア加算
除外条件: 特定の効果を含む組み合わせを除外可能
全献器の比較と最高スコアの自動選出
ビットマスク事前フィルタによる必須効果充足の O(1) 判定
適応的候補数制御（スペック数に応じた maxPairs 動的調整）
2 層ヒープ分離（required_met の True/False を独立管理し枝刈り安定化）
「通常のみ」モードも「通常＋深層」と同じ選抜処理で探索（必須充足を優先し、同点は補助スコアで比較。通常のみでは全組み合わせを評価）
JS 版ビットマスク演算の 32bit 溢れ防止ガード（nSpec >= 32 時は自動無効化）
同スコア時の決定的タイブレーカー（ソート済み遺物 ID による Python/JS 間の結果一致保証）

Web 版

GitHub Pages 対応 — インストール不要でブラウザから利用可能
Python パーサー・最適化ツールを JavaScript に完全移植
ファイル選択 / フォルダ自動読み込み (Chrome/Edge) / ドラッグ＆ドロップ対応
Web Worker による非同期最適化（UI ブロック防止）
Electron 版と同等の全機能を提供
スマートフォン対応（画面幅に応じたレイアウト）
- 一覧はカード表示。絞り込み・機能・読み込んだデータ・言語は「≡」メニューにまとめ、メニューから開いた画面を閉じるとメニューに戻る
- 遺物・ビルド探索結果の詳細は一覧の上に重ねて表示し、外側のタップ・下へのスワイプ・戻る操作（iPhone の端からのスワイプ）で閉じる
- 効果カタログの絞り込みは開閉式。ビルド探索の優先順位は指でも並べ替え可能
- ダウンロードしたセーブファイルの場所を端末（iPhone / Android / PC）に合わせて案内
スマホ・タブレットでは、読み込んだ遺物の一覧を端末（ブラウザの IndexedDB、データベース名 ERNRelicForge）に記録し、次回は開くだけで表示。記録するのは遺物の ID・効果・並び順とキャラクター名・ファイル名のみで、セーブファイル本体や Steam ID は記録しない（メニューの「記録を消す」で消去可能。ゲームのセーブデータには影響しない）。PC ではセーブファイルを直接読めるため記録しない
Steam クラウドからの読み込み案内: ゲームの入っていない端末でも、Steam のクラウド保存ページ（公式）からダウンロードしたセーブファイルで確認可能（ログイン情報やファイルはアプリに送信されない）
共有リンク: 表示中の遺物データをリンク（約 1 万文字 / 1200 件）またはテキストファイルにして別の端末へ渡せる（Web 版・Electron 版）。データは URL の # 以降に含まれ Web サーバーには送信されない。遺物の固有 ID と取得順の番号は含まず（並び順は保持）、キャラクター名は任意。受け取った側では自動で記録せず、スマホ・タブレットでは「この端末に記録」で記録
QR コードで渡す: 共有リンクは QR コード 1 つには収まらない（最大約 2,900 文字）ため、約 500 文字の QR コードを PC などの画面に自動で切り替えて表示し、スマホの「QR コードを読み取る」（カメラ）で読み取る。ファウンテン符号を使うので、どの QR コードから読み取ってもよく、データの分割数（1200 件で約 20）より数枚多く読み取れば完了する（読み逃した QR コードが再び表示されるのを待つ必要がない）（表示は Web 版・Electron 版、読み取りは Web 版のスマホ・タブレット。カメラを使うため https のページでのみ利用可能）

GUI ビューアー (Electron / Web 共通)

Electron 版は Python 不要のスタンドアロンアプリ（JS 版パーサー・オプティマイザを内蔵）
Windows / macOS / Linux 対応のクロスプラットフォームビルド
日本語 / English 対応（テーブル、詳細パネル、インスペクターすべてに反映）
効果名のテキスト検索（日英両対応、サジェスト付き）
色・タイプフィルター
テーブルのカラムヘッダークリックによるソート
行クリックで詳細パネル表示（効果一覧・備考情報を含む）
VS Code 風ミニマップ（色反映・ドラッグスクロール対応）
未知の遺物（データ未収録のアイテム・効果を含む遺物）がある場合、ヘッダーに件数を警告表示

高度な検索（インスペクター）

効果がカテゴリー別にグループ化（全 19 カテゴリー: キャラクター固有, 能力値, 攻撃力, スキル／アーツ, 魔術／祈祷, カット率, 状態異常耐性, 回復, アクション, 出撃時の武器（戦技）, 出撃時の武器（付加）, 出撃時の武器（魔術／祈祷）, 出撃時のアイテム, 出撃時のアイテム（結晶の雫）, マップ環境, チームメンバー, 夜の力, デメリット, その他）
AND グループフィルタリング: 3 つの独立した条件グループ（グループ内は OR、グループ間は AND）
- 例: 条件 1 で攻撃力系、条件 2 で回復系を指定 → 両方を満たす遺物のみ表示

ビルド探索（GUI 内最適化）

キャラクター・献器選択による一括最適化
通常 + 深層 6 スロット統合モード
効果の優先度指定（必須 / 推奨 / 任意）
除外条件の指定（除外:必須 / 除外:推奨 / 除外:任意）
タブ形式の結果表示
スコア内訳の詳細表示（各効果の寄与、集中ボーナス、除外ペナルティ）

効果カタログ

セーブファイル内の所持効果をカテゴリ別タイルグリッドで一覧表示
カテゴリ（全 19 分類）/ 通常・深層 / 重複可否のフィルター
日本語・英語によるテキスト検索
カテゴリごとの折りたたみ・展開
重複可否バッジ（○ 重複可 / × 重複不可 / △ 条件付き）と深層バッジの表示
所持数の表示
効果名・備考の HTML エスケープ（XSS 防止）
タブ切替による遺物一覧・ビルド探索結果との共存

HTML エクスポート

遺物一覧テーブルをスタンドアロン HTML としてエクスポート（フィルタ適用状態を保持）
ビルド探索結果を HTML エクスポート（全結果カード + 各カードのスコア内訳詳細を含む）
ダークテーマ CSS 埋め込みによりオフラインで閲覧可能
現在の言語設定（日本語 / English）に対応

エフェクトデータ

Wiki 準拠のカテゴリー自動分類（classifyEffect）
結晶雫・芳香類を含む全出撃時アイテム名の Wiki 準拠修正
備考欄（倍率、個数、発動条件、持続時間等）を収録
重複可否・備考を攻略 Wiki の「遺物効果」ページ（2026-10-10 更新版）と全件照合して更新
- 備考は要約（stackNotes：一覧・カタログ・詳細の1行表示）と全文（stackNotesFull：詳細パネルに表示、カタログはマウスオーバー）の2段構成
- 「+値が違えば重ね掛け可」等の条件付き効果は、同じ効果どうしは重ならないため「×」として扱う
- Wiki で重ね掛けが未検証の効果は、その旨を備考に記載
- ゲームや Wiki の更新時は python tools/wiki_effects/sync.py で再照合できる（使い方）

Requirements

Web 版 / Electron GUI: 不要（Python 不要、スタンドアロンで動作）

CLI:

Python 3.7 以上
pycryptodome

Installation

Web 版: インストール不要。ブラウザでアクセスするだけで利用可能。

Electron GUI: GitHub Releases からプラットフォーム別の実行ファイルをダウンロード:

Windows: .exe インストーラーまたはポータブル版
macOS: .dmg
Linux: .AppImage

CLI (Python):

pip install -r requirements.txt

開発者向け (ソースから実行):

cd gui
npm install
npm start

Usage

CLI

python src/relic_parser.py <save_file.sl2> [options]

オプション	説明	デフォルト
`-o, --output FILE`	出力ファイル名	`output.json`
`--items FILE`	アイテムデータファイル	`resources/items_data.json`
`--effects FILE`	エフェクトデータファイル	`resources/effects_data.json`

# 例
python src/relic_parser.py path/to/NR0000.sl2 -o result.json

遺物最適化ツール

python src/relic_optimizer.py --input <parser_output.json> --effects <effects_config.json> [options]

オプション	説明	デフォルト
`--input FILE`	relic_parser 出力の JSON ファイル	(必須)
`--effects FILE`	効果指定ファイル (JSON)	なし
`-o, --output FILE`	出力ファイル名	`combinations.json`
`--character NAME`	キャラクター名 (例: `追跡者`, `Wylder`)	なし (全キャラ)
`--vessel TYPE`	献器タイプ, カンマ区切り (例: `urn,chalice`)	なし (全献器)
`--combined`	通常3＋深層3の6スロット一括最適化	off
`--deep`	深層遺物スロットを使用 (非combined時)	off
`--color COLOR`	遺物の色 (献器未使用時)	なし (全色)
`--types TYPES`	遺物タイプ, カンマ区切り	献器指定時 `Relic,UniqueRelic` (`--deep` 時 `DeepRelic`) / 献器未使用時 `Relic`
`--top N`	献器あたりの出力候補数	`10`
`--candidates N`	スロットあたりの候補数	`30`

# 例: 追跡者向け、全献器で通常+深層の一括最適化
python src/relic_optimizer.py --input output.json \
  --effects examples/test_wylder_effects.json \
  --character 追跡者 --combined -o result.json

# 例: 特定献器のみ
python src/relic_optimizer.py --input output.json \
  --effects examples/sample_effects_config.json \
  --character 追跡者 --combined --vessel chalice

効果指定ファイル

欲しい効果とその優先度を記述する JSON ファイル:

{
  "effects": [
    { "key": "physicalAttackUpPlus4", "priority": "required" },
    { "key": "improvedSkillAttackPower", "priority": "preferred" },
    { "key": "increasedRuneAcquisitionForSelfAndAllies", "priority": "nice_to_have" }
  ]
}

優先度	意味	スコア重み
`required`	必須	100
`preferred`	あれば嬉しい	10
`nice_to_have`	あったら良い	1
`exclude_required`	必ず除外	-100
`exclude_preferred`	なるべく除外	-10
`exclude_nice_to_have`	できれば除外	-1

スコアリング

スタック可能な効果: 重み × 遺物数（重複で恩恵あり）
スタック不可な効果: 重み × 1（重複しても1回のみ）
集中ボーナス: 1 つの遺物に望ましい効果が複数含まれる場合、追加スコアを加算
required 充足の組み合わせがスコアに関わらず優先される
献器指定時の探索アルゴリズムは GUI / Web 版と共通（非 combined モードも GUI の「通常のみ」と同じ探索を行い、同じ結果を返す）

出力構造

{
  "bestResult": {
    "parameters": { "vessel": {...}, ... },
    "result": { "rank": 1, "score": 810, "requiredMet": true, ... }
  },
  "allResults": [
    {
      "parameters": { "vessel": {...}, ... },
      "results": [ { "rank": 1, ... }, { "rank": 2, ... }, ... ]
    }
  ]
}

bestResult — 全献器中の最高スコア1件
allResults — 全献器の top N 件

Web 版 (GitHub Pages)

インストール不要。ブラウザでアクセスするだけで利用可能。

GitHub Pages にデプロイする場合は、リポジトリの Settings > Pages から main ブランチの / (root) を設定。 web/index.html が https://<username>.github.io/<repo>/web/ で公開される。

ファイルの読み込み方法

Web 版では次の方法で遺物を読み込める:

ファイルを選択して開く — ファイル選択ダイアログから .sl2 / .bak を選択
フォルダから自動読み込み (Chrome / Edge のみ) — フォルダを選択すると .sl2 / .sl2.bak を再帰検索。見つかったファイルが 1 件なら自動ロード、複数件なら一覧から選択。選択したフォルダは IndexedDB に保存され、次回アクセス時に自動復元を試行
ドラッグ＆ドロップ — Welcome 画面に .sl2 / .bak ファイルをドラッグ＆ドロップ
Steam クラウドから読み込む — ゲームの入っていない端末（スマホなど）向け。案内に従って Steam の公式ページでセーブファイルをダウンロードし、そのファイルを選択
共有リンク / 共有ファイル — 別の端末の「共有」で作ったリンクを開く、または共有ファイル (.txt) を「ファイルを開く」で選択
QR コードを読み取る (スマホ・タブレット、https のページのみ) — 別の端末の「共有」→「QR コードで渡す」の画面をカメラで読み取る

ブラウザ対応

機能	Chrome / Edge	Firefox / Safari
ファイル選択	o	o
フォルダ自動読み込み	o	x (非対応)
ドラッグ＆ドロップ	o	o
QR コードの読み取り（スマホ・タブレット）	o	o

技術的な違い (Electron 版 vs Web 版)

Electron 版・Web 版ともに JavaScript 版パーサー・オプティマイザを使用（Python 不要）
AES-CBC 復号化: CryptoJS（両版共通）
最適化処理: Web Worker による非同期実行（両版共通）
セーブファイルアクセス: Electron 版はネイティブダイアログ、Web 版は File API / File System Access API
プリセット保存: Electron 版はファイルダイアログ、Web 版はブラウザダウンロード / アップロード
HTML エクスポート: 遺物一覧・ビルド探索結果を CSS 埋め込みスタンドアロン HTML として出力

Electron GUI

cd gui
npm start

基本操作

ファイルを開く - 起動後、「ファイルを開く」ボタンから .sl2 セーブファイルを選択
ヘッダーにプレイヤー名、遺物数、読み込みファイル名が表示される
遺物一覧テーブルが表示される

フィルター・検索

色フィルター - ツールバーの「色」ドロップダウンで Red / Blue / Yellow / Green を選択
タイプフィルター - 「タイプ」ドロップダウンで通常 / 深層 / 固有を選択
テキスト検索 - 検索ボックスに効果名やアイテム名を入力（日英両対応、サジェスト付き）
高度な検索 - ツールバーの「高度な検索」ボタンでインスペクターパネルを開く
- 効果がカテゴリー別にグループ化、カテゴリー全選択チェックボックス付き
- AND グループ（条件1〜3）によるクロスフィルタリング

ビルド探索

ツールバーの「ビルド探索」ボタンからパネルを開く
キャラクター・献器を選択し、効果に優先度（必須/推奨/任意）または除外条件を設定
「探索開始」で最適な遺物組み合わせを算出、結果はタブ形式で比較可能
結果カードをクリックすると詳細パネルにスコア内訳（各効果の寄与、集中ボーナス、除外ペナルティ）を表示
検索条件プリセットの保存・読込に対応

効果カタログ

ツールバーの「効果カタログ」ボタンからカタログタブを開く
所持している効果のみをカテゴリ別タイルグリッドで表示（未公開情報を含まない）
カテゴリ / 通常・深層 / 重複可否のフィルターで絞り込み
テキスト検索（日英両対応）で効果名を検索
カテゴリヘッダーをクリックで折りたたみ・展開
遺物一覧やビルド探索結果のタブと並行して利用可能

HTML エクスポート

遺物一覧タブ: ツールバーの「エクスポート」ボタンで現在のフィルタ適用済みテーブルを HTML ファイルとしてダウンロード
ビルド探索結果: 結果サマリー内の「エクスポート」ボタンで全結果カードとスコア内訳詳細を HTML ファイルとしてダウンロード
エクスポートされた HTML はスタンドアロンで、ブラウザで直接開いてオフライン閲覧可能

詳細表示

テーブルの行をクリックすると右側に詳細パネルが開き、基本情報と効果一覧（備考情報を含む）を確認できる

Tests

push / PR 時に GitHub Actions (Python 3.12 / Node.js 24) で自動実行される。ローカルでは以下で実行:

pip install -r requirements.txt
python -m unittest discover -s tests -v   # Python 版
node --test tests/*.test.js               # JS 版 (web / gui)

実際のセーブファイルは個人情報を含むためリポジトリに含めず、遺物スロットの構造を再現した合成セーブファイル (tests/fixtures/synthetic_save.sl2) と、ゲームデータから決定的に生成した遺物プールでテストする
期待値は Python 版で生成し、Python 版・JS 版 (web / gui) がすべて同じ結果を返すことを確認する
web/ と gui/renderer/ の共通ファイル (パーサー・オプティマイザ・CryptoJS) が一致していることも確認する
挙動を意図的に変更した場合は python tests/fixtures/generate.py で期待値を再生成し、差分を確認してからコミットする
手元の実セーブファイルでの確認: python tests/check_real_saves.py (debugs/*.sl2 を対象に Python/JS の一致と未知の遺物の有無を確認)

Output Example

{
  "file": "NR0000.sl2",
  "characterName": "cetusk",
  "totalRelics": 1633,
  "unknownRelics": 0,
  "relics": [
    {
      "id": 3229615531,
      "itemId": 132,
      "itemKey": "grandTranquilScene",
      "itemNameEn": "Grand Tranquil Scene",
      "itemNameJa": "壮大な静まる景色",
      "itemColor": "Green",
      "itemType": "Relic",
      "effects": [
        [
          {
            "id": 7034500,
            "key": "executorUnlockingCursedSwordRestoresHP",
            "name_en": "Executor Unlocking Cursed Sword Restores HP",
            "name_ja": "【執行者】呪剣解放時、HP回復"
          }
        ]
      ],
      "coordinates": [0, 0],
      "coordinatesByColor": [0, 0],
      "sortKey": 65350
    }
  ]
}

Output Fields

フィールド	説明
`id`	遺物の一意な ID
`itemId`	アイテム ID
`itemKey`	アイテムのキー名
`itemNameEn`	英語表示名
`itemNameJa`	日本語表示名
`itemColor`	色 (Red / Blue / Yellow / Green)
`itemType`	タイプ (Relic / DeepRelic / UniqueRelic)
`effects`	効果リスト (各効果は id / key / name_en / name_ja を含む)
`coordinates`	全体での座標 [row, column]
`coordinatesByColor`	色別での座標 [row, column]
`sortKey`	ソートキー (取得順序)
`unknown`	データ未収録のアイテム・効果を含む場合のみ `true`（該当する効果にも `unknown: true` が付き、名前は「未知の効果 (ID: …)」になる。アイテムが未収録の場合は `itemColor` / `itemType` / 座標が `null`）

unknownRelics (トップレベル) は unknown: true の遺物の件数。0 以外の場合はデータファイルがゲームの最新バージョンに未対応の可能性がある。

License

MIT License

画面のアイコンは Lucide（ISC License）を使用（web/lib/icons.js / gui/renderer/lib/icons.js、tools/icons/build_icons.py で生成）。

QR コードの生成に qrcode-generator（MIT License、lib/qrcode.LICENSE.txt）、読み取りに zxing-wasm（MIT License）と、その中の zxing-cpp（Apache License 2.0）を使用（web/lib/zxing/LICENSE.txt）。QR コードは株式会社デンソーウェーブの登録商標です。

Reference

このプロジェクトは以下のリポジトリおよび情報源を参考にしています:

nightreign-relic-browser - TypeScript implementation
ELDEN RING NIGHTREIGN 攻略 Wiki (kamikouryaku.net) - 遺物効果のカテゴリー分類、効果名称、備考情報

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
examples		examples
gui		gui
resources		resources
src		src
tests		tests
tools		tools
web		web
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
requirements.txt		requirements.txt

Latest commit

History

Folders and files

Repository files navigation

ERN_RelicForge

Folder Structure

Features

セーブファイル解析

遺物組み合わせ最適化

Web 版

GUI ビューアー (Electron / Web 共通)

高度な検索（インスペクター）

ビルド探索（GUI 内最適化）

効果カタログ

HTML エクスポート

エフェクトデータ

Requirements

Installation

Usage

CLI

遺物最適化ツール

効果指定ファイル

スコアリング

出力構造

Web 版 (GitHub Pages)

ファイルの読み込み方法

ブラウザ対応

技術的な違い (Electron 版 vs Web 版)

Electron GUI

基本操作

フィルター・検索

ビルド探索

効果カタログ

HTML エクスポート

詳細表示

Tests

Output Example

Output Fields

License

Reference

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages