Murphy's Telegram & Mail は、電報、手紙、アイテム小包、ジョブ用メールボックス、サーバー側セキュリティを備えた完全な郵便局システムを RedM に追加します。
電報、手紙、アイテム配送
プレイヤーは任意の郵便局 NPC を通じて、2 種類の郵便を送信できます。電報は 120 文字に制限され、ランダムに選択される手書きフォントと文字単位の動的価格設定を使用します。手紙は最大 10,000 文字に対応し、送信者が手書き、筆記体、タイプライターの各フォントから選択でき、設定可能な重量上限までインベントリアイテムを添付できます。リアルな郵便体験を実現するため、両方の種類に設定可能な配送遅延が適用されます。
便箋、テンプレート、連絡先
各郵便物は、背景、見出し、スタンプ、枠線を持つカスタムテンプレートに表示されます。テンプレートをジョブ別に制限し、保安官、医師、市長、その他の設定された役割に専用の公式便箋を用意できます。新しいデザインはコードを変更せず PNG を入れ替えるだけで追加できます。各キャラクターは、お気に入りとワンクリックでの宛先入力を備えた永続的な連絡先一覧を保持します。
郵便局、ジョブ用メールボックス、価格設定
- 設定可能な NPC 窓口係：各郵便局の場所は、カスタム ped モデル、衣装、環境会話に対応し、3D インタラクションターゲット用に
murphy_interactと連携します。 - ジョブに基づくメールボックス：「Rhodes の保安官」などの共有メールボックスは、該当するジョブを持つすべてのプレイヤーが利用でき、個人ではなく役割宛てに郵便を送ります。アトミックな受取システムが重複受取を防ぎます。
- 動的価格設定：電報は基本料金と文字単位の料金、手紙の小包は基本料金とアイテム単位の料金を使用します。すべての価格はサーバー側で再計算され、クライアント側の操作を排除します。
- 外部 API：export とイベントにより、税金請求書、求人、クエスト報酬、銀行取引明細、管理者告知などを任意のリソースからプログラムで郵送できます。完全な API ドキュメントとともに、すぐに使える 10 種類の連携例が含まれます。
Framework 対応
Murphy's Telegram & Mail は、framework 固有のコードをすべてアダプターファイルに分離するアダプター方式の設計により、3 つの framework ですぐに動作します。
| Framework | インベントリ | 通知 |
|---|---|---|
| REDEMRP | redemrp_inventory | murphy_notify |
| RSG-Core | rsg-inventory | ox_lib |
| VORP | VorpInv | VORP core |
セキュリティとパフォーマンス
- サーバー側検証：すべての価格、フィールド長、アイテム種別、ジョブアクセスをサーバーで確認します。
- パラメーター化 SQL クエリ：インジェクション脆弱性はありません。
- アトミックなデータベース操作：配送の重複や競合状態はありません。
- レート制限：送信間隔に設定可能なクールダウンを適用します。
- 自動クリーンアップ：期限切れ文書と受信箱の項目を自動的に削除します。
- 自動マイグレーション：手動 SQL を必要とせず、初回起動時にデータベーステーブルを作成します。
設定と同梱内容
価格設定、文字数制限、配送遅延、小包制限、レート制限、有効期限、郵便局の場所、NPC モデルと衣装、メールボックス、テンプレート、フォント、UI 言語を含むシステムのすべての要素を、1 つの config.lua から制御します。英語とフランス語のローカライズが標準で含まれます。
パッケージ内容：
- Vite と React で構築され、完全にカスタマイズ可能なUI ソースコード。
- README、API ドキュメント、テンプレートガイド、スタッフ用テストチェックリストを含む完全なドキュメント。
- 起動時に自動作成される SQL スキーマ。
- 一般的なサーバー利用例を網羅する10 種類の連携例。
要件
- oxmysql
- murphy_interact（別途同梱）
- 対応する framework のいずれか：REDEMRP、RSG-Core、VORP
