Murphy's Telegram & Mail dodaje do RedM pełny system urzędu pocztowego z telegramami, listami, paczkami przedmiotów, skrzynkami zawodów i zabezpieczeniami serwera.
Telegramy, listy i dostarczanie przedmiotów
Gracze mogą wysyłać dwa różne rodzaje poczty przez dowolnego NPC urzędu pocztowego. Telegramy mają limit 120 znaków i korzystają z dynamicznej ceny za znak oraz losowo wybieranych czcionek odręcznych. Listy obsługują do 10 000 znaków, pozwalają nadawcy wybrać czcionkę odręczną, kursywę lub maszynopis i mogą zawierać dołączone przedmioty z ekwipunku do konfigurowalnego limitu wagi. Do obu rodzajów przesyłek stosowane są konfigurowalne opóźnienia dostawy, aby zapewnić realistyczne wrażenie działania poczty.
Papeteria, szablony i kontakty
Każda przesyłka jest wyświetlana na indywidualnym szablonie z tłem, nagłówkiem, pieczęcią i obramowaniem. Szablony można ograniczać według zawodu, dzięki czemu szeryfowie, lekarze, burmistrzowie lub dowolna skonfigurowana rola mają własną oficjalną papeterię. Dodanie nowego projektu wymaga tylko wymiany pliku PNG, bez zmian w kodzie. Każda postać zachowuje trwałą listę kontaktów z ulubionymi i automatycznym uzupełnianiem odbiorcy jednym kliknięciem.
Urzędy pocztowe, skrzynki zawodów i ceny
- Konfigurowalni pracownicy NPC: każda lokalizacja urzędu pocztowego obsługuje niestandardowe modele pedów, stroje i dialogi otoczenia, zintegrowane z
murphy_interactdla celów interakcji 3D. - Skrzynki oparte na zawodach: wspólne skrzynki, takie jak „Szeryf Rhodes”, są dostępne dla każdego gracza z odpowiednim zawodem i kierują pocztę do roli zamiast do osoby. Atomowy system odbioru zapobiega podwójnemu odbieraniu przesyłek.
- Dynamiczne ceny: telegramy używają ceny bazowej i kosztu za znak; paczki listowe używają ceny bazowej i kosztu za przedmiot. Wszystkie ceny są ponownie obliczane po stronie serwera, co eliminuje manipulacje po stronie klienta.
- Zewnętrzne API: eksporty i zdarzenia pozwalają dowolnemu zasobowi programowo wysyłać pocztę, w tym rachunki podatkowe, oferty pracy, nagrody za zadania, wyciągi bankowe i ogłoszenia administracyjne. Dołączono dziesięć gotowych przykładów integracji wraz z pełną dokumentacją API.
Obsługa frameworków
Murphy's Telegram & Mail działa od razu z trzema frameworkami dzięki architekturze opartej na adapterach, która izoluje cały kod specyficzny dla frameworka w plikach adapterów.
| Framework | Ekwipunek | Powiadomienia |
|---|---|---|
| REDEMRP | redemrp_inventory | murphy_notify |
| RSG-Core | rsg-inventory | ox_lib |
| VORP | VorpInv | VORP core |
Bezpieczeństwo i wydajność
- Walidacja po stronie serwera: wszystkie ceny, długości pól, typy przedmiotów i dostęp zawodowy są sprawdzane na serwerze.
- Parametryzowane zapytania SQL: brak podatności na wstrzyknięcia.
- Atomowe operacje bazy danych: brak zduplikowanych dostaw i wyścigów.
- Ograniczenie częstotliwości: konfigurowalny czas odnowienia między wysłaniami.
- Automatyczne czyszczenie: wygasłe dokumenty i wpisy skrzynki odbiorczej są usuwane automatycznie.
- Automatyczna migracja: tabele bazy danych są tworzone przy pierwszym uruchomieniu bez potrzeby ręcznego SQL.
Konfiguracja i zawartość pakietu
Każdym aspektem systemu steruje jeden plik config.lua, obejmujący ceny, limity znaków, opóźnienia dostawy, ograniczenia paczek, limity częstotliwości, progi wygaśnięcia, lokalizacje urzędów pocztowych, modele i stroje NPC, skrzynki, szablony, czcionki i język interfejsu. Domyślnie dołączono lokalizacje angielską i francuską.
Pakiet zawiera:
- Kod źródłowy interfejsu zbudowany w Vite i React, w pełni konfigurowalny.
- Pełną dokumentację, w tym README, dokumentację API, przewodnik po szablonach i listę kontrolną testów dla personelu.
- Schemat SQL tworzony automatycznie przy uruchomieniu.
- Dziesięć przykładów integracji obejmujących typowe zastosowania serwerowe.
Wymagania
- oxmysql
- murphy_interact (dołączony osobno)
- Jeden obsługiwany framework: REDEMRP, RSG-Core lub VORP






