summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorHaru <haru@dotalux.com>2020-06-28 00:27:48 +0200
committerGitHub <noreply@github.com>2020-06-28 00:27:48 +0200
commitf6f8ec5e247d3cd52598f2d026524d1bbc791120 (patch)
treebd6c43bdfbe4758104e74b98f8a97691a078c028 /doc
parent9b89425550094f51d633e5b5d6e86af65bffbf39 (diff)
parenta4492b60cf9012e990233ff4689cbf1ef67274ba (diff)
downloadhercules-f6f8ec5e247d3cd52598f2d026524d1bbc791120.tar.gz
hercules-f6f8ec5e247d3cd52598f2d026524d1bbc791120.tar.bz2
hercules-f6f8ec5e247d3cd52598f2d026524d1bbc791120.tar.xz
hercules-f6f8ec5e247d3cd52598f2d026524d1bbc791120.zip
Merge pull request #2732 from Kenpachi2k13/instance_create_doc
Update instancing window display and documentation of instance_create() script command
Diffstat (limited to 'doc')
-rw-r--r--doc/script_commands.txt16
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.
// ...
}