Svi radovi

U produkciji

Forenzika i mesta zločina

Detektivski sistem za policijski roleplay server: tela koja ostaju na mestu, dokazi koji izdrže i dosijei slučajeva koje detektivi mogu da pretražuju. Preuzeo sam ga napola završenog i pokvarenog i pretvorio ga u sistem koji radi.

Uloga
Preuzeo nedovršen plugin, zatim ga iznova izgradio, proširio i održavao
Tehnologije
Lua (GLua), NutScript, MySQL
Kontekst
Policijski i kriminalni roleplay na Diverge Networks
Status
U produkciji, u upotrebi od decembra 2024.

Snimci ekrana i klipovi na ovoj stranici: napravljeni na razvojnom serveru, sa test likovima i nameštenim podacima.

Problem

Kada sam došao u Diverge Networks, server je već imao forenzički plugin, koji je napisao raniji developer i nikad ga nije završio. Tela su se duplirala ili nestajala, dokazi nisu preživljavali promenu mape, a neki otisci prstiju nisu mogli ni da se skinu. Policijski i kriminalni roleplay su se ipak oslanjali na njega.

Za skoro dve godine i oko 70 komitova pretvorio sam ga u sistem koji je roleplayu trebao: mesta zločina koja ostaju, dokazi koji izdrže i dosijei sa kojima detektivi zaista mogu da rade. Zasluge prvobitnog autora zadržao sam u kodu.

Tela i mesta zločina

Video uskoro

Detektiv na test mestu zločina: pregleda telo, pakuje čauru u kesu, zatim skida otisak prsta na karticu.

assets/projects/forensics/crime-scene.mp4 (20 do 30 sekundi)

Rad na mestu zločina.

Snimak ekrana uskoro

Panel za pregled tela na test liku, sa vremenom smrti, ranama i oružjem koje je nosio.

assets/projects/forensics/inspect-corpse.webp (usko isečeno na panel)

Šta telo otkriva.

Video (opciono) uskoro

Kriminalac spaljuje telo benzinom ili ga zatvara u vreću za leš.

assets/projects/forensics/body-disposal.mp4 (oko 15 sekundi)

Uklanjanje dokaza.

Dokazi

Snimak ekrana uskoro

Kartica sa otiskom prsta posle skidanja otiska, sa izmenjenom pratećom karticom.

assets/projects/forensics/fingerprint-card.webp (usko isečeno)

Skinut otisak i njegova prateća kartica.

Dosijei i baza podataka

Snimak ekrana uskoro

Forenzička baza podataka sa rezultatima pretrage, popunjena test podacima.

assets/projects/forensics/case-database.webp (usko isečeno na panel)

Pretraga baze podataka.

Snimak ekrana uskoro

Detektivski dosije slučaja sa priloženim dokazima, samo test podaci.

assets/projects/forensics/case-file.webp (usko isečeno na panel)

Dosije slučaja sa priloženim dokazima.

Napravljeno za živi server

-- Step 1, on the server: the player uses a fingerprint card while looking at an item.
-- If there's a choice of prints, the server grants a one-time authorisation tied
-- to this card and this item, and sends the list to choose from.
onRun = function(card)
    local ply = card.player
    local target = ply:GetEyeTrace().Entity
    if (target:GetClass() ~= "nut_item") then return false end

    local prints = Forensics:GetValidFingerprints(target)   -- decayed prints already filtered out
    -- ... zero prints and single-print shortcuts omitted

    ply.authFingerprintCard = card.id
    ply.authFingerprintItem = target.nutItemID
    ply.authFingerprintCardTime = SysTime()
    -- ... send the choices to the client
    return false
end

-- Step 2: the client answers with the card and the index of the print it picked.
net.Receive("Forensics:FingerprintCard", function(_, ply)
    local card = nut.item.instances[net.ReadUInt(32)]
    local printIndex = net.ReadUInt(32)
    local target = ply:GetEyeTrace().Entity

    -- The authorisation must match this card and be under a minute old.
    if (not card or card.uniqueID ~= "fingerprintcard"
        or ply.authFingerprintCard ~= card.id
        or SysTime() - ply.authFingerprintCardTime > 60) then
        return
    end

    -- Still looking at the same item, and within arm's reach.
    if (not IsValid(target) or target:GetClass() ~= "nut_item"
        or target.nutItemID ~= ply.authFingerprintItem
        or target:GetPos():DistToSqr(ply:GetPos()) > 100 * 100) then
        return
    end

    -- The prints are looked up again on the server. The client only picks an index.
    local prints = Forensics:GetValidFingerprints(nut.item.instances[target.nutItemID])

    -- One use only.
    ply.authFingerprintCard = nil
    ply.authFingerprintItem = nil
    ply.authFingerprintCardTime = nil

    local chosen = prints[printIndex]
    if (not chosen) then return end

    -- The card must still be in this player's inventory.
    if (not ply:getChar():getInv():getItems()[card.id]) then return end

    ply:notify("You peel off a fingerprint and imprint it onto the card.")
    -- ... write the lifted print to the forensics database (omitted)
end)
Preuzeto iz produkcionog koda, malo dorađeno radi čitljivosti. Nikad dovoljno da bi se sistem rekonstruisao.

Još se raspetljava

Deo prvobitnog dizajna je i dalje ispod svega i povremeno izbije kao neobičan bug. Svaki fix je prilika da se zameni još jedan njegov deo.