Log external functions

Log externals are used to manipulate players log and to track quest progress.

Log_CreateTopic

Creates a new log topic with the name topicName under the section logSection

1

func void Log_CreateTopic(var string topicName, var int logSection) {};

• var string topicName
  Unique string used to identify and name the topic
• var int logSection
  Indicates in which section to create the topic in.
  Takes constants LOG_MISSION, LOG_NOTE as values

Log_AddEntry

Adds an entry to a log topic with the name topicName under the section logSection

1

func void Log_AddEntry(var string topicName, var string entry) {};

• var string topicName
  Unique string used to identify and name the topic
• var string entry
  Content of the new entry

1
2
3
4
5
6
7
8
9

func void B_LogEntry(var string topic, var string entry)
{
    PrintDebugNpc(PD_ZS_DETAIL, "B_LogEntry"); // Logging

    Log_AddEntry(topic, entry);

    PrintScreen(NAME_NewLogEntry, -1, _YPOS_MESSAGE_LOGENTRY, "font_old_10_white.tga", _TIME_MESSAGE_LOGENTRY);
    Snd_Play("LogEntry");
};

Log_SetTopicStatus

Changes the status of the topic with the name topicName

1

func void Log_SetTopicStatus(var string topicName, var int status) {};

• var string topicName
  Unique string used to identify and name the topic
• var int status
  The status to be set.
  Takes constants LOG_RUNNING, LOG_SUCCESS, LOG_FAILED, LOG_OBSOLETE as values

zParserExtender

The log external function selection is missing functions to retrieve the status of a log entry. There are only functions to read the log status (as discussed on Inside Gothic). As a result of this the original scriptwriters had to define additional variable to track the log status in the scripts, even though the value is being already tracked by the engine. zParserExtender fixes this by introducing new log external functions.

Externals with docu comments

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

/// Creates a new log topic with the name `topicName` under the section `logSection`
/// 
/// @param topicName unique string used to identify and name the topic
/// @param logSection [LOG_MISSION, LOG_NOTE] indicates in which section to create the topic in
func void Log_CreateTopic(var string topicName, var int logSection) {};

/// Creates a new log topic with the name `topicName` under the section `logSection`
/// 
/// @param topicName unique string used to identify and name the topic
/// @param logSection [LOG_MISSION, LOG_NOTE] indicates in which section to create the topic in
func void Log_AddEntry(var string topicName, var string entry) {};

/// Changes the status of the topic with the name `topicName`
///
/// @param topicName unique string used to identify and name the topic
/// @param status [LOG_RUNNING, LOG_SUCCESS, LOG_FAILED, LOG_OBSOLETE] the status to be set
func void Log_SetTopicStatus(var string topicName, var int status) {};