fish_source

Where the fish actually come from - every fishing spot has one assigned but multiple fishing holes can share single source, ie single shared one for ocean/lavaland river

Vars
background	Background image name from /datum/asset/simple/fishing_minigame
catalog_description	How the spot type is described in fish catalog section about fish sources, will be skipped if null
currently_on_regen	A list of stuff that's currently waiting to be readded to fish_counts
duds	Text shown as baloon alert when you roll a dud in the table
explosive_fishing_score	If FISH_SOURCE_FLAG_EXPLOSIVE_MALUS is set, this will track of how much we're "exhausting" the system by bombing it repeatedly.
fish_count_regen	Any limited quantity stuff in this list will be readded to the counts after a while
fish_counts	If a key from fish_table is present here, that fish is availible in limited quantity and is reduced by one on successful fishing
fish_table	Fish catch weight table - these are relative weights
fishing_difficulty	Baseline difficulty for fishing in this spot. THIS IS ADDED TO THE DEFAULT DIFFICULTY OF THE MINIGAME (15)
overlay_state	When selected by the fishing portal, this will be the icon_state of the overlay shown on the machine.
profound_fisher_blacklist	Mindless mobs that can fish will never pull up items on this list
radial_state	When linked to a fishing portal, this will be the icon_state of this option in the radial menu
wait_time_range	If set, this overrides the upper and lower bounds of how long you should wait during the waiting phase of the minigame.
weight_leveling_exponents	List of exponents used to level out the table weight differences between fish depending on bait quality.
weight_result_multiplier	List of multipliers used to make fishes more common compared to everything else depending on bait quality, indexed from best to worst.
Procs
calculate_difficulty	Calculates the difficulty of the minigame:
calculate_difficulty_minigame	Calculates the difficulty of the minigame:
dispense_reward	Gives out the reward if possible
generate_wiki_contents	Called by /datum/autowiki/fish_sources unless the catalog entry for this fish source is null. It should Return a list of entries with keys named "name", "icon", "weight" and "notes" detailing the contents of this fish source.
get_catchable_fish_names	Add a string with the names of catchable fishes to the examine text.
get_fish_table	Returns the fish table, with with the unavailable items from fish_counts removed.
get_modified_fish_table	Builds a fish weights table modified by bait/rod/user properties
has_known_fishes	returns true if this fishing spot has fish that are shown in the catalog.
interrupt_challenge	Proc called when the challenge is interrupted within the fish source code.
level_out_fish	A proc that levels out the weights of various fish, leading to rarer fishes being more common.
on_challenge_completed	Proc called when the COMSIG_MOB_COMPLETE_FISHING signal is sent. Check if we've succeeded. If so, write into memory and dispense the reward.
on_fishing_spot_del	Called whenever a fishing spot with this fish source attached is deleted
on_fishing_spot_init	Called when src is set as the fish source of a fishing spot component
on_start_fishing	Called below above proc, in case the fishing source has anything to do that isn't denial
pre_challenge_started	Used to register signals or add traits and the such right after conditions have been cleared and before the minigame starts.
readd_fish	Called when releasing a fish in a fishing spot with the TRAIT_CATCH_AND_RELEASE trait.
reason_we_cant_fish	Can we fish in this spot at all. Returns DENIAL_REASON or null if we're good to go
roll_mindless_reward	Version of roll_reward() that blacklists objects that shouldn't be caught by ai-controlled mobs.
roll_reward	Returns a typepath, instance or another special value which we use for dispensing a reward later.
roll_reward_minigame	Comsig proc from the fishing minigame for 'roll_reward'
simple_dispense_reward	Simplified version of dispense_reward that doesn't need a fisherman.
spawn_reward	Spawns a reward from a atom path right where the fisherman is. Part of the dispense_reward() logic.

Var Details

var
background

Background image name from /datum/asset/simple/fishing_minigame

var
catalog_description

How the spot type is described in fish catalog section about fish sources, will be skipped if null

var
currently_on_regen
– /list

A list of stuff that's currently waiting to be readded to fish_counts

var
duds

Text shown as baloon alert when you roll a dud in the table

var
explosive_fishing_score

If FISH_SOURCE_FLAG_EXPLOSIVE_MALUS is set, this will track of how much we're "exhausting" the system by bombing it repeatedly.

var
fish_count_regen
– /list

Any limited quantity stuff in this list will be readded to the counts after a while

var
fish_counts
– /list

If a key from fish_table is present here, that fish is availible in limited quantity and is reduced by one on successful fishing

var
fish_table
– /list

Fish catch weight table - these are relative weights

var
fishing_difficulty

Baseline difficulty for fishing in this spot. THIS IS ADDED TO THE DEFAULT DIFFICULTY OF THE MINIGAME (15)

var
overlay_state

When selected by the fishing portal, this will be the icon_state of the overlay shown on the machine.

var
profound_fisher_blacklist
– /static/list

Mindless mobs that can fish will never pull up items on this list

var
radial_state

When linked to a fishing portal, this will be the icon_state of this option in the radial menu

var
wait_time_range
– /list

If set, this overrides the upper and lower bounds of how long you should wait during the waiting phase of the minigame.

var
weight_leveling_exponents
– /static

List of exponents used to level out the table weight differences between fish depending on bait quality.

var
weight_result_multiplier
– /static

List of multipliers used to make fishes more common compared to everything else depending on bait quality, indexed from best to worst.

Proc Details

proc
calculate_difficulty
(result, /obj/item/fishing_rod/rod, /mob/fisherman)

Calculates the difficulty of the minigame:

This includes the source's fishing difficulty, that of the fish, the rod, favorite and disliked baits, fish traits and the fisherman skill.

For non-fish, it's just the source's fishing difficulty minus the fisherman skill.

proc
calculate_difficulty_minigame
(/datum/fishing_challenge/challenge, reward_path, /obj/item/fishing_rod/rod, /mob/fisherman)

Calculates the difficulty of the minigame:

This includes the source's fishing difficulty, that of the fish, the rod, favorite and disliked baits, fish traits and the fisherman skill.

This is the version to call while we are in the fishing minigame phase.

proc
dispense_reward
(reward_path, /mob/fisherman, /atom/fishing_spot, /obj/item/fishing_rod/rod)

Gives out the reward if possible

proc
generate_wiki_contents
(/datum/autowiki/fish_sources/wiki)

Called by /datum/autowiki/fish_sources unless the catalog entry for this fish source is null. It should Return a list of entries with keys named "name", "icon", "weight" and "notes" detailing the contents of this fish source.

proc
get_catchable_fish_names
(/mob/user, /atom/location, /list/examine_text)

Add a string with the names of catchable fishes to the examine text.

proc
get_fish_table
(/atom/location, from_explosion)

Returns the fish table, with with the unavailable items from fish_counts removed.

proc
get_modified_fish_table
(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

Builds a fish weights table modified by bait/rod/user properties

proc
has_known_fishes
(/atom/location)

returns true if this fishing spot has fish that are shown in the catalog.

proc
interrupt_challenge
(reason)

Proc called when the challenge is interrupted within the fish source code.

proc
level_out_fish
(/list/table, exponent)

A proc that levels out the weights of various fish, leading to rarer fishes being more common.

proc
on_challenge_completed
(/mob/user, /datum/fishing_challenge/challenge, success)

Proc called when the COMSIG_MOB_COMPLETE_FISHING signal is sent. Check if we've succeeded. If so, write into memory and dispense the reward.

proc
on_fishing_spot_del
(/datum/component/fishing_spot/spot)

Called whenever a fishing spot with this fish source attached is deleted

proc
on_fishing_spot_init
(/datum/component/fishing_spot/spot)

Called when src is set as the fish source of a fishing spot component

proc
on_start_fishing
(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/parent)

Called below above proc, in case the fishing source has anything to do that isn't denial

proc
pre_challenge_started
(/obj/item/fishing_rod/rod, /mob/user, /datum/fishing_challenge/challenge)

Used to register signals or add traits and the such right after conditions have been cleared and before the minigame starts.

proc
readd_fish
(/atom/location, /obj/item/fish/fish, /mob/living/releaser)

Called when releasing a fish in a fishing spot with the TRAIT_CATCH_AND_RELEASE trait.

proc
reason_we_cant_fish
(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/parent)

Can we fish in this spot at all. Returns DENIAL_REASON or null if we're good to go

proc
roll_mindless_reward
(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

Version of roll_reward() that blacklists objects that shouldn't be caught by ai-controlled mobs.

proc
roll_reward
(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

Returns a typepath, instance or another special value which we use for dispensing a reward later.

proc
roll_reward_minigame
(/datum/source, /obj/item/fishing_rod/rod, /mob/fisherman, /atom/location, /list/rewards)

Comsig proc from the fishing minigame for 'roll_reward'

proc
simple_dispense_reward
(reward_path, /atom/spawn_location, /atom/fishing_spot)

Simplified version of dispense_reward that doesn't need a fisherman.

proc
spawn_reward
(reward_path, /atom/spawn_location, /atom/fishing_spot)

Spawns a reward from a atom path right where the fisherman is. Part of the dispense_reward() logic.

fish_source /datum/fish_source

Vars

Procs

Var Details

var background

var catalog_description

var currently_on_regen – /list

var duds

var explosive_fishing_score

var fish_count_regen – /list

var fish_counts – /list

var fish_table – /list

var fishing_difficulty

var overlay_state

var profound_fisher_blacklist – /static/list

var radial_state

var wait_time_range – /list

var weight_leveling_exponents – /static

var weight_result_multiplier – /static

Proc Details

proc calculate_difficulty(result, /obj/item/fishing_rod/rod, /mob/fisherman)

proc calculate_difficulty_minigame(/datum/fishing_challenge/challenge, reward_path, /obj/item/fishing_rod/rod, /mob/fisherman)

proc dispense_reward(reward_path, /mob/fisherman, /atom/fishing_spot, /obj/item/fishing_rod/rod)

proc generate_wiki_contents(/datum/autowiki/fish_sources/wiki)

proc get_catchable_fish_names(/mob/user, /atom/location, /list/examine_text)

proc get_fish_table(/atom/location, from_explosion)

proc get_modified_fish_table(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

proc has_known_fishes(/atom/location)

proc interrupt_challenge(reason)

proc level_out_fish(/list/table, exponent)

proc on_challenge_completed(/mob/user, /datum/fishing_challenge/challenge, success)

proc on_fishing_spot_del(/datum/component/fishing_spot/spot)

proc on_fishing_spot_init(/datum/component/fishing_spot/spot)

proc on_start_fishing(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/parent)

proc pre_challenge_started(/obj/item/fishing_rod/rod, /mob/user, /datum/fishing_challenge/challenge)

proc readd_fish(/atom/location, /obj/item/fish/fish, /mob/living/releaser)

proc reason_we_cant_fish(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/parent)

proc roll_mindless_reward(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

proc roll_reward(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

proc roll_reward_minigame(/datum/source, /obj/item/fishing_rod/rod, /mob/fisherman, /atom/location, /list/rewards)

proc simple_dispense_reward(reward_path, /atom/spawn_location, /atom/fishing_spot)

proc spawn_reward(reward_path, /atom/spawn_location, /atom/fishing_spot)