|
|
|
Placeholders
|
|
|
|
------------
|
|
|
|
|
|
|
|
These are all of the placeholders and special characters you can use in
|
|
|
|
skills and mechanics that use strings.
|
|
|
|
|
|
|
|
##### Examples
|
|
|
|
|
|
|
|
This will make a mob (name in teal (&b)) send a message to all players
|
|
|
|
in a radius of 20 blocks around in itself, stating that it was slain by
|
|
|
|
player x (<trigger.name> in green (&a))
|
|
|
|
|
|
|
|
Skills:
|
|
|
|
- message{m="&b<mob.name>&r was slain by the warrior skills of &a<trigger.name>&r"} @PIR{r=20} ~onDeath
|
|
|
|
|
|
|
|
Skill Placeholders
|
|
|
|
------------------
|
|
|
|
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<tr class="header">
|
|
|
|
<th><strong>Mob Placeholder</strong></th>
|
|
|
|
<th><strong>Function</strong></th>
|
|
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><em>Some placeholders may not function properly if they don't apply to the caster (e.g. the caster is a player). Pre 4.6.0 versions use "mob" instead of "caster"</em></td>
|
|
|
|
<td></td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.uuid></td>
|
|
|
|
<td>Returns the UUID of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.level></td>
|
|
|
|
<td>Returns the level of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.name></td>
|
|
|
|
<td>Returns the name of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.hp></td>
|
|
|
|
<td>Returns current hp of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.mhp></td>
|
|
|
|
<td>Returns the max hp of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.php></td>
|
|
|
|
<td>Returns the percent hp of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.thp></td>
|
|
|
|
<td>Returns the full number hp of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.tt.top></td>
|
|
|
|
<td>Returns the name of the top threat holder of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.l.w></td>
|
|
|
|
<td>Returns the world name the caster is in</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.l.x></td>
|
|
|
|
<td>Returns the X coordinate of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.l.x.#></td>
|
|
|
|
<td>Returns the X coordinate of the caster<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.l.y></td>
|
|
|
|
<td>Returns the Y coordinate of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.l.y.#></td>
|
|
|
|
<td>Returns the Y coordinate of the caster<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.l.z></td>
|
|
|
|
<td>Returns the Z coordinate of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.l.z.#></td>
|
|
|
|
<td>Returns the Z coordinate of the caster<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.l.yaw></td>
|
|
|
|
<td>Returns the yaw of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.l.pitch></td>
|
|
|
|
<td>Returns the pitch of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.stance></td>
|
|
|
|
<td>Returns the current stance of the caster</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><caster.owner.name></td>
|
|
|
|
<td>Returns the name of the wolf's owner</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><caster.owner.uuid></td>
|
|
|
|
<td>Returns the uuid of the wolf's owner</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
| **Variable Placeholders (v4.6)** | **Function** |
|
|
|
|
|----------------------------------|-------------------------------------------------------------------------|
|
|
|
|
| <caster.var.\[name\]> | Returns the value of the variable \[name\] on the caster. |
|
|
|
|
| <skill.var.\[name\]> | Returns the value of the variable \[name\] on the current skill tree. |
|
|
|
|
| <skill.var.damage-amount> | Returns the amount of damage taken in the onDamaged trigger |
|
|
|
|
| <skill.var.damage-type> | Returns the type of damage taken as specified in a mechanic, aura, etc. |
|
|
|
|
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<tr class="header">
|
|
|
|
<th><strong>Target Placeholders</strong></th>
|
|
|
|
<th><strong>Function</strong></th>
|
|
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><em>These placeholders will return whatever targetselector has been used. For instance <target.name> + @NearestPlayer will return the name of the player closest to the casting mob.</em></td>
|
|
|
|
<td></td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><target.uuid></td>
|
|
|
|
<td>Returns the UUID of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><target.name></td>
|
|
|
|
<td>Returns the name of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><target.hp></td>
|
|
|
|
<td>Returns the current hp of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><target.threat></td>
|
|
|
|
<td>Returns the threat level of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><target.l.w></td>
|
|
|
|
<td>Returns the world name the target is in</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><target.l.x></td>
|
|
|
|
<td>Returns the X coordinate of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><target.l.x.#></td>
|
|
|
|
<td>Returns the X coordinate of the target<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><target.l.y></td>
|
|
|
|
<td>Returns the Y coordinate of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><target.l.y.#></td>
|
|
|
|
<td>Returns the Y coordinate of the target<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><target.l.z></td>
|
|
|
|
<td>Returns the Z coordinate of the target</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><target.l.z.#></td>
|
|
|
|
<td>Returns the Z coordinate of the target<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<tr class="header">
|
|
|
|
<th><strong>Trigger Placeholders</strong></th>
|
|
|
|
<th><strong>Function</strong></th>
|
|
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><trigger.uuid></td>
|
|
|
|
<td>Returns the UUID of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><trigger.name></td>
|
|
|
|
<td>Returns the name of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><trigger.hp></td>
|
|
|
|
<td>Returns the current hp of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><trigger.threat></td>
|
|
|
|
<td>Returns the threat level of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><trigger.l.w></td>
|
|
|
|
<td>Returns the world name of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><trigger.l.x></td>
|
|
|
|
<td>Returns the X coordinate of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><trigger.l.x.#></td>
|
|
|
|
<td>Returns the X coordinate of the person triggering the skill<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><trigger.l.y></td>
|
|
|
|
<td>Returns the Y coordinate of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><trigger.l.y.#></td>
|
|
|
|
<td>Returns the Y coordinate of the person triggering the skill<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="even">
|
|
|
|
<td><trigger.l.z></td>
|
|
|
|
<td>Returns the Z coordinate of the person triggering the skill</td>
|
|
|
|
</tr>
|
|
|
|
<tr class="odd">
|
|
|
|
<td><trigger.l.z.#></td>
|
|
|
|
<td>Returns the Z coordinate of the person triggering the skill<br />
|
|
|
|
+- random number between #</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Misc Placeholders
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
| **Placeholder** | **Function** |
|
|
|
|
|-----------------------|-----------------------------------------------------|
|
|
|
|
| **Misc Placeholders** | |
|
|
|
|
| <drops.xp> | Returns the xp dropped via Heroes or SkillAPI mods |
|
|
|
|
| <drops.money> | Returns the money dropped through the vault plug-in |
|
|
|
|
|
|
|
|
Special Placeholders
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
| **Placeholder** | **Function** |
|
|
|
|
|----------------------------------------|---------------------------------------------------------------------------|
|
|
|
|
| <caster.score.objective> | Returns the score of the caster from "objective" **(2.3)** |
|
|
|
|
| <target.score.objective> | Returns the targeters score from "objective" **(2.3)** |
|
|
|
|
| <trigger.score.objective> | Returns the score of the trigger from "objective" **(2.3)** |
|
|
|
|
| <global.score.objective> | Returns the global score from "objective" **(2.3)** |
|
|
|
|
| <score.objective.dummyname> | Returns the score of "dummyname" (fake player) from "objective" **(2.3)** |
|
|
|
|
| <random.\#-\#> <sup>(v4.6)</sup> | Returns a random number in the specified range |
|
|
|
|
|
|
|
|
Special Characters
|
|
|
|
------------------
|
|
|
|
|
|
|
|
| **Placeholder** | **Function** |
|
|
|
|
|-----------------|---------------------------------------|
|
|
|
|
| <&co> | Returns a colon (:) |
|
|
|
|
| <&sq> | Returns an apostrophe (') |
|
|
|
|
| <&da> | Returns a dash (-) |
|
|
|
|
| <&bs> | Returns a backslash (\\) |
|
|
|
|
| <&fs> | Returns a forward slash (/) |
|
|
|
|
| <&sp> | Returns a space |
|
|
|
|
| <&cm> | Returns a comma (,) |
|
|
|
|
| <&sc> | Returns a semicolon (;) |
|
|
|
|
| <&eq> | Returns an equals symbol \[=\] |
|
|
|
|
| <&ss> | Returns a section symbol (ยง) |
|
|
|
|
| <&dq> | Returns double quotes (") |
|
|
|
|
| <&rb> | Returns a right bracket (\]) |
|
|
|
|
| <&lb> | Returns a left bracket (\[) |
|
|
|
|
| <&rc> | Returns a right curly bracket (}) |
|
|
|
|
| <&lc> | Returns a left curly bracket ({) |
|
|
|
|
| <&nl> | Forces a new line |
|
|
|
|
| <&heart> | Returns a heart **(2.1.7)** |
|
|
|
|
| <&skull> | Returns a skull and bones **(2.1.7)** |
|
|
|
|
|
|
|
|
Color Codes
|
|
|
|
-----------
|
|
|
|
|
|
|
|
These color codes work anywhere in mob- and skill-files. They will even
|
|
|
|
properly format tellraw-commands used in command skills!
|
|
|
|
|
|
|
|
| **Code** | **Color** | **Code** | **Color** |
|
|
|
|
|----------|-------------|----------|----------------|
|
|
|
|
| &0 | Black | &B | Aqua |
|
|
|
|
| &1 | Dark Blue | &C | Red |
|
|
|
|
| &2 | Dark Green | &D | Light Purple |
|
|
|
|
| &3 | Dark Aqua | &E | Yellow |
|
|
|
|
| &4 | Dark Red | &F | White |
|
|
|
|
| &5 | Dark Purple | &K | Magic |
|
|
|
|
| &6 | Gold | &L | Bold |
|
|
|
|
| &7 | Gray | &M | Strike through |
|
|
|
|
| &8 | Dark Gray | &N | Underline |
|
|
|
|
| &9 | Blue | &O | Italic |
|
|
|
|
| &A | Green | &R | Reset | |
