Ratusz Molo

Wymagania

• Ostatnie artefakty FiveM

• Streaming włączony

• fxmanifest.lua z lua54 'yes'

• Opcjonalnie: ox_lib, ox_inventory, system drzwi/celownika (ox_doorlock, ox_target lub jego odpowiednik)

Zainstaluj (krok po kroku)

1. Dodaj zasób
   resources/[maps]/gov_observatory/

2. fxmanifest.lua

   fx_version 'cerulean'
   game 'gta5'
   lua54 'yes'

   name 'gov_observatory'
   description 'Galileo Observatory Government & Courthouse MLO'
   version '1.0.0'

   files {
   'stream/**/*.ytyp',
   'stream/**/*.ydr',
   'stream/**/*.ybn',
   'stream/**/*.ymap',
   'audio/**' -- TODO: only if package includes custom AWC/REL data
   }

   -- Map assets
   data_file 'DLC_ITYP_REQUEST' 'stream/gov_props.ytyp' -- TODO: replace with actual filenames

   -- Audio (only if provided by the package)
-- data_file 'AUDIO_WAVEPACK' 'audio/sfx' -- TODO: confirm path
-- data_file 'AUDIO_GAMEDATA' 'audio/sfx_game.dat' -- TODO: confirm file


   Zastępować gov_props.ytyp oraz wszelkie ścieżki audio z rzeczywisty pliki w Twoim pobraniu.

3. server.cfg

   ensure gov_observatory


4. Zrestartuj serwer lub refresh → ensure gov_observatory.

Framework integration (ESX / QBCore / QBOX / Standalone)

Role i uprawnienia (zalecenie)

• PD: cela, drzwi dowodowe, boczne wejście do sądu

• Sędzia: ławki, komory, pomieszczenie z sejfem

• Rząd/Burmistrz: biuro gubernatora, sala konferencyjna, sejf

• Sekretarz: recepcja, rejestracja, kontrola sali głosowań

• Publiczny: hala, muzeum

Użyj zamka w drzwiach, aby zablokować job/grade. Utrzymuj otwarte trasy publiczne, aby uniknąć tłoku.

ESX

• Drzwi bramy przez job = 'police' | 'judge' | 'government' | 'clerk'.

• Skrytki z ox_inventory: dowody (strona celi), pomieszczenie bezpieczne (odczyt/zapis według stopnia).

• DO ZROBIENIA: Dodaj wpisy konfiguracji zamków drzwi (współrzędne, hashe drzwi) i identyfikatory skrytek.

QBCore

• Lustro z ambulance/police/government lub twoje niestandardowe prace.

• qb-target/ox_target strefy: budka do głosowania, mównica, biurko urzędnika.

• DO ZROBIENIA: Dodaj współrzędne stref i etykiety; powiąż ze swoim zdarzenia client/server.

QBOX (qbx_core)

• Używać qbx_core uprawnienia/grupy.

• Stopnie mapy → bezpieczne drzwi (sędzia/rząd).

• DO ZROBIENIA: Wstaw nazwy swoich eksportów/wywołań zwrotnych, zgodnie z implementacją w twoim mieście.

Standalone (bez frameworka)

• Używać ACE dla minimalnego blokowania:

  add_ace group.judge gov.court.access allow
add_ace group.gov gov.exec.access allow
add_ace group.pd gov.cell.access allow
add_principal identifier.fivem:XXXX group.judge


• DO ZROBIENIA: Powiąż kontrole ACE w swoim skrypcie drzwi/celu, jeśli jest obsługiwany.

NUI i interakcje (opcjonalnie)

• Pokój głosowań: NUI głosowanie UI → publikuj wyniki przez serwer RPC; zapisz do bazy danych.

  • DO ZROBIENIA: Zaimplementuj swój schemat głosowania i mechanizmy zapobiegające duplikatom.

• Sala sądowa: Rozpocznij/zatrzymaj sesję, przełącznik dźwięku młotka, monit o przysięgę świadka.

  • DO ZROBIENIA: Podłącz do nazw swoich zdarzeń; nie wymyślaj punktów końcowych.

• Recepcja: Menu kontekstowe (zameldowanie → kierowanie sprawy → sala sądowa).

  • Używać ox_lib dla prostych przepływów kontekstu/NUI.

Dane i skrytki (ox_inventory)

• Pokój Bezpieczeństwa: ograniczony schowek na zapieczętowane dokumenty.

• Skarbiec dowodów (cela): PD pisze, protokolant czyta.

• Muzeum: opcjonalne metadane wystawy tylko do odczytu (bez elementów).

• DO ZROBIENIA: Zarejestruj skrytki z pozycjami, limitami i uprawnieniami zgodnie z konfiguracją ekwipunku.

Pojazdy i dostęp

• Brak strumieniowania garaży. Zachowaj parking nieograniczony na zewnątrz, wejścia wolne dla eskorty PD.

• Jeśli używasz skryptu floty rządowej, umieść punkty odradzania przy zewnętrznych schodach.

• DO ZROBIENIA: Dodaj współrzędne/kierunki odradzania w swoim zasobie garażu (ESX/QB/QBOX).

Anty-cheat i bezpieczeństwo

• Strumieniowane rekwizyty/drzwi mogą wywoływać niektóre anty-cheaty. Dodaj nazwę zasobu do białej listy, jeśli jest to potrzebne.

• Uprawomocnić po stronie serwera: głosowania, czynności sądowe, zmiany stanu drzwi.

• Nie ufaj kontrolom tylko po stronie klienta. Użyj exports/callbacks z upoważnieniem strażników.

Optymalizacja (resmon)

Cel ≤ 0,05 ms czas bezczynności klienta dla tego MLO.

Lista kontrolna:

1. /resmon 1 w mieście; bezczynnie w Korytarz, Sąd, Pokój Głosowań.

2. Przechodź przez obszary z dużą ilością rekwizytów (wystawy muzealne). Uważaj na skoki.

3. Jeśli kolce:

   • Wyłącz opcjonalne zaśmiecające mapy (jeśli są dostępne). DO ZROBIENIA: przełącz nazwy zestawów na pakiet.

   • Zmniejsz strefy docelowe; połącz sąsiednie interaktywne obiekty.

   • Unikaj ciężkich pętli w kliencie Lua; debounce SFX drzwi.

Synchronizacja i stabilność

• Stany drzwi muszą synchronizować się w całym serwerze; użyj autorytetu serwera swojego zamka do drzwi.

• Okluzja dźwięku zweryfikowana dla każdego pomieszczenia; testuj z otwartymi/zamkniętymi drzwiami.

• Ścieżki konwojów policyjnych przetestowane pod kątem eskort; potwierdź brak kolizji na zakrętach.

• Głos: sprawdź strefy pma-voice/mumble w sali sądowej, aby galeria mogła słyszeć sędziów bez echa. DO ZROBIENIA: dodaj własną konfigurację strefy.

Szybki skrypt testowy (co zweryfikować)

1. Publiczne odradzanie przy Przyjęcie.

2. Sędzia otwiera Ławka drzwi (ograniczone stopniem).

3. Eskorty PD do Komórka; zapis do schowka na dowody działa.

4. Rozpoczyna się urzędnik Głosowanie; jeden głos na obywatela (sprawdzenie danych gracza).

5. Blokady gubernatora Pokój Bezpieczeństwa; odmowa dla nie-rządowych.

6. Uruchom resmon; potwierdź docelowy budżet.