Follow up 20bdc01fa687b174a732be4483ddea4982d67ce9

Fixed scripting deficiency of being unable to tell whether a user is assigned to a specific instance or not ( 20bdc01fa687b174a732be4483ddea4982d67ce9 removed that ability ), because users can be assigned to more than a single instance on hercules, the previous instance_id(<va>) isn't viable, so I'm introducing has_instance2("<map_name>"), returns the instance id of that map for the user (as long as the user is assigned to a instead with that map), -1 upon failure -- valid instance ids are >= 0.

Signed-off-by: shennetsind <ind@henn.et>

1 files changed, 8 insertions, 0 deletions

diff --git a/doc/script_commands.txt b/doc/script_commands.txt
index 9f9dc0049..c0b848663 100644
--- a/doc/script_commands.txt
+++ b/doc/script_commands.txt
@@ -7960,6 +7960,14 @@ Returns name of the instanced map on success, otherwise an empty string.
 
 ---------------------------------------
 
+*has_instance2("<map name>");
+
+Same as has_instance, with exception it returns the instance id of the map,
+as long as the user is assigned to a instance containing that map.
+It will return -1 upon failure, valid instance ids are >= 0.
+
+---------------------------------------
+
 *instance_id();
 
 Retrieves the instance id of the script it is being run on.