diff options
author | Kenpachi Developer <Kenpachi.Developer@gmx.de> | 2020-05-23 09:35:47 +0200 |
---|---|---|
committer | Kenpachi Developer <Kenpachi.Developer@gmx.de> | 2020-06-01 23:34:23 +0200 |
commit | a4492b60cf9012e990233ff4689cbf1ef67274ba (patch) | |
tree | 1064861b00bfdecb1dc7ec16dee18032905b8a59 /doc | |
parent | 03df6173b91200102ef21a6d67ceaf55340f6a92 (diff) | |
download | hercules-a4492b60cf9012e990233ff4689cbf1ef67274ba.tar.gz hercules-a4492b60cf9012e990233ff4689cbf1ef67274ba.tar.bz2 hercules-a4492b60cf9012e990233ff4689cbf1ef67274ba.tar.xz hercules-a4492b60cf9012e990233ff4689cbf1ef67274ba.zip |
Update documentation of instance_create() script command
* Fix some typos.
* Add a paragraph about owner types and the corresponding owner ID to use.
* Remove nonexistent return value -3 from example.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/script_commands.txt | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/script_commands.txt b/doc/script_commands.txt index 2fc6a95e5..db37ef284 100644 --- a/doc/script_commands.txt +++ b/doc/script_commands.txt @@ -9664,13 +9664,19 @@ For examples of usage, see /doc/sample/npc_rodex.txt //===================================== --------------------------------------- -*instance_create("<instance name>", <owner id>{, <optional owner_type>}) +*instance_create("<instance_name>", <owner_id>{, <owner_type>}) -Create an instance using the name "<instance name>" for the <owner_id> of -owner_type (when not provided, defaults to IOT_PARTY). Most instance_* +Creates an instance using the name "<instance_name>" for the <owner_id> of +<owner_type> (when not provided, defaults to IOT_PARTY). Most instance_* commands are used in conjunction with this command and depend on the ID this command returns. +Valid <owner_type> values: +- IOT_NONE (0) - <owner_id> can be any arbitrary number. +- IOT_CHAR (1) - <owner_id> is account ID. +- IOT_PARTY (2) - <owner_id> is party ID. +- IOT_GUILD (3) - <owner_id> is guild ID. + Example: // Store the Party ID of the invoking character. .@party_id = getcharid(CHAR_ID_PARTY); @@ -9681,11 +9687,9 @@ Example: // ... } else if (.@id == -2) { // Invalid Party ID // ... - } else if (.@id == -3) { // No free instances (MAX_INSTANCE exceeded) - // ... } else if (.@id == -4) { // Already exists // ... - } else (.@id < 0) { // Unspecified error while queuing instance. + } else if (.@id < 0) { // Unspecified error while queuing instance. // ... } |