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
