Murphy's Telegram & Mail 為 RedM 添加完整的郵局系統，包含電報、信件、物品包裹、職業郵箱和伺服器端安全保護。
電報、信件與物品配送
玩家可以透過任意郵局 NPC 發送兩種不同類型的郵件。電報限制為 120 個字符，采用按字符動态定價，並隨機選擇手寫字體。信件最多支援 10,000 個字符，允許發件人在手寫體、草書體和打字機字體之間選擇，並可附加庫存物品，最高不超過可配置的重量限制。兩種類型都采用可配置的配送延遲，以提供逼真的郵政體驗。
信紙、模板與聯系人
每封郵件都會顯示在具有背景、頁眉、印章和邊框的自定義模板上。模板可以按職業限制，讓警長、醫生、市長或任何已配置角色擁有自己的官方信紙。添加新設計只需更換 PNG，無需更改程式碼。每個角色都有持久聯系人列表，支援收藏以及一鍵填入收件人。
郵局、職業郵箱與定價
- 可配置的 NPC 櫃員：每個郵局地點都支援自定義 ped 模型、服裝和環境對話，並與
murphy_interact整合以提供 3D 交互目標。 - 基於職業的郵箱：“Rhodes 警長”等共享郵箱可由任何具有相應職業的玩家訪問，並將郵件發送給某個角色而非個人。原子化領取系統可防止重複領取。
- 動态定價：電報采用基礎價格加每字符費用；信件包裹采用基礎價格加每物品費用。所有價格都在伺服器端重新計算，杜絕客戶端操縱。
- 外部 API：export 和事件允許任意資源以編程方式發送郵件，包括稅單、工作邀請、任務獎勵、銀行對賬單和管理員公告。完整 API 文檔還附帶十個可直接使用的整合示例。
Framework 支援
Murphy's Telegram & Mail 透過基於適配器的架構開箱即用地支援三個 framework，所有 framework 專屬程式碼都隔離在適配器檔案中。
| Framework | 庫存 | 通知 |
|---|---|---|
| REDEMRP | redemrp_inventory | murphy_notify |
| RSG-Core | rsg-inventory | ox_lib |
| VORP | VorpInv | VORP core |
安全與性能
- 伺服器端驗證：所有價格、字段長度、物品類型和職業訪問權限均在伺服器端檢查。
- 參數化 SQL 查詢：不存在注入漏洞。
- 原子化資料庫操作：不會出現重複配送或競爭條件。
- 頻率限制：發送之間具有可配置的冷卻時間。
- 自動清理：過期文檔和收件箱條目會自動清除。
- 自動遷移：首次啟動時自動建立資料庫表，無需手動 SQL。
配置與包含内容
系統的所有方面均透過一個 config.lua 控制，包括定價、字符限制、配送延遲、包裹約束、頻率限制、過期閾值、郵局地點、NPC 模型和服裝、郵箱、模板、字體以及介面語言。預設包含英語和法語本地化。
該套件包含：
- 介面源程式碼，使用 Vite 和 React 構建，可完整自定義。
- 完整文檔，包括 README、API 文檔、模板指南和工作人員測試清單。
- SQL 架構，啟動時自動建立。
- 十個整合示例，涵蓋常見的伺服器用例。
要求
- oxmysql
- murphy_interact（單獨提供）
- 一個受支援的 framework：REDEMRP、RSG-Core 或 VORP
