Retroactive Import
遡及インポートにより、タイムラインは既存ワールドのプレイヤー進行ファイルからクロニクル エントリをバックフィルできます。
TLDR
- サーバーの起動時に 1 回実行されます (有効な場合)。
world/advancements/*.jsonをスキャンします。- インポートは完了しましたが、目に見える進歩はまだありません。
- オプションでレシピの進歩を含めることができます。
仕組み
サーバーの起動時:
- タイムラインはプレーヤーの進歩 JSON ファイルを見つけます。
- 各プレーヤー ファイルについて、完了した基準をチェックします。
- 一致する表示可能な進歩を解決します。
- インポートされたイベントを Chronicle SavedData に書き込みます。
- 何かがインポートされた場合は、更新されたクロニクルと殿堂をブロードキャストします。
二重安全性
インポートは (playerUuid,sourceId) ごとに冪等です。
- ペアが Chronicle データにすでに存在する場合、スキップされます
- 繰り返し起動しても、同じ履歴エントリが重複し続けることはありません
曜日マッピングモード
retroactiveAdvancementImportMapByRealDays は日付の配置を制御します。
true: 実測の完了経過時間をタイムラインの日のオフセットにマッピングします。false: インポートされたエントリを現在のタイムライン日に配置します
レシピの取り扱い
retroactiveAdvancementImportIncludeRecipes:
false(推奨):namespace:recipes/*を無視します。true: レシピの進歩が含まれます。これにより、多くのノイズが追加される可能性があります。
DEEP DIVE: 完了タイムスタンプのフォールバック
タイムラインは、基準要件グループから完了時間を計算しようとします。堅牢なタイムスタンプを取得できない場合は、インポートをより安全に継続するためにファイルの変更時刻にフォールバックします。
遡及インポートは起動パイプラインです。実行中に継続的に進捗ファイルを監視することはありません。
このプロジェクトを支援
このWikiとModが気に入りましたか？
ご支援いただくことで、機能開発、ドキュメント整備、アップデート継続の助けになります。