mentoring_book

Vars
allowed_uses	if limit_use is true, how many times should we be able to be used before disappearing
author_level	the skill level of the author minus one; people will be one level below the author
limit_uses	whether the book should have a limited amount of uses
reading_progress	Tracks reading progress per user (by ckey) so they can resume if interrupted
taught_language	if selected, this is the language that will be taught to the reader
taught_skill	the skill that is written within the book that will be taught
teach_sign	if selected, will teach sign-language-- because it isn't a language...?
writing_progress	Tracks writing progress per user (by ckey) so they can resume if interrupted
writing_sentences	the list of sentences sent to the author as they write the book
Procs
check_limit	will lower the use by one (if allowed) and check if it should be destroyed
do_progress_loop	Performs a progress-tracked loop of timed sentences, saving progress if interrupted.
give_experience	Gives experience to the person reading the book
timed_sentence	when given a message and an amount of time, requires the user to stand still while receiving the message

Var Details

var
allowed_uses

if limit_use is true, how many times should we be able to be used before disappearing

var
author_level

the skill level of the author minus one; people will be one level below the author

var
limit_uses

whether the book should have a limited amount of uses

var
reading_progress
– /list

Tracks reading progress per user (by ckey) so they can resume if interrupted

var
taught_language
– /datum/language

if selected, this is the language that will be taught to the reader

var
taught_skill
– /datum/skill

the skill that is written within the book that will be taught

var
teach_sign

if selected, will teach sign-language-- because it isn't a language...?

var
writing_progress
– /list

Tracks writing progress per user (by ckey) so they can resume if interrupted

var
writing_sentences
– /static/list

the list of sentences sent to the author as they write the book

Proc Details

proc
check_limit
(/mob/user)

will lower the use by one (if allowed) and check if it should be destroyed

proc
do_progress_loop
(/mob/user, /list/progress_list, /list/sentence_list, iterations, time_per_iteration, resume_message)

Performs a progress-tracked loop of timed sentences, saving progress if interrupted.

Arguments:

user - The mob performing the action
progress_list - The list to track progress in (reading_progress or writing_progress)
sentence_list - The list of sentences to randomly pick from
iterations - How many successful iterations are needed (default 5)
time_per_iteration - How long each iteration takes (default 60 SECONDS)
resume_message - Optional message shown when resuming from saved progress

Returns TRUE if all iterations completed, FALSE if interrupted

proc
give_experience
(/mob/living/user)

Gives experience to the person reading the book

proc
timed_sentence
(user, sent_message, time_amount)

when given a message and an amount of time, requires the user to stand still while receiving the message

mentoring_book /obj/item/mentoring_book

Vars

Procs

Var Details

var allowed_uses

var author_level

var limit_uses

var reading_progress – /list

var taught_language – /datum/language

var taught_skill – /datum/skill

var teach_sign

var writing_progress – /list

var writing_sentences – /static/list