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

From Citizens Wiki
Line 267: Line 267:
}}
}}


{{Denizen Command Color 2|wheat|
SPAWN
|[ENTITY_TYPE] (QTY:#) (LOCATION BOOKMARK) (SPREAD:#) ('EFFECT:[POTION_EFFECT] [LEVEL]') ('OPTION:[OPTIONS]')
| Spawns a specified amount of entities. If the location bookmark is missing, they will spawn near the Denizen.
Modifiers:
*SPREAD:[#] Increases the 'spread' of the area that the monster can spawn.
*'EFFECT:[POTION_EFFECT] [LEVEL]' Applies a potion effect on the monster when spawning.
*'OPTION:OptionName OptionsValue' Applies a flag to the Mob. Note: Only works for mobs that can accept the flag.
** Valid OptionNames are:
***POWERED, SADDLED, BABY, 'PROFESSION [PROFESSION_TYPE]', SHEARED, 'COLORED [DYE_COLOR]', ANGRY')
****CREEPER can have POWERED
****PIG can have SADDLED
****PIG, SHEEP, COW, VILLAGER, CHICKEN, OCELOT and WOLF can have BABY
****VILLAGER can have PROFESSION
*****Valid PROFESSION_TYPEs: FARMER, LIBRARIAN, PRIEST, BLACKSMITH, BUTCHER
****SHEEP can have SHEARED and COLORED
****WOLF and PIG_ZOMBIE can have ANGRY


'''Example Usages'''
<pre>
- SPAWN BOAT
- SPAWN QTY:3 COW Cage
- SPAWN VILLAGER 'El Notcho:Gate'
- SPAWN 'QTY:10' PIG_ZOMBIE SPREAD:5
- SPAWN QTY:25 ZOMBIE SPREAD:20 'EFFECT:INCREASE_DAMAGE 2'
- SPAWN QTY:2 SHEEP 'OPTION:COLORED RED'
</pre>
}}


* SPAWN [ENTITY_TYPE] [AMOUNT] (Location Bookmark)
*: <code>Spawns a specified amount of entities. If the location bookmark is missing, they will spawn near the Denizen.</CODE>


* TELEPORT [Denizen Name] OR [BOOKMARK:BookmarkName] OR ['BOOKMARK:Denizen Name:BookmarkName']
* TELEPORT [Denizen Name] OR [BOOKMARK:BookmarkName] OR ['BOOKMARK:Denizen Name:BookmarkName']

Revision as of 22:16, 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.


  • TELEPORT [Denizen Name] OR [BOOKMARK:BookmarkName] OR ['BOOKMARK:Denizen Name:BookmarkName']
    Teleports the player interacting to a bookmark or Denizen/

Player Interaction Commands