Pompa

Pompy rozmieszczone na mapie: atakuj o stałych godzinach, utrzymaj je przez jakiś czas i zgarnij nagrodę. Z kolorowymi markerami dla każdego stanu, strefą, ogłoszeniem dla wszystkich i paskiem postępu. Wszystko ustawiasz w configu, cooldowny skrypt zapisuje sam.

Funkcje

• Cztery stany z własnym kolorem markera (RGB) i blipa (kolor blipa GTA):
• Do ataku (zielony): E uruchamia Pompę.
• Atakowana (czerwony): właśnie trwa tu Pompa.
• Cooldown (pomarańczowy): po przejęciu lub przerwaniu, pozostały czas widać w podpowiedzi.
• Poza godzinami (biały): uruchomić można tylko w ustawionych godzinach.
• Strefa: Każda Pompa ma własny promień. Atakujący musi w niej zostać. Jeśli opuści strefę, ma kilka sekund na powrót (returnTime, domyślnie 5), inaczej Pompa zostaje przerwana. Gracze w pobliżu widzą strefę jako kulę, na mapie jest blip promienia.
• Czas przejęcia i cooldown: W minutach, taki sam dla wszystkich Pomp. Na dole ekranu widać pasek postępu z pozostałym czasem i procentami.
• Ogłoszenie dla wszystkich przy starcie, przejęciu i przerwaniu jako baner w designie skryptu. Przy banner = false idzie zamiast tego przez funkcję Announce w config/functions.lua, gdzie podpinasz własny skrypt ogłoszeń.
• Nagroda taka sama dla wszystkich Pomp: pieniądze (gotówka, bank, brudne pieniądze), itemy i bronie, także w losowej ilości.
• Tylko jedna Pompa naraz. Jeśli atakujący zginie lub wyjdzie z serwera, Pompa zostaje przerwana.
• Blipy włączone lub wyłączone, główny blip na środku każdej Pompy w kolorze jej stanu.
• Cooldowny zostają po restarcie serwera.
• Logi Discord dla startu, przejęcia i przerwania.

Instalacja

1. Wrzuć folder off_pompa do resources.
2. Dodaj do server.cfg po oxmysql i ESX:

set onesync on

ensure oxmysql
ensure es_extended
ensure off_pompa

1. Wpisz swoje Pompy z pozycją w config/settings/config.pompas.lua, nagrodę w config/settings/config.lua.

Tabela off_pompa_cooldowns tworzy się automatycznie. Itemy i bronie z nagrody muszą istnieć w ESX, nieznane zgłasza konsola serwera przy starcie.

Konfiguracja

config/settings/config.lua

Nagroda, dotyczy każdej Pompy:

rewards = {
  { type = 'account', name = 'black_money', amount = { 20000, 30000 } },  -- losowo pomiędzy
  { type = 'item',    name = 'lockpick',    amount = 3 },
  { type = 'weapon',  name = 'WEAPON_PISTOL', ammo = 60 },
},

config/settings/config.pompas.lua

Każda Pompa to wpis z pozycją i promieniem strefy.

{
  id = 'hafen',                           -- stała nazwa, nie zmieniaj jej później
  label = 'Hafen',
  position = vec3(1003.6, -3108.6, 5.9),
  radius = 45.0,                          -- strefa w metrach
},

config/functions.lua

Tutaj podłączasz własne skrypty. Błędy w nich trafiają do konsoli, skrypt działa dalej.

Przykład: uruchamianie tylko przy co najmniej 2 policjantach na służbie i nie dla samej policji.

function ServerCanStart(source, pompa)
  local xPlayer = ESX.GetPlayerFromId(source);

  if xPlayer.getJob().name == 'police' then
    return false, 'Als Polizist kannst du kein Pompa starten.';
  end

  if #ESX.GetExtendedPlayers('job', 'police') < 2 then
    return false, 'Es sind zu wenige Polizisten im Dienst.';
  end

  return true;
end

Przykład: własny skrypt ogłoszeń zamiast notify, bez ogłoszenia przy przerwaniu.
Przykład: własny skrypt ogłoszeń zamiast banera (banner = false), bez ogłoszenia przy przerwaniu.

function Announce(message, kind, pompa)
  if kind == 'aborted' then
    return;
  end

  TriggerClientEvent('dein_announce:show', -1, 'Pompa', message);
end

config/settings/config.server.lua i języki

Webhook Discord pompa dla startu, przejęcia i przerwania, url = '' wyłącza log. Wszystkie teksty są w config/locales/ (jeden plik na język).

W grze

• Marker: Każda Pompa ma marker w kolorze swojego stanu. Przy markerze widać, co jest teraz możliwe: start, cooldown z pozostałym czasem lub godziny.
• Start: Naciśnij E przy zielonym markerze. Wszyscy dostają ogłoszenie, a ty widzisz na dole pasek postępu.
• Strefa: Wokół Pompy pojawia się kula (dla wszystkich w pobliżu), a na mapie blip promienia. Jeśli wyjdziesz, pasek postępu pokaże odliczanie. Jeśli nie wrócisz po returnTime sekundach, Pompa zostanie przerwana.
• Przejęcie: Gdy czas minie, dostajesz nagrodę, a Pompa przechodzi w cooldown. Potem znowu można ją atakować.
• Przerwanie: Opuszczenie strefy, śmierć lub wyjście z serwera. Także wtedy Pompa przechodzi w cooldown.
• Zawsze trwa tylko jedna Pompa. Liczy się godzina serwera. Pompa uruchomiona tuż przed końcem godzin trwa do końca.

Dla deweloperów

-- Serwer
local active = exports.off_pompa:GetActive()          -- nil, gdy żadna nie trwa
local state = exports.off_pompa:GetState('hafen')      -- 'attackable', 'attacking', 'cooldown' lub 'closed'
local attacking = exports.off_pompa:IsAttacking(source)
exports.off_pompa:Abort()                              -- przerwij trwającą Pompę
exports.off_pompa:ResetCooldown('hafen')               -- natychmiast zakończ cooldown

-- Klient
local state = exports.off_pompa:GetState('hafen')
local attacking = exports.off_pompa:IsAttacking()

Częste problemy

Przy starcie skrypt zgłasza błędy i wskazówki w konsoli serwera.