vending

Captalism in the year 2525, everything in a vending machine, even love

Vars
active	Is the machine active (No sales pitches if off)!
age_restrictions	Whether our age check is currently functional
alertradio	used for narcing on underages
bill	Bills we accept?
canload_access_list	ID's that can load this vending machine wtih refills
chef_price	Custom item price
coin	Coins that we accept?
contraband	List of products this machine sells when you hack it
crit_chance	The chance, in percent, of this vendor performing a critical hit on anything it crushes via [tilt].
custom_payout_account	payout account (weakref) for custom items
default_price	Default price of items if not overridden
extended_inventory	can we access the hidden inventory?
extra_price	Default price of premium items if not overridden
forcecrit	If set to a critical define in crushing.dm, anything this vendor crushes will always be hit with that effect.
icon_deny	Icon to flash when user is denied a vend
icon_vend	Icon when vending an item to the user
input_display_header	Display header on the input view
last_reply	Last world tick we sent a vent reply
last_shopper	Last mob to shop with us
last_slogan	Last world tick we sent a slogan message out
light_mask	Name of lighting mask for the vending machine
loaded_items	how many items have been inserted in a vendor
num_shards	Number of glass shards the vendor creates and tries to embed into an atom it tilted onto
onstation	Is this item on station or not
panel_type	Icon for the maintenance panel overlay
pinned_mobs	List of mobs stuck under the vendor
premium	List of premium products this machine sells
product_ads	String of small ad messages in the vending screen - random chance
product_slogans	String of slogans separated by semicolons, optional
products	List of products this machine sells
purchase_message_cooldown	Next world time to send a purchase message
scan_id	Are we checking the users ID
seconds_electrified	World ticks the machine is electified for
shoot_inventory	When this is TRUE, we fire items at customers! We're broken!
shoot_inventory_chance	How likely this is to happen (prob 100)
slogan_delay	How many ticks until we can send another
small_ads	Small ad messages in the vending screen - random chance of popping up whenever you open it
squish_damage	Damage this vendor does when tilting onto an atom
tiltable	Whether this vendor can be tilted over or not
tilted	Whether the vendor is tilted or not
tilted_rotation	If tilted, this variable should always be the rotation that was applied when we were tilted. Stored for the purposes of unapplying it.
vend_ready	Are we ready to vend?? Is it time??
vend_reply	Message sent post vend (Thank you for shopping!)
vending_machine_input	Custom item stock
Procs
Initialize	Initialize the vending machine
build_inventory	Build the inventory of the vending machine from it's product and record lists
canLoadItem	Are we able to load the item passed in
charge_user	Charge the user during a vend Returns false if the user could not buy this item
compartmentLoadAccessCheck	Is the passed in user allowed to load this vending machines compartments
finish_vend	Finish a vend by consuming power, playing animations & playing sounds
pre_throw	A callback called before an item is tossed out
refill_inventory	Refill our inventory from the passed in product list into the record list
restock	Refill a vending machine from a refill canister
shock	Shock the passed in user
speak	Speak the given message verbally
thank_user	Thank the user for the purchase
throw_item	Throw an item from our internal inventory out in front of us
unbuild_inventory	Given a record list, go through and and return a list of type -> amount
update_canister	Set up a refill canister that matches this machines products

Var Details

var
active
–

Is the machine active (No sales pitches if off)!

var
age_restrictions
–

Whether our age check is currently functional

var
alertradio
– /obj/item/radio

used for narcing on underages

var
bill
– /obj/item/stack/spacecash

Bills we accept?

var
canload_access_list
– /list

ID's that can load this vending machine wtih refills

var
chef_price
–

Custom item price

var
coin
– /obj/item/coin

Coins that we accept?

var
contraband
– /list

List of products this machine sells when you hack it

form should be list(/type/path = amount, /type/path2 = amount2)

var
crit_chance
–

The chance, in percent, of this vendor performing a critical hit on anything it crushes via [tilt].

var
custom_payout_account
– /datum/weakref

payout account (weakref) for custom items

var
default_price
–

Default price of items if not overridden

var
extended_inventory
–

can we access the hidden inventory?

var
extra_price
–

Default price of premium items if not overridden

var
forcecrit
–

If set to a critical define in crushing.dm, anything this vendor crushes will always be hit with that effect.

var
icon_deny
–

Icon to flash when user is denied a vend

var
icon_vend
–

Icon when vending an item to the user

var
input_display_header
–

Display header on the input view

var
last_reply
–

Last world tick we sent a vent reply

var
last_shopper
–

Last mob to shop with us

var
last_slogan
–

Last world tick we sent a slogan message out

var
light_mask
–

Name of lighting mask for the vending machine

var
loaded_items
–

how many items have been inserted in a vendor

var
num_shards
–

Number of glass shards the vendor creates and tries to embed into an atom it tilted onto

var
onstation
–

Is this item on station or not

if it doesn't originate from off-station during mapload, everything is free

var
panel_type
–

Icon for the maintenance panel overlay

var
pinned_mobs
– /list

List of mobs stuck under the vendor

var
premium
– /list

List of premium products this machine sells

form should be list(/type/path, /type/path2) as there is only ever one in stock

var
product_ads
–

String of small ad messages in the vending screen - random chance

var
product_slogans
–

String of slogans separated by semicolons, optional

var
products
– /list

List of products this machine sells

form should be list(/type/path = amount, /type/path2 = amount2)

var
purchase_message_cooldown
–

Next world time to send a purchase message

var
scan_id
–

Are we checking the users ID

var
seconds_electrified
–

World ticks the machine is electified for

var
shoot_inventory
–

When this is TRUE, we fire items at customers! We're broken!

var
shoot_inventory_chance
–

How likely this is to happen (prob 100)

var
slogan_delay
–

How many ticks until we can send another

var
small_ads
– /list

Small ad messages in the vending screen - random chance of popping up whenever you open it

var
squish_damage
–

Damage this vendor does when tilting onto an atom

var
tiltable
–

Whether this vendor can be tilted over or not

var
tilted
–

Whether the vendor is tilted or not

var
tilted_rotation
–

If tilted, this variable should always be the rotation that was applied when we were tilted. Stored for the purposes of unapplying it.

var
vend_ready
–

Are we ready to vend?? Is it time??

var
vend_reply
–

Message sent post vend (Thank you for shopping!)

var
vending_machine_input
– /list

Custom item stock

Proc Details

↑
Initialize
(mapload)

Initialize the vending machine

Builds the vending machine inventory, sets up slogans and other such misc work

This also sets the onstation var to:

FALSE - if the machine was maploaded on a zlevel that doesn't pass the is_station_level check
TRUE - all other cases

proc
build_inventory
(/list/productlist, /list/recordlist, start_empty)

Build the inventory of the vending machine from it's product and record lists

This builds up a full set of /datum/data/vending_products from the product list of the vending machine type Arguments:

productlist - the list of products that need to be converted
recordlist - the list containing /datum/data/vending_product datums
startempty - should we set vending_product record amount from the product list (so it's prefilled at roundstart)

proc
canLoadItem
(/obj/item/I, /mob/user)

Are we able to load the item passed in

Arguments:

I - the item being loaded
user - the user doing the loading

proc
charge_user
(price, item_name, always_charge, pay_custom)

Charge the user during a vend Returns false if the user could not buy this item

proc
compartmentLoadAccessCheck
(/mob/user)

Is the passed in user allowed to load this vending machines compartments

Arguments:

user - mob that is doing the loading of the vending machine

proc
finish_vend
()

Finish a vend by consuming power, playing animations & playing sounds

proc
pre_throw
(/obj/item/I)

A callback called before an item is tossed out

Override this if you need to do any special case handling

Arguments:

I - obj/item being thrown

proc
refill_inventory
(/list/productlist, /list/recordlist)

Refill our inventory from the passed in product list into the record list

Arguments:

productlist - list of types -> amount
recordlist - existing record datums

proc
restock
(/obj/item/vending_refill/canister)

Refill a vending machine from a refill canister

This takes the products from the refill canister and then fills the products,contraband and premium product categories

Arguments:

canister - the vending canister we are refilling from

proc
shock
(/mob/user, prb)

Shock the passed in user

This checks we have power and that the passed in prob is passed, then generates some sparks and calls electrocute_mob on the user

Arguments:

user - the user to shock
prb - probability the shock happens

proc
speak
(message)

Speak the given message verbally

Checks if the machine is powered and the message exists

Arguments:

message - the message to speak

proc
thank_user
(message)

Thank the user for the purchase

proc
throw_item
()

Throw an item from our internal inventory out in front of us

This is called when we are hacked, it selects a random product from the records that has an amount > 0 This item is then created and tossed out in front of us with a visible message

proc
unbuild_inventory
(/list/recordlist)

Given a record list, go through and and return a list of type -> amount

proc
update_canister
()

Set up a refill canister that matches this machines products

This is used when the machine is deconstructed, so the items aren't "lost"

vending machines /obj/machinery/vending

Vars

Procs

Var Details

var active –

var age_restrictions –

var alertradio – /obj/item/radio

var bill – /obj/item/stack/spacecash

var canload_access_list – /list

var chef_price –

var coin – /obj/item/coin

var contraband – /list

var crit_chance –

var custom_payout_account – /datum/weakref

var default_price –

var extended_inventory –

var extra_price –

var forcecrit –

var icon_deny –

var icon_vend –

var input_display_header –

var last_reply –

var last_shopper –

var last_slogan –

var light_mask –

var loaded_items –

var num_shards –

var onstation –

var panel_type –

var pinned_mobs – /list

var premium – /list

var product_ads –

var product_slogans –

var products – /list

var purchase_message_cooldown –

var scan_id –

var seconds_electrified –

var shoot_inventory –

var shoot_inventory_chance –

var slogan_delay –

var small_ads – /list

var squish_damage –

var tiltable –

var tilted –

var tilted_rotation –

var vend_ready –

var vend_reply –

var vending_machine_input – /list

Proc Details

↑Initialize(mapload)

proc build_inventory(/list/productlist, /list/recordlist, start_empty)

proc canLoadItem(/obj/item/I, /mob/user)

proc charge_user(price, item_name, always_charge, pay_custom)

proc compartmentLoadAccessCheck(/mob/user)

proc finish_vend()

proc pre_throw(/obj/item/I)

proc refill_inventory(/list/productlist, /list/recordlist)

proc restock(/obj/item/vending_refill/canister)

proc shock(/mob/user, prb)

proc speak(message)

proc thank_user(message)

proc throw_item()

proc unbuild_inventory(/list/recordlist)

proc update_canister()

vending machines
/obj/machinery/vending

var
active
–

var
age_restrictions
–

var
alertradio
– /obj/item/radio

var
bill
– /obj/item/stack/spacecash

var
canload_access_list
– /list

var
chef_price
–

var
coin
– /obj/item/coin

var
contraband
– /list

var
crit_chance
–

var
custom_payout_account
– /datum/weakref

var
default_price
–

var
extended_inventory
–

var
extra_price
–

var
forcecrit
–

var
icon_deny
–

var
icon_vend
–

var
input_display_header
–

var
last_reply
–

var
last_shopper
–

var
last_slogan
–

var
light_mask
–

var
loaded_items
–

var
num_shards
–

var
onstation
–

var
panel_type
–

var
pinned_mobs
– /list

var
premium
– /list

var
product_ads
–

var
product_slogans
–

var
products
– /list

var
purchase_message_cooldown
–

var
scan_id
–

var
seconds_electrified
–

var
shoot_inventory
–

var
shoot_inventory_chance
–

var
slogan_delay
–

var
small_ads
– /list

var
squish_damage
–

var
tiltable
–

var
tilted
–

var
tilted_rotation
–

var
vend_ready
–

var
vend_reply
–

var
vending_machine_input
– /list

↑
Initialize
(mapload)

proc
build_inventory
(/list/productlist, /list/recordlist, start_empty)

proc
canLoadItem
(/obj/item/I, /mob/user)

proc
charge_user
(price, item_name, always_charge, pay_custom)

proc
compartmentLoadAccessCheck
(/mob/user)

proc
finish_vend
()

proc
pre_throw
(/obj/item/I)

proc
refill_inventory
(/list/productlist, /list/recordlist)

proc
restock
(/obj/item/vending_refill/canister)

proc
shock
(/mob/user, prb)

proc
speak
(message)

proc
thank_user
(message)

proc
throw_item
()

proc
unbuild_inventory
(/list/recordlist)

proc
update_canister
()