Denizen/0.7/Interact Scripts/Interact Requirements
< Denizen | 0.7 | Interact Scripts
Requirements
Note: Requirements are due for a re-code to make them extensible like Commands. This will improve tolerence and allow for better debugging, as well as make it easy for other plugin programmers to extend Denizen. What this means to you is that it will probably change up some syntax formatting in future updates.
[] indicates required field, () indicates an optional field, | indicates alternative usage.
Click on any requirement to get more information and example usages.
Player Requirements
[Player Name] (Player Name) (Player Name) ...
|
[[ITEM_NAME]|[#]:[#]] (Quantity)
|
[[ITEM_NAME]|[#]:[#]] (Quantity)
|
[[ITEM_NAME]|[#]:[#]]
|
[Full|Hungry|Starving]
|
[# or higher] OR LEVEL [At least this Level #] [No more than this Level #]
|
[POTION_TYPE]
|
[>,<,=] [#|#%]
|
WORLD REQUIREMENTS
[World Name] (World Name) (World Name) ...
|
[Day|Night|Dusk|Dawn] OR TIME [0-23999] [1-24000]
|
[Block Bookmark]
|
SCRIPT REQUIREMENTS
(# of times) [Script Name]
|
(# of times) [Script Name]
|
[Name of Activity]
|
(FlagName:Value OR FlagName #)
|
VAULT REQUIREMENTS
These requirements only work if you have Vault installed and a compatible permissions/economy plugin.
[permission.node]
|
[Group Name] (Group Name) (Group Name) ...
|
[Quantity]
|
Negative Requirements
Requirements can also be 'negative' requirements. In the Requirements List, just place a '-' in front of the requirement to inverse its logic. For example, 'HOLDING IRON_SWORD' would require the player to be holding an Iron Sword. '-HOLDING IRON_SWORD' would require the player to NOT be holding an Iron Sword. All requirements have a negative alternative, even ones whose function may overlap, such as '-WEATHER Precipitating' and 'WEATHER Sunny', which technically do the same thing. If anything, it can add to script readability. The negative requirement '-' should not be confused with the 'list item -' with a trailing space in front of each Requirement in the List, as that is standard YAML list format. See below:
Requirements:
Mode: All
List:
- -TIME Night
- -MONEY 1000000
- -STORMY
Negative requirements can completely change the original example around. In this 'revised' example, for this script to trigger, time needs to be day, the weather in the current world must NOT be storming, and the player have less than 1000000 units of currency on them.