Config

Feathered Friend には 2 つの構成レイヤーがあります。

• クライアント構成 (featheredfriend-client.toml): UI とローカル設定の動作。
• サーバー設定 (featheredfriend-server.toml): クライアントに同期されたゲームプレイ権限の値。

一般的な開発では次のように実行します。

• neoforge/run/config/featheredfriend-client.toml
• neoforge/run/config/featheredfriend-server.toml

同期パイプライン

1. クライアントは設定を要求します (RequestServerSettingsPayload)。
2. サーバーは完全なスナップショット (ServerSettingsPayload) を送信します。
3. サーバーはログイン時に設定もプッシュします。
4. サーバー ティック ウォッチャーは、構成の変更と再ブロードキャストをチェックします。

したがって、TOML ホットリロードとゲーム内設定からの編集は両方とも、接続されているクライアントに伝播されます。

ホットリロードの動作

FFServerConfig のサーバー構成値は実行時の値です。

FFConfigSyncEvents は値を監視し、値が変更された場合は再ブロードキャストします。以下のものが含まれます。

• 機能切り替え (enableSuspiciousFeather、enableSuspiciousChest、enableRavenArmor、enableMailbox)
• 制限/クールダウン
• チャットトグル

ravenLinkDurationSeconds はアクティブなセッション中に再読み取りされるため、現在のリンクは構成変更の直後に短縮/延長される可能性があります。

ゲーム内設定の権限

カスタム設定 GUI は、open_settings キーバインドを介して開きます (デフォルトではバインドされていません)。

サーバー側の編集は、両方が true の場合にのみ許可されます。

• allowServerSettingsScreenEditing = true
• プレイヤーはオペレーター権限レベル 4 を持っています

それ以外の場合、クライアントは同期された値を表示できますが、サーバー設定の編集を適用できません。

クライアント構成 (ローカルのみ)

クライアント構成は、以下を含むローカル UI/設定のみを制御します。

• scrollUiFontMode (VANILLA、JACQUARD、ALAGARD)
• レイブンステータスバッジの位置/アンカー/ビジュアルモード
• お気に入りの印鑑キー
• raven ログの表示設定 (カテゴリの表示/色)

これらはサーバーのゲームプレイを変更しません。

サーバー設定 (ゲームプレイ権限)

settings セクション

spawning セクション

機能の切り替えがオフの場合

機能の切り替えにより、アイテム/ブロックの存在ではなく、ロジックが無効になります。

• 既存のアイテム/ブロックは残ります
• 在庫は引き続きアクセス可能です
• 機能固有のランタイム システムはスキップされます

例:

• enableMailbox=false: メールボックス ストレージはまだ開いていますが、スポッティング/ルーティングは無効になっています。
• enableSuspiciousChest=false: チェストストレージは引き続き機能しますが、止まり木/預金ロジックは無効になっています。
• enableSuspiciousFeather=false: Raven Link の開始/復活パスが無効になっています。

サーバーのスナップショットの例

{
  "settings": {
    "ravenChestsPerPlayer": 3,
    "enderpackDepositCooldownSeconds": 600,
    "scrollDeliveryCooldownSeconds": 600,
    "ravenLinkDurationSeconds": 30,
    "allowServerSettingsScreenEditing": true,
    "features": {
      "enableSuspiciousFeather": true,
      "enableSuspiciousChest": true,
      "enableRavenArmor": true,
      "enableMailbox": true
    }
  },
  "spawning": {
    "wildRavensPerPlayer": 1
  }
}