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
exploded_turfs	If explosive_malus is true, this will be used to keep track of the turfs where an explosion happened for when we'll spawn the loot.
explosive_malus	It true, repeated and large explosions won't be as efficient. This is usually for fish sources that cover multiple turfs (i.e. rivers, oceans).
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
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	Comsig proc from the fishing minigame for 'calculate_difficulty'
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_reward	Returns a typepath or a special value which we use for spawning 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
exploded_turfs
– /list

If explosive_malus is true, this will be used to keep track of the turfs where an explosion happened for when we'll spawn the loot.

var
explosive_malus
–

It true, repeated and large explosions won't be as efficient. This is usually for fish sources that cover multiple turfs (i.e. rivers, oceans).

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
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, /datum/fishing_challenge/challenge)

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, /list/difficulty_holder)

Comsig proc from the fishing minigame for 'calculate_difficulty'

proc
dispense_reward
(reward_path, /mob/fisherman, /turf/fishing_spot)

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
()

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
()

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
(/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_reward
(/obj/item/fishing_rod/rod, /mob/fisherman, /atom/location)

Returns a typepath or a special value which we use for spawning 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, /turf/fishing_spot)

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

proc
spawn_reward
(reward_path, /atom/spawn_location, /turf/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 exploded_turfs – /list

var explosive_malus –

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 weight_leveling_exponents – /static

var weight_result_multiplier – /static

Proc Details

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

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

proc dispense_reward(reward_path, /mob/fisherman, /turf/fishing_spot)

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()

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

proc has_known_fishes()

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(/obj/item/fish/fish, /mob/living/releaser)

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

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, /turf/fishing_spot)

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