Scripts For Admins: Difference between revisions

Jump to navigation Jump to search
Content deleted Content added
imported>AntumDeluge
mNo edit summary
imported>AntumDeluge
Scripts and Parameters: organize player management scripts
Line 63: Line 63:


Note: Betting is possible in "idle conversation state" to enable interaction of a large number of players in a short time. (The last time i did a show-fight i was losing count because there were more than 15 players)
Note: Betting is possible in "idle conversation state" to enable interaction of a large number of players in a short time. (The last time i did a show-fight i was losing count because there were more than 15 players)

=== Deep Inspect ===

; /script DeepInspect.class {character|username} <name>
: Description:
:: Deep inspects a player and all his/her items and slots (except personal ones like !buddies and !ignore)
: Parameters:
:: '''character:''' Inspect a single online player.
:: '''username:''' Inspect all characters registered to an account.
:: '''name:''' Character name or account username.

=== Drop Player Items ===
; /script DropPlayerItems.class ''player'' ''[amount]'' ''item''
: Drop the specified amount of items from the player if they are equipped in the bag or body.


=== Entity Search ===
=== Entity Search ===
Line 89: Line 75:
; /script EntitySearch.class zname <partialZoneName>
; /script EntitySearch.class zname <partialZoneName>
: Shows all zone names that contain <partialZoneName> and shows all the creature respawn points in each of those zones.
: Shows all zone names that contain <partialZoneName> and shows all the creature respawn points in each of those zones.

=== Fix DM ===
; /script FixDM.class ''player''
: * If a player has killed all 10 creatures in deathmatch but the assistant is not giving victory, this script allows player to claim victory.
: * The admin should check this is plausible then run the script. The player is then told they may claim victory. They will then gain their score and get the helmet increased, and the slot will be changed, just as though the assistant had got it right all along.
: * If the player was lying or wrong, i.e. the state was "done" already, or non-existent, the script tells the admin who ran it and does nothing to player.
: * If the player had bailed by mistake then the script sets the quest state to "done" so the player can leave when needed but the helmet must be fixed manually, as appropriate.


=== List NPCs ===
=== List NPCs ===
; /script ListNPCs.class
; /script ListNPCs.class
:lists all npcs and their position
:lists all npcs and their position

=== Logout Player ===
; /script LogoutPlayer.class ''player''
:disconnects a player from the game


=== NPC Shout ===
=== NPC Shout ===
Line 113: Line 88:
: ''npc'' shouts ''text'' to players in given ''zone''. Use - in place of zone to make it your current zone.
: ''npc'' shouts ''text'' to players in given ''zone''. Use - in place of zone to make it your current zone.


=== Restore Player Outfit ===
=== Portable Tavern Maid ===
; /script Maria.class
: Summons Maria, who sells food&drinks. Put her away after use, by teleporting ''yourself'' to int_admin_playground and executing the script again or use -unload


=== Server Reset ===
; /script RestoreOriginalOutfit.class <player>
; /script ServerReset.class
: Use it in an ''emergency'' to shut down the server. If it is started in a loop, it will come back up otherwise it will stay down. If it is possible, please warn the players to logout and give them some time. Please note that it kills the server the hard way without doing a clean shutdown.

== Player Management ==

=== Deep Inspect ===

; /script DeepInspect.class ''{character|username} <name>''
: Description:
: Description:
:: Deep inspects a player and all his/her items and slots (except personal ones like !buddies and !ignore)
:: Restores player's original outfit if they are wearing a temporary one.
: Parameters:
:: '''character:''' Inspect a single online player.
:: '''username:''' Inspect all characters registered to an account.
:: '''name:''' Character name or account username.

=== Drop Player Items ===

; /script DropPlayerItems.class ''<player> [amount] <item>''
: Description:
:: Drop the specified amount of items from the player if they are equipped in the bag or body.
: Parameters:
: Parameters:
:: '''player:''' Name of target player.
:: '''player:''' Name of target player.
:: '''amount:''' ''(optional)'' Number of items to drop.
:: '''item:''' Name of target item.


=== Where are the Players ===
=== Fix DM ===
; /script WhereWho.class
: Tells the game master where all the players are. This helps to decide whether to do a raid.


; /script FixDM.class ''<player>''
=== Portable Tavern Maid ===
: Description:
; /script Maria.class
:: * If a player has killed all 10 creatures in deathmatch but the assistant is not giving victory, this script allows player to claim victory.
: Summons Maria, who sells food&drinks. Put her away after use, by teleporting ''yourself'' to int_admin_playground and executing the script again or use -unload
:: * The admin should check this is plausible then run the script. The player is then told they may claim victory. They will then gain their score and get the helmet increased, and the slot will be changed, just as though the assistant had got it right all along.
:: * If the player was lying or wrong, i.e. the state was "done" already, or non-existent, the script tells the admin who ran it and does nothing to player.
:: * If the player had bailed by mistake then the script sets the quest state to "done" so the player can leave when needed but the helmet must be fixed manually, as appropriate.
: Parameters:
:: '''player:''' Name of target player.

=== Logout Player ===

; /script LogoutPlayer.class ''<player>''
: Description:
:: Disconnects a player from the game.
: Parameters:
:: '''player:''' Name of target player.

=== Restore Outfit ===

; /script RestoreOriginalOutfit.class ''<player>''
: Description:
:: Restores player's original outfit if they are wearing a temporary one.
: Parameters:
:: '''player:''' Name of target player.


=== Reset Slot ===
=== Reset Slot ===
; /script ResetSlot.class ''player'' ''slot''
: Resets the named slot such as !kills or !quests or !features. Useful for debugging. Use with extreme caution on main server.


; /script ResetSlot.class ''<player> <slot>''
=== Server Reset ===
: Description:
; /script ServerReset.class
:: Resets the named slot such as !kills or !quests or !features. Useful for debugging. Use with extreme caution on main server.
: Use it in an ''emergency'' to shut down the server. If it is started in a loop, it will come back up otherwise it will stay down. If it is possible, please warn the players to logout and give them some time. Please note that it kills the server the hard way without doing a clean shutdown.
: Parameters:
:: '''player:''' Name of target player.
:: '''slot:''' Name of target slot.

=== Where are Players ===

; /script WhereWho.class
: Description:
:: Tells the game master where all the players are. This helps to decide whether to do a raid.


== Summon Creatures ==
== Summon Creatures ==
Line 141: Line 164:
=== Plague ===
=== Plague ===


; /script Plague.class <ringcount> <creature>
; /script Plague.class ''<ringcount> <creature>''
: Description:
: Description:
:: Summon a large numbers of ''creatures'' around you. Please note that ''ringcount'' must be below 3 in order to prevent the clients to die because of an OutOfMemoryError.
:: Summon a large numbers of ''creatures'' around you. Please note that ''ringcount'' must be below 3 in order to prevent the clients to die because of an OutOfMemoryError.