Svi radovi

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

Snimak ekrana uskoro

Formular za podnošenje naloga, popunjen test podacima.

assets/projects/justice-system/warrant-form.webp (usko isečeno na panel)

Podnošenje naloga: optužbe po broju tačaka, plus link ka pratećem dokumentu.

Snimak ekrana uskoro

Lista aktivnih naloga, sa podelom na stranice.

assets/projects/justice-system/warrant-list.webp (usko isečeno na panel)

Aktivni nalozi, stranicu po stranicu.

Snimak ekrana uskoro

Poruka na pejdžeru u igri koju dobija traženi lik.

assets/projects/justice-system/pager.webp (usko isečeno)

Tražena osoba dobija poruku na pejdžer.

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)

Discord feed policijskog tima.

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)

Od podnošenja naloga do hapšenja.
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)
Preuzeto iz produkcionog koda, malo dorađeno radi čitljivosti.

Hapšenje i zatvor

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)

Od hapšenja do ćelije.

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)

Izricanje kazne kod NPC-a za hapšenje.

Snimak ekrana uskoro

Početni ekran policijskog računara.

assets/projects/justice-system/police-computer.png (usko isečeno na ekran)

Policijski računar.

Snimak ekrana uskoro

Vladin računar, na ekranu sa evidencijom.

assets/projects/justice-system/government-computer.png (usko isečeno na ekran)

Vladin računar.

Teška krivična dela i evidencija

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)

Evidencija sa statusom teškog krivičnog dela (prazni redovi su isečeni sa snimka).

Snimak ekrana uskoro

Lična karta koja prikazuje status prestupnika.

assets/projects/justice-system/id-card-felon.webp (usko isečeno)

Status prestupnika na ličnoj karti.

Žalbe i pristanak

Probajte sami: gledate evidenciju Jane Doe. Falsifikujte zahtev da se skine optužba za ubistvo sa Vita Morettija, prvo kod servera koji veruje zahtevu, a zatim kod verzije koja je zaista puštena u rad. Izmišljeni likovi; simulacija ideje, ne kod sa servera.
-- 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)
Preuzeto iz produkcionog koda, malo dorađeno radi čitljivosti.