responses.txt: Difference between revisions

From OpenKore Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 37: Line 37:
----
----


Sometimes, responses need current information about Kore that must be included in messages. Kore provides several variables that you can include in responses. When used in a response, Kore substitutes actual values for these variables before sending them to the player who issued the chat command. Variables are prefixed with '''%$''':
Sometimes, responses need current information about Kore that must be included in messages. Kore provides several variables that you can include in responses. When used in a response, Kore substitutes actual values for these variables before sending them to the player who issued the chat command. Variables are prefixed with '''%$'''.




Line 379: Line 379:
:This response is used when the chat command where requests for Kore's current location, i.e. x-coordinate ('''%$x'''), y-coordinate ('''%$y'''), and map ('''%$map''').
:This response is used when the chat command where requests for Kore's current location, i.e. x-coordinate ('''%$x'''), y-coordinate ('''%$y'''), and map ('''%$map''').


[[Category:Control]]
[[Category:control]]

Latest revision as of 23:50, 26 April 2021

When Kore received a chat command from an authorized player, it will respond to notify the sender whether the command succeeded or failed. The file responses.txt allows you to modify Kore's default responses to Chat Commands.

Aside from responses to Chat Commands, you can also configure Kore's automatic responses when a player uses Heal, Increase AGI, or Blessing on you or the monster you are attacking (see autoResponseOnHeal in config.txt).

Syntax

The format of this file is simply a set of lines that observes the following syntax:

<response tag> <message>

Details


<response tag>
This is one of the pre-defined response tags that determines on what events the response will be used and what type of message is expected. See the response list below for a complete list of available response tags.


<message>
This is the message to be used as response.


Other Notes

Chat Commands can either succeed or fail, and sometimes there are different ways of succeeding or failing. The succeed response tags have an appended S, and possibly a number if there are more than one way for a command to succeed. The failing response tags have an appended F, and possibly a number if there are more than one way for a command to fail:

Example:

commandS1 Succeed text

Random Response


You can specify multiple messages for one response tag. If you specify two or more of the same response tags, a random response will be chosen from the group:

Example:

somethingF1 Sorry, you suck.
somethingF1 You really do suck.

Variables


Sometimes, responses need current information about Kore that must be included in messages. Kore provides several variables that you can include in responses. When used in a response, Kore substitutes actual values for these variables before sending them to the player who issued the chat command. Variables are prefixed with %$.


Response List

authS (<message>)
This response is used when a player sent Kore a private message containing the adminPassword and was successfully authorized to use chat commands.




confS1 (<message>)
This response is used when the chat command conf requests for the current value (%$value) of a configuration key (%$key).




confS2 (<message>)
This response is used when the chat command conf successfully made Kore change a configuration key.




confF1 (<message>)
This response is used when the chat command conf failed because it does not specify a configuration key.




confF2 (<message>)
This response is used when the chat command conf failed because it tries to change a configuration key that does not exist.




confF3 (<message>)
This response is used when the chat command conf failed because it tries to request for Kore's username and password. Kore won't disclose its username and password to protect the user.




dateS (<message>)
This response is used when the chat command date requests for the current date and time (%$date).




followS (<message>)
This response is used when the chat command follow successfully set Kore to follow a player.




followF (<message>)
This response is used when the chat command follow failed because Kore can't find the player to be followed.




followStopS (<message>)
This response is used when the chat command stop follow stop successfully set Kore to stop following a player.




followStopF (<message>)
This response is used when the chat command follow stop failed because follow mode is already off.




healS (<message>)
This response is used when the chat command heal, agi, bless, kyrie, or mag successfully made Kore use a supportive skill on a player.




healF1 (<message>)
This response is used when the chat command heal, agi, bless, kyrie, or mag failed because Kore can't find the player to use the skill on.




healF2 (<message>)
This response is used when the chat command heal, agi, bless, kyrie, or mag failed because Kore has insufficient SP (%$char_sp).




healF3 (<message>)
This response is used when the chat command heal, agi, bless, kyrie, or mag failed because Kore does not have the supportive skill the command asks Kore to use.




lookS (<message>)
This response is used when the chat command look successfully made Kore look to a certain direction.




lookF (<message>)
This response is used when the chat command look failed because it does not specify a body direction.




moveS (<message>)
This response is used when the chat command move successfully set Kore to move to a new location; command stop (or stop move stop) successfully stopped Kore's movement; or command town successfully made Kore respawn.




moveF (<message>)
This response is used when the chat command move failed because it does not specify a valid coordinate or map name.




quitS (<message>)
This response is used when the chat command logout successfully made Kore quit.




reloadS (<message>)
This response is used when the chat command reload successfully made Kore reload config and table files.




relogS (<message>)
This response is used when the chat command relog successfully made Kore logout and relogin.




sitS (<message>)
This response is used when the chat command sit successfully made Kore sit.




skillbadM (<message>)
This response is used when a player uses Heal, Increase AGI, or Blessing on the monster Kore is currently attacking.
Notes
  • autoResponseOnHeal in config.txt must be enabled or this response will not be used.
  • This response will be sent as private message.
  • There are no defined variables for this response, you can't even use %$cmd_user for this so don't even try.




skillgoodM (<message>)
This response is used when a player uses Heal, Increase AGI, or Blessing on Kore.
Notes
  • autoResponseOnHeal in config.txt must be enabled or this response will not be used.
  • This response will be sent as private message.
  • There are no defined variables for this response, you can't even use %$cmd_user for this so don't even try.




standS (<message>)
This response is used when the chat command stand successfully made Kore stand.




statusS (<message>)
This response is used when the chat command status inquires about Kore's basic information. The following variables contain useful information about Kore that should be included in this response:
Variable Description
%$char_hp Current HP.
%$char_hp_max Max HP.
%$char_sp Current SP.
%$char_sp_max Max SP.
%$char_lv Base level.
%$char_lv_job Job level.
%$char_exp Current base experience.
%$char_exp_max The total base experience required to gain the next level.
%$char_exp_job_max Current job experience.
%$char_exp_job_max The total job experience required to gain the next job level.
%$char_weight Current weight.
%$char_weight_max Max weight
%$zenny Current zenny.




tankS (<message>)
This response is used when the chat command tank successfully set Kore to tank for a player.




tankF (<message>)
This response is used when the chat command tank failed it can't find the player to tank for.




tankStopS (<message>)
This response is used when the chat command tank stop successfully set Kore to stop tanking.




tankStopF (<message>)
This response is used when the chat command tank stop failed to stop tanking because tank mode is already off.




thankS (<message>)
This response is used when the chat command thank, thn, or thx is received.




timeoutS1 (<message>)
This response is used when the chat command timeout requests for the current value (%$value) of a timeout key (%$key).




timeoutS2 (<message>)
This response is used when the chat command timeout successfully made Kore change a timeout key.




timeoutF1 (<message>)
This response is used when the chat command timeout failed because it does not specify a timeout key.




timeoutF2 (<message>)
This response is used when the chat command timeout failed because it tries to change a timeout key that does not exist.




verboseOffS (<message>)
This response is used when the chat command shut up successfully made Kore turn verbose off.




verboseOffF (<message>)
This response is used when the chat command shut up failed because verbose is already off.




verboseOnS (<message>)
This response is used when the chat command speak successfully turned verbose on.




verboseOnF (<message>)
This response is used when the chat command speak failed because verbose is already on.




whereS (<message>)
This response is used when the chat command where requests for Kore's current location, i.e. x-coordinate (%$x), y-coordinate (%$y), and map (%$map).