GM Commands

Congrats on becoming a member of the Nocturnal Souls community team. Team members gain access to several commands that allow them to better serve the community.

!addls {playerName}

• provide named player with the NocturnalSouls linkpearl.

!bring {playerName}

• pulls the player to your current location.

!checkquest {playerName} {log} {quest}

• gives AVAILABLE/ACCEPTED/COMPLETED status on the quest
• log IDs: https://github.com/DarkstarProject/darkstar/blob/master/scripts/globals/log_ids.lua
• quest IDs: https://github.com/DarkstarProject/darkstar/blob/master/scripts/globals/quests.lua
• ex: !checkquest toau five_seconds_of_fame Heli

!checkvar {playerName} {varName}

• returns value of player variable. e.g. voidstone_timer
• ex: !checkvar Heli voidstone_timer

!checkmission {playerName} {log}

• returns current mission the player is on
• log IDs: https://github.com/DarkstarProject/darkstar/blob/master/scripts/globals/log_ids.lua
• mission IDs: https://github.com/DarkstarProject/darkstar/blob/master/scripts/globals/missions.lua
• ex: !checkmission Heli zilart

!debug {status} {output}

• outputs any debugging messages coming from the scripts
• status = 0 is off, status = 1 is on
• output = 0 is console (server side), output = 1 is chatlog (player side)
• ex: !debug 1 1 for client-side output.

!getcraftrank {playerName} {craft}

• outputs the current rank for the skill provided
• valid crafts: cooking, woodworking, smithing, clothcraft, leathercraft, bonecraft, alchemy
• ex: !getcraftrank Heli cooking

!getid

• returns the internal ID of the mob, NPC, or player you currently have targeted.
• useful in debugging

!goto {playerName} {forceZone}

• teleports to the player specified.
• ex: !goto Heli
• ex: !goto Heli 0 (do not force a zone if in the same zone)

!hasitem {playerName} {itemID}

• check to see if the player has the specified item anywhere in their inventories
• uses the item ids found on the portal, bg-wiki, or ffxiah.
• ex: !hasitem Amatiru 4096 –has a fire crystal

!haskeyitem {playerName} {keyitemId}

• check to see if the player has the specified keyitem
• keyitem IDs: https://github.com/DarkstarProject/darkstar/blob/master/scripts/globals/keyitems.lua
• ex: !haskeyitem Heli crimson_stratum_abyssite

!hastitle {playerName} {title}

• check to see if the player has the specified title
• title IDs: https://github.com/DarkstarProject/darkstar/blob/master/scripts/globals/titles.lua
• ex: !hastitle Amatiru eternal_mercenary

!homepoint {playerName}

• sends the player immediately back to their home point.

!jail {playerName} {cellId} {reason}

• shouldn’t EVER need this…
• cellId is 1 to 32, assuming we have people already in jail
• reason is a single joined phrase (underscores) and is recorded in logs
• should be a last resort for someone doing something or breaking the game.
• only admins can UNJAIL, so…
• ex: !jail Amatiru 5 being_a_taru

!logoff {playerName}

• forceably logs a player out

!mobhere {mobId}

• Pull a monster to you and/or spawn it if it’s not already spawned.

!posfix {playerName}

• basically, the “unstuck character” button on the portal, clears their session and moves them to their homepoint.
• player MUST be logged out for this to work
• ex: !posfix Amatiru

!restrict {playerName} {level} {toggleEvent}

• The command for when we’re doing a level sync’d event, like the low-level survival runs.
• This needs to be REMOVED once the event is over.
• ex: adding: !restrict Heli 20 1
• ex: removing: !restrict Heli

!where

• Shows your current X, Y, Z (rotation) coordinates
• Everyone can use this; good for troubleshooting because everything uses these coords, not the map coordinates.