Gratis script · v1.0.0
KD Vendingmachine
Realistiske vending machines til FiveM, hvor hver maskine har sit eget UI. Gå hen til maskinen, tryk på knapperne, betal med kontant eller kort, se dåsen falde, og tag den fra bakken.
ZIP fra GitHub · MIT-licens
Kan du lide scriptet? Giv det en ⭐ på GitHub. Det er gratis og hjælper andre med at finde det.
- QBox
- QBCore
- ESX
- Standalone
- ox_inventory
- ox_target
- qb-target
- Lua 5.4
- 6maskintyper
- 30+varer klar
- 0krævede dependencies
- 0.00 msidle med target
Et UI til hver maskine
Det er ikke én menu med en anden farve. Hver maskine har sin egen hardware, sine egne knapper og sin egen lyd.
-
Se den i videoen øverst
eCola
Rød sodavandsfront, oplyst vindue med prøver, valgknapper, seddelindføring og kontaktløs kortlæser.
prop_vend_soda_01
-
Vis større billede
Sprunk
Samme hardware som eCola, men med Sprunks limegrønne branding.
prop_vend_soda_02
-
Vis større billede
Raine
En ren, gletsjerblå vandmaskine.
prop_vend_water_01
-
Vis større billede
Snacks
Glasfront med spiraler, hyldeskilte og et A1–D6 tastatur. Du kan også skrive på dit eget keyboard.
prop_vend_snak_01prop_vend_snak_01_tu
-
Vis større billede
Coffee
Touchskærm: vælg drik, kopstørrelse (ændrer prisen), sukker og styrke. Bryggering, kopholder med hældeanimation og damp.
prop_vend_coffe_01
-
Vis større billede
Cigarettes
70'er-automat med træk-knapper: træårer, løbelys, indsæt mønter og træk i et forkromet håndtag.
prop_vend_fags_01
Det får du
Alt det, der får en vending machine til at føles som en rigtig maskine, og det, der holder din økonomi sikker.
-
Fysiske animationer
Spilleren går hen til maskinen og vender sig mod den, trykker på knapper, mens UI'et er åbent, og rækker ned i bakken efter varen. Den rigtige prop (dåse, flaske, chokoladebar, chips, kaffekop eller cigaretpakke) er i hånden, og andre spillere kan se den.
-
Feedback fra maskinen
LCD- og VFD-displays, LED'er på kortlæseren, en seddel der glider ind, spiralen der drejer, varen der falder og hopper i bakken, og en låge du skubber for at tage den.
-
Procedurale lydeffekter
Bip fra tasterne, mønter, godkendt kort, motorbrum, bunket fra varen, brygning og knappernes klik. Lavet med Web Audio, så der følger ingen lydfiler med.
-
Virker med dit framework
QBox, QBCore, ESX eller standalone med ox_inventory. Det bliver fundet automatisk.
-
Virker med din interaktion
ox_target, qb-target, ox_lib text UI eller GTA's egen hjælpetekst (~INPUT_CONTEXT~). Den bedste, du har, bliver valgt.
-
Serveren bestemmer
Pris, lager, afstand, betaling, plads i inventory og cooldown tjekkes på serveren. Kan varen ikke gives, får spilleren automatisk pengene tilbage.
-
Lager pr. maskine
Hver fysisk maskine har sit eget lager, som fyldes op automatisk. Admins kan fylde alle maskiner med /restockvending.
-
Discord-logs
Køb og mistænkelige forespørgsler kan logges til en Discord-webhook.
-
Ekstra placeringer
Sæt flere maskiner op hvor som helst fra configen.
-
Dansk og engelsk
Begge sprog følger med, og det er nemt at tilføje flere.
-
Preview i browseren
Åbn web/index.html i Chrome eller Edge, og klik dig igennem alle maskiner uden at starte spillet.
Krav
Ingen krævede dependencies ud over dit framework og dit inventory.
- Framework (et af dem)
- qbx_core · qb-core · es_extended · eller standalone med ox_inventory
- Inventory
- ox_inventory, qb-inventory (og forks) eller ESX' standard-inventory
- Server
- OneSync slået til (bruges til afstandstjek på serveren)
Installation
Fra download til en fungerende maskine på et par minutter.
-
Læg den i resources
Omdøb mappen til kd-vendingmachine, og læg den i din resources-mappe.
-
Tilføj varerne
Tilføj varerne til dit inventory. Se tabellen nedenfor.
-
Start resourcen
Tilføj den til server.cfg efter dit framework, inventory og target:
ensure kd-vendingmachine -
Admin-adgang (valgfrit)
Giv admins adgang til at fylde maskinerne op:
add_ace group.admin kdvending.admin allow -
Genstart
Genstart serveren. Konsollen skriver dette, og varer der mangler i dit inventory, bliver vist som en advarsel:
[kd-vendingmachine] v1.0.0 loaded · framework: qbox · inventory: ox_inventory
Varer
Standard-configen sælger omkring 30 varer. Definitioner, der er klar til at indsætte, ligger i mappen /install.
| Inventory | Fil | Hvor den skal hen |
|---|---|---|
| ox_inventory (QBox / ESX / standalone) | install/ox_inventory.lua | ox_inventory/data/items.lua. Med animationer, props og status-værdier. |
| qb-inventory | install/qb-core.lua | qb-core/shared/items.lua |
| ESX default inventory | install/esx.sql | Kør den mod din database |
Har du allerede water, coffee, sandwich eller lighter? Så spring dem over. Du kan også få enhver maskine til at sælge dine egne varer ved at ændre name i configen.
Kører det på din server?
Kan du lide scriptet? Giv det en ⭐ på GitHub. Det er gratis og hjælper andre med at finde det.
Konfiguration
To config-filer. Den ene deles med klienten, den anden bliver kun på serveren.
| Fil | Indhold | Sendt til klienten? |
|---|---|---|
config/config.lua | Maskiner, varer, priser, UI, animationer og interaktion | Ja |
config/server.lua | Webhook, maks afstand, admin-ace og logging | Nej |
Generelt
Config.Locale = 'en' -- 'en' | 'da'
Config.Framework = 'auto' -- 'auto' | 'qbox' | 'qbcore' | 'esx' | 'standalone'
Config.Inventory = 'auto' -- 'auto' | 'ox_inventory' | 'framework'
Config.Interaction = 'auto' -- 'auto' | 'ox_target' | 'qb-target' | 'textui' | 'native'
Config.Notify = 'auto' -- 'auto' | 'ox_lib' | 'framework' | 'native'
Config.InteractDistance = 1.6
Config.AlignPlayer = true -- walk up to the machine before the UI opens
Config.NetworkedProps = true -- others can see the product in your hand
Config.Cooldown = 1500 -- ms between purchases (server enforced)
Betaling og lager
Config.Payment = { cash = true, bank = true } -- default, override per machine
Config.Stock = {
enabled = true,
default = 12, -- per slot, override with `stock = n` on an item
restockMinutes = 30,
}
Lageret holdes pr. fysisk maskine: to eCola-maskiner ved siden af hinanden har hver deres lager.
Interface
Config.UI = {
currency = '$',
sound = true,
volume = 0.35,
showBalance = true, -- show cash / bank under the payment modules
autoTake = 8000, -- auto-grab after X ms if the player doesn't click the tray (0 = off)
images = 'drawn', -- 'drawn' | 'inventory' | 'nui://my-images/%s.png'
}
images | Resultat |
|---|---|
'drawn' | Stiliserede CSS-varer (dåser, flasker, barer, chips, kopper, pakker) i varens farver. Virker uden opsætning og passer til maskinerne. |
'inventory' | Bruger dit inventorys billeder (ox, qb, ps og lj bliver fundet automatisk). Falder tilbage til tegnede varer, hvis et billede mangler. |
| egen tekst | En vilkårlig URL-skabelon med %s, som bliver erstattet med varens navn. |
Tilføj eller ret en maskine
Config.Machines.mymachine = {
label = 'Energy Machine', -- target label / notifications
brand = 'Junk', -- printed on the machine
tagline = 'The quick fix',
layout = 'soda', -- 'soda' | 'glass' | 'coffee' | 'retro'
theme = 'sprunk', -- 'ecola' | 'sprunk' | 'raine' | 'snack' | 'coffee' | 'redwood'
models = { 'prop_vend_soda_02' }, -- each model can only belong to one machine
animation = 'tray_low', -- key from Config.Animations
icon = 'fa-solid fa-bolt',
payment = { cash = true, bank = false }, -- optional
items = {
{
name = 'junk_energy', -- inventory item
label = 'Junk Energy',
price = 6,
kind = 'can', -- drawn shape: can | bottle | bar | bag | candy | cup | pack
color = '#1b1b1b', -- main colour
accent = '#b6ff00', -- label / stripe colour
prop = 'can', -- hand prop, key from Config.Props
stock = 20, -- optional
-- image = 'https://...', -- optional, overrides Config.UI.images
-- metadata = { quality = 100 }, -- optional, ox_inventory metadata
},
},
}
Kaffemaskiner kan have størrelser, som ganger prisen (tjekkes på serveren):
sizes = {
{ label = 'S', name = 'Small', multiplier = 1.0 },
{ label = 'M', name = 'Medium', multiplier = 1.25 },
{ label = 'L', name = 'Large', multiplier = 1.5 },
},
Animationer
Hver maskine bruger et animations-preset, som du kan ændre eller lave flere af. Hånd-props står i Config.Props og bruges ved navn fra varerne. Ugyldige modeller bliver sprunget over med en advarsel i konsollen, så intet går i stykker.
Config.Animations.tray_low = {
align = vec3(0.0, -0.78, 0.0), -- where the player stands (machines face -Y)
browse = { dict = 'anim@heists@keypad@', clip = 'idle_a', flag = 49 }, -- loop while UI is open
press = { dict = 'anim@heists@keypad@', clip = 'exit', flag = 48 }, -- confirm purchase
grab = { dict = 'pickup_object', clip = 'pickup_low', flag = 0,
propAt = 0.36, -- anim phase where the product appears in the hand
stopAt = 0.92, -- anim phase where the grab ends
hold = 900 }, -- ms the product stays in hand afterwards
}
Ekstra placeringer
Config.Placements = {
{ machine = 'coffee', coords = vec4(-1199.61, -884.82, 12.81, 124.0) },
{ machine = 'snacks', coords = vec4(441.32, -979.64, 29.69, 180.0), model = 'prop_vend_snak_01_tu' },
}
API
Exports og events, så du kan bygge videre på det fra dine egne scripts.
Client exports
-- Open the UI for a machine entity (e.g. from your own target / interaction script)
exports['kd-vendingmachine']:OpenMachine(entity)
-- Is the UI currently open?
local open = exports['kd-vendingmachine']:IsOpen()
-- Force close (the player still grabs anything they paid for)
exports['kd-vendingmachine']:CloseMachine()
Server exports
-- Refill every machine
exports['kd-vendingmachine']:Restock()
-- Current stock of a specific machine
local stock = exports['kd-vendingmachine']:GetStock('ecola', vec3(x, y, z))
Server events
-- Fired after every successful purchase
AddEventHandler('kd-vendingmachine:purchased', function(source, data)
-- data.machine, data.item, data.price, data.payment, data.coords
end)
Kommandoer
| Kommando | Tilladelse | Beskrivelse |
|---|---|---|
/restockvending | kdvending.admin (eller serverkonsollen) | Fyld alle maskiner op |
Sikkerhed
Klienten bestemmer aldrig noget, der betyder noget. Ved hvert køb gør serveren følgende:
- tjekker, at spilleren er inden for ServerConfig.MaxDistance af maskinen
- tjekker, at varen hører til maskinen, og tager prisen fra configen, aldrig fra klienten
- tjekker betalingsmetode og kopstørrelse
- tjekker lager, plads i inventory og saldo
- trækker pengene først, giver så varen, og betaler tilbage, hvis det fejler
- håndhæver en cooldown pr. spiller
- logger alt mistænkeligt i konsollen og eventuelt til en Discord-webhook
FAQ
De mest almindelige spørgsmål. Mangler du svar, så skriv på Discord.
Der sker ingenting, når jeg targeter en maskine
Sørg for, at kd-vendingmachine starter efter din target-resource. Med Config.Debug = true skriver F8-konsollen, hvilken interaktion der blev valgt.
"Ikke nok penge" eller "Du kan ikke bære det", selv om jeg kan
Tjek, at varen findes i dit inventory. Manglende varer bliver vist, når resourcen starter. Ukendte varer fejler tjekket for plads.
Spilleren står ikke rigtigt foran maskinen
Ret align i animations-presettet. y er afstanden foran maskinen (negativ = foran). Du kan også slå det fra med Config.AlignPlayer = false.
Kan jeg bruge mine egne vending machine props eller MLO-maskiner?
Ja. Tilføj modelnavnet til en maskines models-liste, eller lav en ny maskine. Alle props virker.
Virker UI'et uden internet (fonts)?
Fonts hentes fra Google Fonts. Uden internet bruger UI'et systemets fonts og virker stadig.
Må jeg ændre det og bruge det på min server?
Ja. Scriptet er MIT-licenseret: brug det, ændr det, og del det. Kredit er værdsat, men ikke et krav.
Klar til en tår?
Gratis og open source under MIT-licensen. Brug det, ændr det, del det. Har du brug for noget custom, så skriv på Discord. Kan du lide scriptet? Giv det en ⭐ på GitHub. Det er gratis og hjælper andre med at finde det.