U produkciji
Nalozi za hapšenje i krivično pravosuđe
Povezan pravosudni sistem za policijsku roleplay zajednicu: nalozi za hapšenje, kaznena evidencija, teška krivična dela, kaucija i žalbe, uz provere na serveru za svaku akciju.
- Uloga
- Dizajn i implementacija
- Tehnologije
- Lua (GLua), MySQL, Discord webhookovi
- Kontekst
- Policijski i kriminalni roleplay na Diverge Networks
- Status
- U produkciji: teška krivična dela, zatvor i kaucija od 2025, nalozi za hapšenje od 2026.
Snimci ekrana i klipovi na ovoj stranici: snimljeni na razvojnom serveru, sa test likovima i nameštenim podacima.
Problem
Policijski roleplay stoji i pada na papirologiji. Serveru su bili potrebni nalozi koje policajci mogu da podnesu i sprovedu, evidencija koja drži vodu i posledice koje se prenose kroz celu igru, a sve to bez poverenja u bilo šta što igračev klijent pošalje.
Nalozi za hapšenje
- Policajci podnose, pretražuju i vode naloge preko policijskog računara u igri, sa listama aktivnih naloga podeljenim na stranice.
- Svaka akcija proverava dozvole po činu na serveru, uključujući pristup za vladine uloge, a zahtevi ka bazi su ograničeni po igraču.
- Poslate tačke optužnice server ponovo sklapa prema pravoj listi optužbi, uz ograničenje od deset tačaka po nalogu.
- Link ka pratećem dokumentu mora da počinje očekivanim domenom, uključujući kosu crtu na kraju, pa se domeni koji samo liče na pravi odbijaju.
- Jedan aktivan nalog po osobi. Da bi se nalog sproveo, osumnjičeni mora da bude u lisicama, sputan i u zoni zatvora, a server pre zatvaranja naloga ponovo proverava da nalog zaista glasi na njega.
- Izdavanje, povlačenje i sprovođenje naloga svako okida svoj event. Poruka na pejdžer traženoj osobi, objava na Discordu za policijski tim i oznaka „tražen“ u igri su odvojeni listeneri, pa nijedan ne može da obori ostale.
- Discord webhook se postavlja u toku rada, admin komandom ograničenom po činu, i nikad se ne čuva u kodu.
- Provera tablica, plus ukradene tablice koje mogu da se stave na ukradena vozila i ističu posle 30 minuta.
Snimak ekrana uskoro
Formular za podnošenje naloga, popunjen test podacima.
assets/projects/justice-system/warrant-form.webp (usko isečeno na panel)
Snimak ekrana uskoro
Lista aktivnih naloga, sa podelom na stranice.
assets/projects/justice-system/warrant-list.webp (usko isečeno na panel)
Snimak ekrana uskoro
Poruka na pejdžeru u igri koju dobija traženi lik.
assets/projects/justice-system/pager.webp (usko isečeno)
Snimak ekrana uskoro
Objava na Discordu za novi nalog, sa zamućenim imenima servera i kanala.
assets/projects/justice-system/discord-embed.webp (isečeno samo na poruku)
Video (opciono) uskoro
Podnošenje naloga, nalog koji se pojavljuje na listi, a zatim hapšenje osumnjičenog preko kontekstnog menija.
assets/projects/justice-system/warrant-arrest.mp4 (20 do 30 sekundi)
net.Receive("WarrantsDatabase.IssueWarrant", function(_, ply)
-- Permission first, before anything is read from the request.
if (not PLUGIN:CanIssueWarrant(ply)) then return end -- rank-based, checked on the server
-- One database request per second per player.
if (ply.lastWarrantDBQuery and ply.lastWarrantDBQuery > SysTime() - 1) then
ply:notify("You must wait 1 second before querying the warrants database again.")
return
end
ply.lastWarrantDBQuery = SysTime()
local charID = net.ReadUInt(32)
local requested = pon.decode(net.ReadString())
local documentLink = net.ReadString()
-- Rebuild the charges against the server's own charge list.
-- Unknown charge IDs and non-numbers are rejected outright.
local allCharges = nut.plugin.list.police:GetCharges()
local charges, total = {}, 0
for chargeID, count in pairs(requested) do
assert(isnumber(count), "charge count is not a number")
assert(allCharges[chargeID], "not a valid charge ID")
if (count > 0) then
charges[chargeID] = count
total = total + count
end
end
if (total > 10) then
ply:notify("You cannot submit a warrant with more than a total of 10 charges.")
return
end
-- The trailing slash matters: it rejects lookalikes such as docs.google.com.evil.example
if (not documentLink:StartsWith("https://docs.google.com/")) then
ply:notify("Invalid Google Docs link.")
return
end
-- One active warrant per person.
nut.db.preparedCallDeferred("warrantsGetActiveByWantedCharID", charID):next(function(res)
if (res.results and res.results[1]) then
ply:notify("A warrant has already been issued for this individual.")
return
end
-- ... look up the wanted character's name, then issue the warrant (omitted)
end)
end)Hapšenje i zatvor
- Policajci sa osumnjičenim rade preko kontekstnog menija: stavljaju mu lisice, sputavaju ga i, kad su u stanici, na licu mesta otvaraju njegovu kaznenu evidenciju.
- Lisice preživljavaju diskonekt. Izlogovanje je ranije bio besplatan izlaz; sada lisice ostaju na tom liku dok ih neko ne skine ili ne obije.
- NPC za hapšenje navodi svaku optužbu sa članom zakona i maksimalnom kaznom, prikazuje teorijski maksimum i daje policajcima izbor: da osobu pošalju da čeka suđenje ili da je osude na osnovu sporazuma o priznanju krivice, pri čemu klizač za kaznu ostaje u dozvoljenim granicama.
- Na šalteru igrači mogu da provere svoju evidenciju, a kauciju je moguće platiti i za nekog drugog.
- Kaucija. Zatvorenici mogu da odbiju da ih neko otkupi kaucijom, čime je prestalo korišćenje kaucije za izvlačenje ljudi iz zatvora protiv njihove volje.
- Prvobitna ljuska policijskog računara postojala je pre mene; svaki ekran i svako dugme u njemu od tada su moji. Vladin računar, napravljen na osnovu njega, u potpunosti je moj. Zatvorski sistem ispod svega toga započeo sam godinama ranije i ovde ga izgradio iznova.
Video uskoro
Stavljanje lisica osumnjičenom, provera njegove evidencije iz kontekstnog menija, a zatim izricanje kazne kod NPC-a za hapšenje.
assets/projects/justice-system/arrest-to-cell.mp4 (20 do 30 sekundi)
Snimak ekrana uskoro
NPC za hapšenje sa optužbama, teorijskim maksimumom i klizačem za kaznu, samo test podaci.
assets/projects/justice-system/arrest-npc.png (usko isečeno na panel)
Snimak ekrana uskoro
Početni ekran policijskog računara.
assets/projects/justice-system/police-computer.png (usko isečeno na ekran)
Snimak ekrana uskoro
Vladin računar, na ekranu sa evidencijom.
assets/projects/justice-system/government-computer.png (usko isečeno na ekran)
Teška krivična dela i evidencija
- Svaka optužba za teško krivično delo označava lika kao prestupnika.
- Status prestupnika se vidi na ličnim kartama u igri.
- Prodavnice mogu svaki artikal da ograniče na sve, samo na prestupnike ili samo na one koji to nisu, a server to sprovodi u trenutku kupovine.
- Staff vodi listu optužbi u igri, a svaka optužba se validira prema fiksnoj šemi.
- Upravljanje evidencijom je prepisano da radi na novom sistemu podataka, uključujući i likove koji nisu online.
Snimak ekrana uskoro
Kaznena evidencija sa vidljivom oznakom teškog krivičnog dela.
assets/projects/justice-system/record-felony.webp (usko isečeno na panel)
Snimak ekrana uskoro
Lična karta koja prikazuje status prestupnika.
assets/projects/justice-system/id-card-felon.webp (usko isečeno)
Žalbe i pristanak
- Žalbe. Vladini likovi mogu da skinu status teškog krivičnog dela, ali samo sa zapisa koje im je server prikazao. Server pamti listu ID-jeva zapisa koje je poslao svakom igraču i odbija sve ostalo, pa izmena ID-ja u zahtevu ne postiže ništa.
- Pristanak. Trajna smrt lika kao alternativa zatvorskoj kazni zahteva pristanak igrača u zadatom roku. Ako odbije, umesto toga ide na suđenje, a diskonektovanjem ne može da izbegne odluku.
-- When a government character opens someone's record, the server remembers
-- exactly which record IDs it sent to that player, and whose they were.
nut.getCharDataOffline(citizenID, nil, {}, function(charData)
ply.allowedSetRecords = {}
if (charData.jailed) then
ply.allowedSetRecords[0] = { CharID = citizenID } -- 0 = the current sentence
end
for recordID in pairs(charData.jailRapSheet or {}) do
ply.allowedSetRecords[recordID] = { CharID = citizenID }
end
-- ... send the records to the player (omitted)
end)
-- The appeal itself. The client sends a record ID and the new felony status,
-- but never whose record it is: that comes from the server's own list.
net.Receive("GovtManageRecordsSetIsFelony", function(_, ply)
local char = ply:getChar()
if (not char) then return end
if (not nut.faction.indices[char:getFaction()].NYC or not char:getData("allowAppeals")) then return end
if (ply.lastFelonySet and ply.lastFelonySet > SysTime() - 1) then
ply:notify("You must wait 1 second before setting another felony.")
return
end
ply.lastFelonySet = SysTime()
local isFelony = net.ReadBool()
local recordID = net.ReadUInt(32)
-- Anything the server didn't send this player is rejected.
local record = ply.allowedSetRecords and ply.allowedSetRecords[recordID]
if (not record) then return end
nut.getCharDataOffline(record.CharID, nil, {}, function(charData)
local key = (recordID == 0) and "jailed" or "jailRapSheet"
local data = charData and table.Copy(charData[key])
local entry = data and ((recordID == 0) and data or data[recordID])
if (not entry) then
ply:notify("Something went wrong - contact a developer.")
return
end
entry.Felony = isFelony
nut.setCharData(record.CharID, key, data, function()
ply:notify("Successfully updated felony status for selected record.")
-- ... refresh the player's view and log the change to Discord (omitted)
end)
end)
end)