Denizen/0.7/Interact Scripts/Commands: Difference between revisions

From Citizens Wiki
Line 195: Line 195:


<del>* FOLLOW [PLAYER|NOBODY]</del>
<del>* FOLLOW [PLAYER|NOBODY]</del>
<del>*: </code>Makes the Denizen follow the player, or stop following the player.<code></del>
<del></code>Makes the Denizen follow the player, or stop following the player.<code></del>


* WALKTO [Location Bookmark]
{{Denizen Command Color 2|mintcream|
*: </code>Makes the Denizen walk to a specified location.<code>
WALKTO
Note: I've been having problems getting the NPCs to WALKTO a bookmarked location that is far away, perhaps in a different chunk? Working on it with the C2 team. I may have another workaround as well.
|[LocationBookmark] or [ 'DenizenName:LocationBookmark'] or [PLAYER]
| Makes the denizen walk to the specified location bookmark, or to the interacting player.
'''Example Usages'''
- WALKTO PLAYER
- WALKTO 'Gary:GarysHouse'
}}
 
{{Denizen Command Color 2|mintcream|
RETURN
|
| Makes the denizen walk back to the spot it was at before a call to WALKTO
'''Example Usages'''
- WALKTO 'Somewhere'
- RETURN
}}


* WALK [Z] [X] [Y]  Note: Z(-NORTH(2)/+SOUTH(0)) X(-WEST(1)/+EAST(3)) Y (+UP/-DOWN)
* WALK [Z] [X] [Y]  Note: Z(-NORTH(2)/+SOUTH(0)) X(-WEST(1)/+EAST(3)) Y (+UP/-DOWN)
*: </code>Makes the Denizen walk. This is not for making the Denizen to specific coordinates. The values for X Y and Z will get added or subtracted from the Denizen's current location.<code>
*: </code>Makes the Denizen walk. This is not for making the Denizen to specific coordinates. The values for X Y and Z will get added or subtracted from the Denizen's current location.<code>
* RETURN
*: </code>Can be used after initiating a WALK command.  This will make the denizen return to its previous location.<code>


<del> RESPAWN [Location Bookmark]
<del> RESPAWN [Location Bookmark]

Revision as of 22:03, 19 August 2012

Interact Script Commands

Note: There are plenty more to come, be patient, more are coming! Have ideas for a good command? Let me know!

[] indicates required field, () indicates an optional field, OR indicates alternative usage.

Script Flow Commands

These commands have no external affect on the world, but can control the flow of scripts within Denizen. Though not required, and with the exception of WAIT, it is generally recommended to run these as Instant Commands to ensure smooth Script feedback to players.

Server Commands

Text Commands

These commands show some text to the player interacting, and usually to bystanders around. Note that all text commands must be surrounded by quotes single ' or double ". See: Which Quotes? for more information. Text commands also have some auto-formatting, such as making sure no words will be cut off on long messages, and applying color codes. See: Denizen Color Codes. Formatting for how NPCs and Players talk can be customized in the config.yml.

Denizen NPC Commands

Denizen NPC commands are meant to help bring your Denizen to life by allowing fine-control of small movements. These are not necessarily meant for making the Denizen NPC do large/long activities, those will instead be done by the Activity Engine, which is just now starting to be implemented into Denizen. The next 'large' update will focus on Activities.

* FOLLOW [PLAYER|NOBODY] Makes the Denizen follow the player, or stop following the player.

  • WALK [Z] [X] [Y] Note: Z(-NORTH(2)/+SOUTH(0)) X(-WEST(1)/+EAST(3)) Y (+UP/-DOWN)
    Makes the Denizen walk. This is not for making the Denizen to specific coordinates. The values for X Y and Z will get added or subtracted from the Denizen's current location.

RESPAWN [Location Bookmark]

  • Despawns the Denizen and respawns it to a bookmarked location.

Note: There is something funny going on with NPCs spawning to a location you are very near to. You sometimes have to back away before they show up. This seems to be an issue with Craftbukkit and/or Minecraft Server.

Vault Commands

The commands below require Vault and a valid permissions and economy system. Though Vault is not required to use Denizen, the commands below DO require Vault and its dependencies to be installed. Remember: Vault is not an economy or permissions system, merely a hook to help Denizen connect to your favorite systems!

World Interaction Commands

These commands do something physical to the world or player.


  • SPAWN [ENTITY_TYPE] [AMOUNT] (Location Bookmark)
    Spawns a specified amount of entities. If the location bookmark is missing, they will spawn near the Denizen.
  • TELEPORT [Denizen Name] OR [BOOKMARK:BookmarkName] OR ['BOOKMARK:Denizen Name:BookmarkName']
    Teleports the player interacting to a bookmark or Denizen/

Player Interaction Commands