merchant

Vars
_hub_ref	A weakref to the currently connected trade hub, if any.
_merchant_ref	A weakref to the merchant that is currently being interacted with, if any.
_pad_ref	A weakref to the merchant pad next to the console, if any.
last_comms	Holds a string containing the most recent 'message' sent to the player from the merchant.
prompt_message	If not null, the UI window will show the message inside this var, until the player clicks the 'Continue' button.
stored_cash	Holds cash used to trade with merchants, in the format of `/decl/currency/foo = 5000`.
Procs
adjust_cash	Changes how much of a specific currency the computer contains, removing it entirely if it runs out.
ask_appraisal	Asks the merchant to say how much they would pay for everything on the merchant pad, assuming they want it.
ask_duration_of_stay	Asks how long the merchant is gonna stick around for.
ask_price	Called when the user clicks on the button to ask for an item's price on the UI.
ask_what_they_want	Asks the merchant what items they want to buy.
attempt_barter	Attempts to trade for a specific item from the merchant, in exchange for all of the items on the pad.
attempt_gift	Attempts to give everything on the merchant pad away for free.
attempt_purchase	Attempts to purchase a specific item from the merchant, using money.
attempt_sell	Attempts to sell everything on the merchant pad, in exchange for money.
bribe_merchant	Called when the user clicks one of the bribe buttons in the UI.
check_hub	Checks whether the inputted trade hub is valid to trade with.
check_items_on_pad	Checks that everything on top of the pad are things the merchant won't object to receiving.
check_merchant_disconnection	Returns TRUE if the merchant is fed up and cuts the connection.
compliment_merchant	Called when the user clicks the compliment button in the UI.
connect_to_hub	Connects to the targeted hub.
delete_items_on_pad	Deletes all valid objects on top of the merchant pad. Called when the user successfully sell to or barters with a merchant.
deposit_cash	Places cash objects that are on top of the pad into the `stored_cash` list.
get_cash	Returns how much of a specific currency the computer currently contains.
haggle_buy	Attempts to buy a specific item from the merchant, at a price defined by the user, using money.
haggle_sell	Attempts to sell everything on the merchant pad, at a price defined by the user, in exchange for money.
hail_merchant	Attempts to hail the target merchant.
handle_no_common_language	Called when the merchant receives a question from the user, when the user doesn't speak any of their languages.
insult_merchant	Called when the user clicks the insult button in the UI, or rarely if they don't speak any of the merchant's languages.
print_price_modifiers	Returns a string describing all of the price modifiers in the inputted list. You probably don't want to show `[supply\|demand]_price_modifiers` to players, since it might be weird to be told that a merchant is charging XX% more because the player had low finance skill.
scroll_merchant_selection	Called when the user clicks one of the two arrows in the UI to 'scroll' to different available merchants.
withdraw_cash	Removes the cash held inside of `stored_cash` back onto the pad.

Var Details

var
_hub_ref
– /weakref

A weakref to the currently connected trade hub, if any.

var
_merchant_ref
– /weakref

A weakref to the merchant that is currently being interacted with, if any.

var
_pad_ref
– /weakref

A weakref to the merchant pad next to the console, if any.

var
last_comms

Holds a string containing the most recent 'message' sent to the player from the merchant.

var
prompt_message

If not null, the UI window will show the message inside this var, until the player clicks the 'Continue' button.

var
stored_cash
– /list

Holds cash used to trade with merchants, in the format of /decl/currency/foo = 5000.

Proc Details

proc
adjust_cash
(/decl/currency/currency_type, amount)

Changes how much of a specific currency the computer contains, removing it entirely if it runs out.

proc
ask_appraisal
(/mob/user, /datum/merchant/target_merchant)

Asks the merchant to say how much they would pay for everything on the merchant pad, assuming they want it.

proc
ask_duration_of_stay
(/mob/user, /datum/merchant/target_merchant)

Asks how long the merchant is gonna stick around for.

proc
ask_price
(/mob/user, /datum/merchant/target_merchant, index)

Called when the user clicks on the button to ask for an item's price on the UI.

proc
ask_what_they_want
(/mob/user, /datum/merchant/target_merchant)

Asks the merchant what items they want to buy.

proc
attempt_barter
(/mob/user, /datum/merchant/target_merchant, index)

Attempts to trade for a specific item from the merchant, in exchange for all of the items on the pad.

proc
attempt_gift
(/mob/user, /datum/merchant/target_merchant)

Attempts to give everything on the merchant pad away for free.

proc
attempt_purchase
(/mob/user, /datum/merchant/target_merchant, index, offered_price)

Attempts to purchase a specific item from the merchant, using money.

proc
attempt_sell
(/mob/user, /datum/merchant/target_merchant, offered_price)

Attempts to sell everything on the merchant pad, in exchange for money.

proc
bribe_merchant
(/mob/user, /datum/merchant/target_merchant, index)

Called when the user clicks one of the bribe buttons in the UI.

proc
check_hub
(/datum/trade_hub/supplied_hub)

Checks whether the inputted trade hub is valid to trade with.

proc
check_items_on_pad
(/list/items, /mob/user, /datum/merchant/target_merchant)

Checks that everything on top of the pad are things the merchant won't object to receiving.

proc
check_merchant_disconnection
(/mob/user, /datum/merchant/target_merchant)

Returns TRUE if the merchant is fed up and cuts the connection.

proc
compliment_merchant
(/mob/user, /datum/merchant/target_merchant)

Called when the user clicks the compliment button in the UI.

proc
connect_to_hub
(/datum/trade_hub/target_hub)

Connects to the targeted hub.

proc
delete_items_on_pad
(/mob/user, /datum/merchant/target_merchant)

Deletes all valid objects on top of the merchant pad. Called when the user successfully sell to or barters with a merchant.

proc
deposit_cash
()

Places cash objects that are on top of the pad into the stored_cash list.

proc
get_cash
(/decl/currency/currency_type)

Returns how much of a specific currency the computer currently contains.

proc
haggle_buy
(/mob/user, /datum/merchant/target_merchant, index)

Attempts to buy a specific item from the merchant, at a price defined by the user, using money.

proc
haggle_sell
(/mob/user, /datum/merchant/target_merchant)

Attempts to sell everything on the merchant pad, at a price defined by the user, in exchange for money.

proc
hail_merchant
(/mob/user, /datum/merchant/target_merchant)

Attempts to hail the target merchant.

proc
handle_no_common_language
(/mob/user, /datum/merchant/target_merchant)

Called when the merchant receives a question from the user, when the user doesn't speak any of their languages.

proc
insult_merchant
(/mob/user, /datum/merchant/target_merchant)

Called when the user clicks the insult button in the UI, or rarely if they don't speak any of the merchant's languages.

proc
print_price_modifiers
(/list/price_modifiers, /mob/user, always_display)

Returns a string describing all of the price modifiers in the inputted list. You probably don't want to show [supply|demand]_price_modifiers to players, since it might be weird to be told that a merchant is charging XX% more because the player had low finance skill.

proc
scroll_merchant_selection
(scroll_direction)

Called when the user clicks one of the two arrows in the UI to 'scroll' to different available merchants.

proc
withdraw_cash
()

Removes the cash held inside of stored_cash back onto the pad.

merchant /datum/computer_file/program/merchant

Vars

Procs

Var Details

var _hub_ref – /weakref

var _merchant_ref – /weakref

var _pad_ref – /weakref

var last_comms

var prompt_message

var stored_cash – /list

Proc Details

proc adjust_cash(/decl/currency/currency_type, amount)

proc ask_appraisal(/mob/user, /datum/merchant/target_merchant)

proc ask_duration_of_stay(/mob/user, /datum/merchant/target_merchant)

proc ask_price(/mob/user, /datum/merchant/target_merchant, index)

proc ask_what_they_want(/mob/user, /datum/merchant/target_merchant)

proc attempt_barter(/mob/user, /datum/merchant/target_merchant, index)

proc attempt_gift(/mob/user, /datum/merchant/target_merchant)

proc attempt_purchase(/mob/user, /datum/merchant/target_merchant, index, offered_price)

proc attempt_sell(/mob/user, /datum/merchant/target_merchant, offered_price)

proc bribe_merchant(/mob/user, /datum/merchant/target_merchant, index)

proc check_hub(/datum/trade_hub/supplied_hub)

proc check_items_on_pad(/list/items, /mob/user, /datum/merchant/target_merchant)

proc check_merchant_disconnection(/mob/user, /datum/merchant/target_merchant)

proc compliment_merchant(/mob/user, /datum/merchant/target_merchant)

proc connect_to_hub(/datum/trade_hub/target_hub)

proc delete_items_on_pad(/mob/user, /datum/merchant/target_merchant)

proc deposit_cash()

proc get_cash(/decl/currency/currency_type)

proc haggle_buy(/mob/user, /datum/merchant/target_merchant, index)

proc haggle_sell(/mob/user, /datum/merchant/target_merchant)

proc hail_merchant(/mob/user, /datum/merchant/target_merchant)

proc handle_no_common_language(/mob/user, /datum/merchant/target_merchant)

proc insult_merchant(/mob/user, /datum/merchant/target_merchant)

proc print_price_modifiers(/list/price_modifiers, /mob/user, always_display)

proc scroll_merchant_selection(scroll_direction)

proc withdraw_cash()