Murphy's Telegram & Mail은 전보, 편지, 아이템 소포, 직업 우편함, 서버 측 보안을 갖춘 완전한 우체국 시스템을 RedM에 추가합니다.
전보, 편지 및 아이템 배송
플레이어는 모든 우체국 NPC를 통해 두 가지 유형의 우편을 보낼 수 있습니다. 전보는 120자로 제한되며 무작위로 선택되는 손글씨 글꼴과 글자당 동적 가격을 사용합니다. 편지는 최대 10,000자를 지원하고, 발신자가 손글씨, 필기체, 타자기 글꼴 중에서 선택할 수 있으며, 설정 가능한 무게 제한까지 인벤토리 아이템을 첨부할 수 있습니다. 현실적인 우편 경험을 위해 두 유형 모두에 설정 가능한 배송 지연이 적용됩니다.
편지지, 템플릿 및 연락처
각 우편물은 배경, 머리글, 도장, 테두리를 갖춘 커스텀 템플릿에 표시됩니다. 템플릿을 직업별로 제한하여 보안관, 의사, 시장 또는 설정된 모든 역할에 전용 공식 편지지를 제공할 수 있습니다. 새로운 디자인은 코드를 변경하지 않고 PNG만 교체하면 추가할 수 있습니다. 각 캐릭터는 즐겨찾기와 한 번의 클릭으로 수신자를 채우는 기능을 갖춘 영구 연락처 목록을 유지합니다.
우체국, 직업 우편함 및 가격
- 설정 가능한 NPC 직원: 각 우체국 위치는 커스텀 ped 모델, 의상, 주변 대화를 지원하고 3D 상호작용 대상을 위해
murphy_interact와 연동됩니다. - 직업 기반 우편함: "Rhodes 보안관"과 같은 공유 우편함은 해당 직업을 가진 모든 플레이어가 이용할 수 있고 우편을 개인이 아닌 역할에 보냅니다. 원자적 수령 시스템이 중복 수령을 방지합니다.
- 동적 가격: 전보는 기본 가격과 글자당 비용을 사용하고, 편지 소포는 기본 가격과 아이템당 비용을 사용합니다. 모든 가격은 서버 측에서 다시 계산되어 클라이언트 측 조작을 제거합니다.
- 외부 API: export와 이벤트를 사용하면 모든 리소스가 세금 청구서, 직업 제안, 퀘스트 보상, 은행 명세서, 관리자 공지 등을 프로그래밍 방식으로 보낼 수 있습니다. 완전한 API 문서와 함께 즉시 사용할 수 있는 연동 예제 10개가 포함됩니다.
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 없이 처음 시작할 때 데이터베이스 테이블이 생성됩니다.
설정 및 포함 내용
가격, 글자 수 제한, 배송 지연, 소포 제한, 속도 제한, 만료 기준, 우체국 위치, NPC 모델과 의상, 우편함, 템플릿, 글꼴, UI 언어를 포함한 시스템의 모든 요소를 하나의 config.lua에서 제어합니다. 영어와 프랑스어 현지화가 기본으로 포함됩니다.
패키지 구성:
- Vite와 React로 제작되었으며 완전히 커스터마이징 가능한 UI 소스 코드.
- README, API 문서, 템플릿 가이드, 직원 테스트 체크리스트를 포함한 완전한 문서.
- 시작할 때 자동으로 생성되는 SQL 스키마.
- 일반적인 서버 활용 사례를 다루는 연동 예제 10개.
요구 사항
- oxmysql
- murphy_interact (별도 포함)
- 지원되는 framework 하나: REDEMRP, RSG-Core 또는 VORP

