Svi radovi

Napravljeno, u testiranju

Pravljenje pića, odležavanje i alkoholisanost

Ovde je težište na dizajnu: sistem za spravljanje i odležavanje pića sa verovatnoćama koje podešavaju dizajneri, plus model alkohola u krvi koji pokreće efekte pijanstva i policijsko testiranje.

Uloga
Dizajn i implementacija
Tehnologije
Lua (GLua)
Kontekst
Kraftovanje i ekonomija na roleplay serveru Diverge Networks
Status
Napravljeno, čeka u redu za testiranje na serveru

Problem

Server je želeo da alkohol bude nešto što igrači prave, a ne samo kupuju: bure u kome sastojci odlučuju šta možete da dobijete, odležavanje koje nagrađuje strpljenje i opijanje sa posledicama koje policija može da proveri testom. Recepte je trebalo da podešavaju dizajneri servera, bez diranja koda.

Spravljanje

Osnovni sastojak određuje moguće ishode. Od grožđa, na primer, može da nastane crno vino, belo vino ili sirće, loš ishod. Svaki dodatni sastojak daje veću težinu ishodima koje deli sa osnovom, a sastojak koji s njom nema ništa zajedničko gura smesu ka lošem ishodu. Kada se bure zapečati, izvlači se ponderisani ishod, koji je gotov posle zadatog vremena.

Igrači vide moguće ishode i njihove šanse pre nego što zapečate bure. Dizajneri menjaju recepte u samoj igri, kroz konfiguracioni panel dostupan samo određenim rangovima, koji validira svaku vrednost.

Video uskoro

Postavljanje bureta, dodavanje osnovnog sastojka da bi se pojavili mogući ishodi, dodavanje sastojaka dok se šanse ažuriraju, zatim pečaćenje i preuzimanje ishoda.

assets/projects/brewing/brewing-seal.mp4 (30 do 45 sekundi)

Od prvog sastojka do gotovog pića.

Snimak ekrana uskoro

Interfejs za spravljanje pića sa postavljenim sastojcima i vidljivim šansama.

assets/projects/brewing/brewing-ui.png (usko isečeno na panel)

Bure za spravljanje pića.

Odležavanje

Igrači pri pečaćenju bureta biraju koliko dugo će piće odležavati, od jednog minuta do sat i po. Hteo sam da u tom izboru bude malo kockanja i malo umeća: kraće odležavanje i dalje može da donese bolji ishod, a igrači koji eksperimentišu nauče gde su najbolje tačke.

Svaki mogući ishod odležavanja je zvonasta kriva kroz vreme: kada dostiže vrhunac, koliko je jak i koliko brzo opada. U svakom trenutku krive daju šanse za svaki ishod, a konfiguracioni panel ih crta na grafiku, tako da dizajner tačno vidi šta će dati odležavanje od 30 minuta. Ako piće ostavite predugo, preuzima kriva sirćeta.

Video uskoro

Konfiguracioni panel za odležavanje sa grafikom, zatim jedan ciklus odležavanja.

assets/projects/brewing/aging.mp4 (oko 15 sekundi)

Podešavanje i pokretanje bureta za odležavanje.

Snimak ekrana uskoro

Konfiguracioni panel za odležavanje, sa kursorom iznad grafika.

assets/projects/brewing/aging-config.png (usko isečeno na panel)

Dizajneri vide šanse kroz vreme.
Isprobajte: prevucite preko grafika ili pomerite klizač da promenite vreme odležavanja, podesite krivu, pa zapečatite bure. Vrednosti su primeri, ne stvarna podešavanja sa servera.
-- Each possible result of aging is a bell curve over time, tuned by a designer:
--   time  = when it peaks (minutes),  peak = how strong it gets,  sigma = how fast it falls off.
-- (Example values, not the live tuning.)
--   ["young_wine"] = { time = 20, peak = 0.75, sigma = 5 },
--   ["vinegar"]    = { time = 90, peak = 0.85, sigma = 8 },

function AgingBarrel.ComputeProbability(o, t)
    local sigma = o.sigma or 6
    local peak = o.peak or 1
    local d = t - o.time
    return peak * math.exp(-(d * d) / (2 * sigma * sigma))
end

-- The score of every result at time t, keyed by result.
function AgingBarrel.ComputeProbabilities(outcomes, t)
    local scores = {}
    for name, o in pairs(outcomes) do
        scores[name] = AgingBarrel.ComputeProbability(o, t)
    end
    return scores
end

-- Weighted roll over the scores. They don't need to sum to 1.
function AgingBarrel.Roll(probs)
    local total = 0
    for _, p in pairs(probs) do
        total = total + p
    end
    local roll = math.Rand(0, total)

    local cumulative = 0
    local bestName, bestP = nil, -1
    for name, p in pairs(probs) do
        cumulative = cumulative + p
        if p > bestP then bestName, bestP = name, p end
        if roll <= cumulative then
            return name
        end
    end

    -- Floating-point safety net: fall back to the most likely result.
    return bestName
end

function AgingBarrel.ResolveOutcome(config, t)
    return AgingBarrel.Roll(AgingBarrel.ComputeProbabilities(config, t))
end
Preuzeto iz produkcionog koda, malo dorađeno radi čitljivosti.

Pijenje i testiranje

Svaki lik ima nivo alkohola u krvi od 0 do 100. Svako piće dodaje 2,5 puta kvadratni koren svog procenta alkohola, tako da jača pića jače udaraju, ali ne rastu linearno: pivo dodaje oko 6 do 8, vino 9 do 10, a koktel od 40% čak 16. Efekti pijanstva rastu sa tim nivoom.

Alkohol izlazi iz organizma posle 15 minuta, a ostale supstance posle 30. Alkotest meri stvarno pijanstvo, a novi analizator krvi služi za testove na droge.

Video uskoro

Nekoliko pića dok se efekti pojačavaju, zatim test alkotestom ili analizatorom krvi i njegov rezultat.

assets/projects/brewing/intoxication.mp4 (15 do 20 sekundi)

Efekti, pa test.

Snimak ekrana uskoro

Rezultat analizatora krvi ili alkotesta.

assets/projects/brewing/analyzer-result.png (usko isečeno)

Rezultat testa.

Poslednju reč ima server

Kada igrač zapečati bure, klijent šalje samo ID bureta. Server proverava da li je to zaista bure za spravljanje pića, da li ga taj igrač trenutno koristi i da li je svaki sastojak ispravan i u ispravnom slotu, pa tek onda sam računa ishod. Tajmer koji isplaćuje ishod pre isporuke ponovo proverava da li su bure i njegovo stanje i dalje ispravni.

-- The client sends only the cask's item ID. Everything else is checked
-- and decided here, on the server.
net.Receive("nutBrewingCaskSeal", function(_, ply)
    local cask = nut.item.instances[net.ReadUInt(32)]
    if (not cask or cask.uniqueID ~= "brewing_cask") then return reject(ply, "That isn't a brewing cask.") end

    local inv = cask:getInv()
    if (not inv) then return reject(ply, "That cask has no inventory.") end

    -- Only someone who currently has this cask open can seal it.
    if (not inv.currentUsers[ply]) then return reject(ply, "You aren't using this cask.") end

    -- Every ingredient must be valid and sit in one of the four slots.
    local items = {}
    for _, item in pairs(inv:getItems(true)) do
        local x, y = item:getData("x"), item:getData("y")
        if (not x or y ~= 1 or x < 1 or x > 4) then return reject(ply, "An ingredient is in an invalid slot.") end
        if (not PLUGIN:IsValidBrewingIngredient(item)) then return reject(ply, "That isn't a valid ingredient.") end
        items[x] = item
    end

    local base = table.remove(items, 1)   -- slot 1 is the base
    local additives = table.ClearKeys(items)
    if (not base) then return reject(ply, "You need a base ingredient to start brewing.") end

    -- The base defines the possible results. Additives add weight to results
    -- they share with it; an additive that shares nothing pushes toward the bad result.
    local results = table.Copy(PLUGIN.Data.Recipes[base.uniqueID])
    local bad = results._bad
    results._bad = nil

    for _, item in pairs(additives) do
        local shared = false
        for result, weight in pairs(PLUGIN.Data.Recipes[item.uniqueID]) do
            if (results[result]) then
                results[result] = results[result] + weight
                shared = true
            end
        end
        if (not shared) then
            results[bad] = (results[bad] or 0) + 1
        end
    end

    local outcome = weightedRoll(results)   -- same cumulative roll as the aging module
    if (not outcome) then return reject(ply, "Couldn't pick a result. Please report this.") end

    -- Clearing the users list closes the cask for everyone, so a second
    -- seal request fails the check above. Then the ingredients are consumed.
    inv.currentUsers = {}
    for _, item in pairs(inv:getItems(true)) do
        item:remove()
    end

    cask:setData("producing", true)
    local ent = cask.entity

    timer.Create("Brewing_" .. cask:getID(), PLUGIN.BrewingTime, 1, function()
        -- Re-check everything before paying out: the cask may have been
        -- picked up, deleted or already collected while we waited.
        if (not IsValid(ent) or cask.entity ~= ent or not nut.item.instances[cask:getID()]) then return end
        if (not cask:getData("producing") or cask:getData("collect")) then return end

        cask:setData("producing", nil)
        cask:setData("collect", outcome)
    end)

    -- ... sound, chat emote and closing the player's window omitted
end)
Preuzeto iz produkcionog koda, malo dorađeno radi čitljivosti.