language_holder

Vars
best_mutual_languages	Cached form of the mutual language list which only contains the best understanding available to each language
blocked_languages	Lazyassoclist of blocked languages. Used to prevent understanding and speaking certain languages, ie for certain mobs, mutations etc.
language_menu	Handles displaying the language menu UI.
mutual_understanding	Lazyassoclist of all mutual understanding this holder has You generally don't want to access this, you want [best_mutual_languages] instead Format: list(language_type = list(source = % of understanding))
omnitongue	If true, overrides tongue aforementioned limitations.
owner	Tracks the entity that owns the holder.
selected_language	Currently spoken language
spoken_languages	Lazyassoclist of languages that can be spoken. Tongue organ may also set limits beyond this list.
understood_languages	Lazyassoclist of all understood languages
Procs
New	Initializes, and copies in the languages from the current atom if available.
add_blocked_language	Adds a single language or list of languages to the blocked language list.
calculate_best_mutual_language	Calculates the "best mutual language list"
can_speak_language	Checks if you can speak the language. Tongue limitations should be supplied as an argument.
copy_languages	Copies all languages from the supplied atom/language holder. Source should be overridden when you do not want the language overwritten by later atom updates or want to avoid blocked languages.
gain_partial_understanding_from_language	Helper to get all the partial understanding from the passed language Does effectively nothing if given a language already understood
get_random_spoken_language	Gets a random spoken language, useful for forced speech and such.
get_random_spoken_uncommon_language	Gets a random spoken language, trying to get a non-common language.
get_random_understood_language	Gets a random understood language, useful for hallucinations and such.
get_selected_language	Returns selected language if it can be spoken, or decides, sets and returns a new selected language if possible.
grant_all_languages	Grants every language to understood and spoken, and gives omnitongue.
grant_language	Grants the supplied language.
grant_partial_language	Grants partial understanding of the passed language. Giving 100 understanding is basically equivalent to knowning the language, just with butchered punctuation.
has_language	Checks if you have the language passed.
lose_partial_understanding_from_language	Helper to remove all the partial understanding from the passed language
open_language_menu	Opens a language menu reading from the language holder.
remove_all_languages	Removes every language and optionally sets omnitongue false. If a non default source is supplied, only removes that source.
remove_all_partial_languages	Removes all partial understandings of all languages.
remove_blocked_language	Removes a single language or list of languages from the blocked language list.
remove_language	Removes a single language or source, removing all sources returns the pre-removal state of the language.
remove_partial_language	Removes partial understanding of the passed language.
transfer_mind_languages	Transfers all mind languages to the supplied language holder.

Var Details

var
best_mutual_languages
– /final/list

Cached form of the mutual language list which only contains the best understanding available to each language

var
blocked_languages
– /list

Lazyassoclist of blocked languages. Used to prevent understanding and speaking certain languages, ie for certain mobs, mutations etc.

Handles displaying the language menu UI.

var
mutual_understanding
– /list

Lazyassoclist of all mutual understanding this holder has You generally don't want to access this, you want [best_mutual_languages] instead Format: list(language_type = list(source = % of understanding))

var
omnitongue

If true, overrides tongue aforementioned limitations.

var
owner
– /final/atom/movable

Tracks the entity that owns the holder.

var
selected_language

Currently spoken language

var
spoken_languages
– /list

Lazyassoclist of languages that can be spoken. Tongue organ may also set limits beyond this list.

var
understood_languages
– /list

Lazyassoclist of all understood languages

Proc Details

New
(/atom/new_owner)

Initializes, and copies in the languages from the current atom if available.

proc
add_blocked_language
(languages, source)

Adds a single language or list of languages to the blocked language list.

proc
calculate_best_mutual_language
()

Calculates the "best mutual language list"

proc
can_speak_language
(language)

Checks if you can speak the language. Tongue limitations should be supplied as an argument.

proc
copy_languages
(/datum/language_holder/from_holder, source_override)

Copies all languages from the supplied atom/language holder. Source should be overridden when you do not want the language overwritten by later atom updates or want to avoid blocked languages.

proc
gain_partial_understanding_from_language
(language)

Helper to get all the partial understanding from the passed language Does effectively nothing if given a language already understood

proc
get_random_spoken_language
()

Gets a random spoken language, useful for forced speech and such.

proc
get_random_spoken_uncommon_language
()

Gets a random spoken language, trying to get a non-common language.

proc
get_random_understood_language
()

Gets a random understood language, useful for hallucinations and such.

proc
get_selected_language
()

Returns selected language if it can be spoken, or decides, sets and returns a new selected language if possible.

proc
grant_all_languages
(language_flags, grant_omnitongue, source)

Grants every language to understood and spoken, and gives omnitongue.

proc
grant_language
(language, language_flags, source)

Grants the supplied language.

proc
grant_partial_language
(language, amount, source)

Grants partial understanding of the passed language. Giving 100 understanding is basically equivalent to knowning the language, just with butchered punctuation.

proc
has_language
(language, flag_to_check)

Checks if you have the language passed.

proc
lose_partial_understanding_from_language
(language)

Helper to remove all the partial understanding from the passed language

proc
open_language_menu
(/mob/user)

Opens a language menu reading from the language holder.

proc
remove_all_languages
(source, remove_omnitongue)

Removes every language and optionally sets omnitongue false. If a non default source is supplied, only removes that source.

proc
remove_all_partial_languages
(source)

Removes all partial understandings of all languages.

proc
remove_blocked_language
(languages, source)

Removes a single language or list of languages from the blocked language list.

proc
remove_language
(language, language_flags, source)

Removes a single language or source, removing all sources returns the pre-removal state of the language.

proc
remove_partial_language
(language, source)

Removes partial understanding of the passed language.

proc
transfer_mind_languages
(/datum/language_holder/to_holder)

Transfers all mind languages to the supplied language holder.

language_holder /datum/language_holder

Vars

Procs

Var Details

var best_mutual_languages – /final/list

var blocked_languages – /list

var language_menu – /final/datum/language_menu

var mutual_understanding – /list

var omnitongue

var owner – /final/atom/movable

var selected_language

var spoken_languages – /list

var understood_languages – /list

Proc Details

New(/atom/new_owner)

proc add_blocked_language(languages, source)

proc calculate_best_mutual_language()

proc can_speak_language(language)

proc copy_languages(/datum/language_holder/from_holder, source_override)

proc gain_partial_understanding_from_language(language)

proc get_random_spoken_language()

proc get_random_spoken_uncommon_language()

proc get_random_understood_language()

proc get_selected_language()

proc grant_all_languages(language_flags, grant_omnitongue, source)

proc grant_language(language, language_flags, source)

proc grant_partial_language(language, amount, source)

proc has_language(language, flag_to_check)

proc lose_partial_understanding_from_language(language)

proc open_language_menu(/mob/user)

proc remove_all_languages(source, remove_omnitongue)

proc remove_all_partial_languages(source)

proc remove_blocked_language(languages, source)

proc remove_language(language, language_flags, source)

proc remove_partial_language(language, source)

proc transfer_mind_languages(/datum/language_holder/to_holder)