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
all_products_free	If this is set to TRUE, all products sold by the vending machine are free (cost nothing). If unset, this will get automatically set to TRUE during init if the machine originates from off-station during mapload. Defaults to null, set it to TRUE or FALSE explicitly on a per-machine basis if you want to force it to be a certain value.
allow_custom	Whether this vendor can be selected when building a custom vending machine
bill	Bills we accept?
coin	Coins that we accept?
coin_records	List of premium product records
contraband	List of products this machine sells when you hack it
credits_contained	How many credits does this vending machine have? 20% of all sales go to this pool, and are given freely when the machine is restocked, or successfully tilted. Lost on deconstruction.
crit_chance	The chance, in percent, of this vendor performing a critical hit on anything it crushes via [tilt].
default_price	Default price of items if not overridden
displayed_currency_icon	fontawesome icon name to use in to display the user's balance in the vendor UI
displayed_currency_name	String of the used currency to display in the vendor UI
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.
hidden_records	List of contraband product records
icon_deny	Icon to flash when user is denied a vend
icon_vend	Icon when vending an item to the user
last_reply	Last world tick we sent a vent reply
last_shopper	The ref of the 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
onstation_override	DO NOT APPLY THIS GLOBALLY. For mapping var edits only. A variable to change on a per instance basis that allows the instance to avoid having onstation set for them during mapload. Setting this to TRUE means that the vending machine is treated as if it were still onstation if it spawns off-station during mapload. Useful to specify an off-station machine that will be affected by machine-brand intelligence for whatever reason.
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_categories	List of products this machine sells, categorized. Can only be used as an alternative to `products`, not alongside it.
product_records	List of standard product records
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) per second
slogan_delay	How many ticks until we can send another
slogan_list	List of slogans to scream at potential customers; built upon Iniitialize() of the vendor from product_slogans
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	Items that the players have loaded into the vendor
Procs
Initialize	Initialize the vending machine
atom_break	Intentionally leaving out a case for zero credits as it should be covered by the vending machine's stock being full, or covered by first case if items were returned.
build_inventories	*Builds all available inventories for the vendor - standard, contraband and premium
build_inventory	Build the inventory of the vending machine from its product and record lists
build_products_from_categories	Populates list of products with categorized products
canLoadItem	Are we able to load the item passed in
can_vend	Whether this vendor can vend items or not. arguments: user - current customer
collect_records_for_static_data	Returns a list of given product records of the vendor to be used in UI. arguments: records - list of records available categories - list of categories available premium - bool of whether a record should be priced by a custom/premium price or not
compartmentLoadAccessCheck	Is the passed in user allowed to load this vending machines compartments? This only is ran if we are using a /obj/item/storage/bag to load the vending machine, and not a dedicated restocker.
create_categories_from	Returns a list of data about the category Arguments: name - string for the name of the category icon - string for the fontawesome icon to use in the UI for the category products - list of products available in the category
deploy_credits	Drop credits when the vendor is attacked.
dispense	Common proc that dispenses an item. Called when the item is vended, or gotten some other way.
fetch_balance_to_use	Returns the balance that the vendor will use for proceeding payment. Most vendors would want to use the user's card's account credits balance. arguments: passed_id - the id card that will be billed for the product
freebie	Dispenses free items from the standard stock. Arguments: freebies - number of free items to vend
loadingAttempt	Tries to insert the item into the vendor, and depending on whether the product is a part of the vendor's stock or not, increments an already present product entry's available amount or creates a new entry. arguments: inserted_item - the item we're trying to insert user - mob who's trying to insert the item
on_dispense	A proc meant to perform custom behavior on newly dispensed items.
post_restock	After-effects of refilling a vending machine from a refill canister
pre_throw	A callback called before an item is tossed out
proceed_payment	Handles payment processing: discounts, logging, balance change etc. arguments: paying_id_card - the id card that will be billed for the product. mob_paying - the mob that is trying to purchase the item. product_to_vend - the product record of the item we're trying to vend. price_to_use - price of the item we're trying to vend. discountless - whether or not to apply discounts
refill_inventory	Refill our inventory from the passed in product list into the record list
reset_prices	Reassign the prices of the vending machine as a result of the inflation value, as provided by SSeconomy
restock	Refill a vending machine from a refill canister
select_colors	Brings up a color config menu for the picked greyscaled item
shock	Shock the passed in user
speak	Speak the given message verbally
throw_impact	Crush the mob that the vending machine got thrown at
throw_item	Throw an item from our internal inventory out in front of us
tilt	Tilts ontop of the atom supplied, if crit is true some extra shit can happen. See [fall_and_crush] for return values. Arguments: fatty - atom to tilt the vendor onto local_crit_chance - percent chance of a critical hit forced_crit - specific critical hit case to use, if any range - the range of the machine when thrown if not adjacent
total_loaded_stock	Returns the total amount of items in the vending machine based on the product records and premium records, but not contraband
total_max_stock	Returns the total amount of items in the vending machine based on the product records and premium records, but not contraband
unbuild_inventory	Given a record list, go through and return a list of products in format of type -> amount Arguments: recordlist - list of records to unbuild products from
unbuild_inventory_into	Unbuild product_records into categorized product lists to the machine's refill canister. Does not handle contraband/premium products, only standard stock and any other categories used by the vendor(see: ClothesMate). If a product has no category, puts it into standard stock category. Arguments: product_records - list of products of the vendor products - list of products of the refill canister product_categories - list of product categories of the refill canister
untilt	Rights the vendor up, unpinning mobs under it, if any. Arguments: user - mob that has untilted the vendor
update_canister	Set up a refill canister that matches this machine's products
vend	The entire shebang of vending the picked item. Processes the vending and initiates the payment for the item. arguments: greyscale_colors - greyscale config for the item we're about to vend, if any
vend_greyscale	Vends a greyscale modified item. arguments: menu - greyscale config menu that has been used to vend the item

Var Details

var
active

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

var
age_restrictions

Whether our age check is currently functional

var
all_products_free

If this is set to TRUE, all products sold by the vending machine are free (cost nothing). If unset, this will get automatically set to TRUE during init if the machine originates from off-station during mapload. Defaults to null, set it to TRUE or FALSE explicitly on a per-machine basis if you want to force it to be a certain value.

var
allow_custom

Whether this vendor can be selected when building a custom vending machine

var
bill
– /obj/item/stack/spacecash

Bills we accept?

var
coin
– /obj/item/coin

Coins that we accept?

var
coin_records
– /list

List of premium product records

var
contraband
– /list

List of products this machine sells when you hack it

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

var
credits_contained

How many credits does this vending machine have? 20% of all sales go to this pool, and are given freely when the machine is restocked, or successfully tilted. Lost on deconstruction.

var
crit_chance

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

var
default_price

Default price of items if not overridden

var
displayed_currency_icon

fontawesome icon name to use in to display the user's balance in the vendor UI

var
displayed_currency_name

String of the used currency to display in the vendor UI

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
hidden_records
– /list

List of contraband product records

var
icon_deny

Icon to flash when user is denied a vend

var
icon_vend

Icon when vending an item to the user

var
last_reply

Last world tick we sent a vent reply

var
last_shopper

The ref of the 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, all_products_free gets automatically set to TRUE if it was unset previously. if it's off-station during mapload, it's also safe from the brand intelligence event

var
onstation_override

DO NOT APPLY THIS GLOBALLY. For mapping var edits only. A variable to change on a per instance basis that allows the instance to avoid having onstation set for them during mapload. Setting this to TRUE means that the vending machine is treated as if it were still onstation if it spawns off-station during mapload. Useful to specify an off-station machine that will be affected by machine-brand intelligence for whatever reason.

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 = amount, /type/path2 = amount2)

var
product_ads

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

var
product_categories
– /list

List of products this machine sells, categorized. Can only be used as an alternative to products, not alongside it.

Form should be list( "name" = "Category Name", "icon" = "UI Icon (Font Awesome or tgfont)", "products" = list(/type/path = amount, ...), )

var
product_records
– /list

List of standard product records

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) per second

var
slogan_delay

How many ticks until we can send another

var
slogan_list
– /list

List of slogans to scream at potential customers; built upon Iniitialize() of the vendor from product_slogans

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

Items that the players have loaded into the vendor

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

↑
atom_break
(damage_flag)

Intentionally leaving out a case for zero credits as it should be covered by the vending machine's stock being full, or covered by first case if items were returned.

proc
build_inventories
(start_empty)

*Builds all available inventories for the vendor - standard, contraband and premium

Arguments:
start_empty - bool to pass into build_inventory that determines whether a product entry starts with available stock or not

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

Build the inventory of the vending machine from its 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
categories - A list in the format of product_categories to source category from
startempty - should we set vending_product record amount from the product list (so it's prefilled at roundstart)
premium - Whether the ending products shall have premium or default prices

proc
build_products_from_categories
()

Populates list of products with categorized products

proc
canLoadItem
(/obj/item/loaded_item, /mob/user, send_message)

Are we able to load the item passed in

Arguments:

loaded_item - the item being loaded
user - the user doing the loading
send_message - should we send a message to the user if the item can't be loaded? Either a to_chat or a speak depending on vending type.

proc
can_vend
(user)

Whether this vendor can vend items or not. arguments: user - current customer

proc
collect_records_for_static_data
(/list/records, /list/categories, premium)

Returns a list of given product records of the vendor to be used in UI. arguments: records - list of records available categories - list of categories available premium - bool of whether a record should be priced by a custom/premium price or not

proc
compartmentLoadAccessCheck
(/mob/user)

Is the passed in user allowed to load this vending machines compartments? This only is ran if we are using a /obj/item/storage/bag to load the vending machine, and not a dedicated restocker.

Arguments:

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

proc
create_categories_from
(name, icon, products)

Returns a list of data about the category Arguments: name - string for the name of the category icon - string for the fontawesome icon to use in the UI for the category products - list of products available in the category

proc
deploy_credits
()

Drop credits when the vendor is attacked.

proc
dispense
(/datum/data/vending_product/item_record, /atom/spawn_location, silent, dispense_returned)

Common proc that dispenses an item. Called when the item is vended, or gotten some other way.

proc
fetch_balance_to_use
(/obj/item/card/id/passed_id)

Returns the balance that the vendor will use for proceeding payment. Most vendors would want to use the user's card's account credits balance. arguments: passed_id - the id card that will be billed for the product

proc
freebie
(freebies)

Dispenses free items from the standard stock. Arguments: freebies - number of free items to vend

proc
loadingAttempt
(/obj/item/inserted_item, /mob/user)

Tries to insert the item into the vendor, and depending on whether the product is a part of the vendor's stock or not, increments an already present product entry's available amount or creates a new entry. arguments: inserted_item - the item we're trying to insert user - mob who's trying to insert the item

proc
on_dispense
(/obj/item/vended_item, dispense_returned)

A proc meant to perform custom behavior on newly dispensed items.

proc
post_restock
(/mob/living/user, restocked)

After-effects of refilling a vending machine from a refill canister

This takes the amount of products restocked and gives the user our contained credits if needed, sending the user a fitting message.

Arguments:

user - the user restocking us
restocked - the amount of items we've been refilled with

proc
pre_throw
(/obj/item/thrown_item)

A callback called before an item is tossed out

Override this if you need to do any special case handling

Arguments:

thrown_item - obj/item being thrown

proc
proceed_payment
(/obj/item/card/id/paying_id_card, /mob/living/mob_paying, /datum/data/vending_product/product_to_vend, price_to_use, discountless)

Handles payment processing: discounts, logging, balance change etc. arguments: paying_id_card - the id card that will be billed for the product. mob_paying - the mob that is trying to purchase the item. product_to_vend - the product record of the item we're trying to vend. price_to_use - price of the item we're trying to vend. discountless - whether or not to apply discounts

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
reset_prices
(/list/recordlist, /list/premiumlist)

Reassign the prices of the vending machine as a result of the inflation value, as provided by SSeconomy

This rebuilds both /datum/data/vending_products lists for premium and standard products based on their most relevant pricing values. Arguments:

recordlist - the list of standard product datums in the vendor to refresh their prices.
premiumlist - the list of premium product datums in the vendor to refresh their prices.

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
select_colors
(/list/params)

Brings up a color config menu for the picked greyscaled item

proc
shock
(/mob/living/user, shock_chance)

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
shock_chance - 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

throw_impact
(/atom/hit_atom, /datum/thrownthing/throwingdatum)

Crush the mob that the vending machine got thrown at

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
tilt
(/atom/fatty, local_crit_chance, forced_crit, range)

Tilts ontop of the atom supplied, if crit is true some extra shit can happen. See [fall_and_crush] for return values. Arguments: fatty - atom to tilt the vendor onto local_crit_chance - percent chance of a critical hit forced_crit - specific critical hit case to use, if any range - the range of the machine when thrown if not adjacent

proc
total_loaded_stock
()

Returns the total amount of items in the vending machine based on the product records and premium records, but not contraband

proc
total_max_stock
()

Returns the total amount of items in the vending machine based on the product records and premium records, but not contraband

proc
unbuild_inventory
(/list/recordlist)

Given a record list, go through and return a list of products in format of type -> amount Arguments: recordlist - list of records to unbuild products from

proc
unbuild_inventory_into
(/list/product_records, /list/products, /list/product_categories)

Unbuild product_records into categorized product lists to the machine's refill canister. Does not handle contraband/premium products, only standard stock and any other categories used by the vendor(see: ClothesMate). If a product has no category, puts it into standard stock category. Arguments: product_records - list of products of the vendor products - list of products of the refill canister product_categories - list of product categories of the refill canister

proc
untilt
(/mob/user)

Rights the vendor up, unpinning mobs under it, if any. Arguments: user - mob that has untilted the vendor

proc
update_canister
()

Set up a refill canister that matches this machine's products

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

proc
vend
(/list/params, /list/greyscale_colors)

The entire shebang of vending the picked item. Processes the vending and initiates the payment for the item. arguments: greyscale_colors - greyscale config for the item we're about to vend, if any

proc
vend_greyscale
(/list/params, /datum/greyscale_modify_menu/menu)

Vends a greyscale modified item. arguments: menu - greyscale config menu that has been used to vend the item

vending machines /obj/machinery/vending

Vars

Procs

Var Details

var active

var age_restrictions

var all_products_free

var allow_custom

var bill – /obj/item/stack/spacecash

var coin – /obj/item/coin

var coin_records – /list

var contraband – /list

var credits_contained

var crit_chance

var default_price

var displayed_currency_icon

var displayed_currency_name

var extended_inventory

var extra_price

var forcecrit

var hidden_records – /list

var icon_deny

var icon_vend

var last_reply

var last_shopper

var last_slogan

var light_mask

var loaded_items

var num_shards

var onstation

var onstation_override

var panel_type

var pinned_mobs – /list

var premium – /list

var product_ads

var product_categories – /list

var product_records – /list

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 slogan_list – /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)

↑atom_break(damage_flag)

proc build_inventories(start_empty)

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

proc build_products_from_categories()

proc canLoadItem(/obj/item/loaded_item, /mob/user, send_message)

proc can_vend(user)

proc collect_records_for_static_data(/list/records, /list/categories, premium)

proc compartmentLoadAccessCheck(/mob/user)

proc create_categories_from(name, icon, products)

proc deploy_credits()

proc dispense(/datum/data/vending_product/item_record, /atom/spawn_location, silent, dispense_returned)

proc fetch_balance_to_use(/obj/item/card/id/passed_id)

proc freebie(freebies)

proc loadingAttempt(/obj/item/inserted_item, /mob/user)

proc on_dispense(/obj/item/vended_item, dispense_returned)

proc post_restock(/mob/living/user, restocked)

proc pre_throw(/obj/item/thrown_item)

proc proceed_payment(/obj/item/card/id/paying_id_card, /mob/living/mob_paying, /datum/data/vending_product/product_to_vend, price_to_use, discountless)

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

proc reset_prices(/list/recordlist, /list/premiumlist)

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

proc select_colors(/list/params)

proc shock(/mob/living/user, shock_chance)

proc speak(message)

throw_impact(/atom/hit_atom, /datum/thrownthing/throwingdatum)

vending machines
/obj/machinery/vending

var
active

var
age_restrictions

var
all_products_free

var
allow_custom

var
bill
– /obj/item/stack/spacecash

var
coin
– /obj/item/coin

var
coin_records
– /list

var
contraband
– /list

var
credits_contained

var
crit_chance

var
default_price

var
displayed_currency_icon

var
displayed_currency_name

var
extended_inventory

var
extra_price

var
forcecrit

var
hidden_records
– /list

var
icon_deny

var
icon_vend

var
last_reply

var
last_shopper

var
last_slogan

var
light_mask

var
loaded_items

var
num_shards

var
onstation

var
onstation_override

var
panel_type

var
pinned_mobs
– /list

var
premium
– /list

var
product_ads

var
product_categories
– /list

var
product_records
– /list

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
slogan_list
– /list

var
squish_damage

var
tiltable

var
tilted

var
tilted_rotation

var
vend_ready

var
vend_reply

var
vending_machine_input
– /list

↑
Initialize
(mapload)

↑
atom_break
(damage_flag)

proc
build_inventories
(start_empty)

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

proc
build_products_from_categories
()

proc
canLoadItem
(/obj/item/loaded_item, /mob/user, send_message)

proc
can_vend
(user)

proc
collect_records_for_static_data
(/list/records, /list/categories, premium)

proc
compartmentLoadAccessCheck
(/mob/user)

proc
create_categories_from
(name, icon, products)

proc
deploy_credits
()

proc
dispense
(/datum/data/vending_product/item_record, /atom/spawn_location, silent, dispense_returned)

proc
fetch_balance_to_use
(/obj/item/card/id/passed_id)

proc
freebie
(freebies)

proc
loadingAttempt
(/obj/item/inserted_item, /mob/user)

proc
on_dispense
(/obj/item/vended_item, dispense_returned)

proc
post_restock
(/mob/living/user, restocked)

proc
pre_throw
(/obj/item/thrown_item)

proc
proceed_payment
(/obj/item/card/id/paying_id_card, /mob/living/mob_paying, /datum/data/vending_product/product_to_vend, price_to_use, discountless)

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

proc
reset_prices
(/list/recordlist, /list/premiumlist)

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

proc
select_colors
(/list/params)

proc
shock
(/mob/living/user, shock_chance)

proc
speak
(message)

throw_impact
(/atom/hit_atom, /datum/thrownthing/throwingdatum)

proc
throw_item
()

proc
tilt
(/atom/fatty, local_crit_chance, forced_crit, range)

proc
total_loaded_stock
()

proc
total_max_stock
()