# WARNING: BETA VERSION, USE AT OWN RISK
Please report any issues on the Github or Discord
# Changelog
## All Changes
- Updated to Skript **2.16.1**.
- Fixed a synchronization issue when despawning citizens.
- Fixed a bug where skin values were handled incorrectly.
- Added **40** new citizen expressions.
- Added **6** new citizen effects.
- Added **5** new citizen conditions.
- Added **9** new citizen events.
---
## New Elements
All new citizen elements added since 1.2.5. Click a section to expand it.
<details>
<summary><b>Conditions</b> (5 new)</summary>
<details>
<summary><b>Citizen Is Leashable</b></summary>
Whether a Citizens NPC is leashable.
```skript
(citizen|npc)[s] %npcs% (is|are) leashable
(citizen|npc)[s] %npcs% (is(n't| not)|are(n't| not)) leashable
```
</details>
<details>
<summary><b>Citizen is Owned By</b></summary>
Returns if a Citizens NPC is owned by a specific player.
```skript
(citizen|npc)[s] %npcs% is owned by %player%
(citizen|npc)[s] %npcs% (is(n't| not)) owned by %player%
```
</details>
<details>
<summary><b>Citizen Should Take Knockback</b></summary>
Whether a Citizens NPC should take knockback.
```skript
(citizen|npc)[s] %npcs% should take knockback
(citizen|npc)[s] %npcs% should( not|n't) take knockback
```
</details>
<details>
<summary><b>Citizen Picks Up Items</b></summary>
Whether a Citizens NPC picks up items.
```skript
(citizen|npc)[s] %npcs% (pick|picks) up items
(citizen|npc)[s] %npcs% (do[es]( not|n't)|do[es]n't) pick up items
```
</details>
<details>
<summary><b>Citizen Should Jump</b></summary>
Whether a Citizens NPC should jump when navigating.
```skript
(citizen|npc)[s] %npcs% should jump
(citizen|npc)[s] %npcs% should( not|n't) jump
```
</details>
</details>
<details>
<summary><b>Effects</b> (6 new)</summary>
<details>
<summary><b>Modify Citizen Metadata</b></summary>
Modify the metadata of a Citizens NPC.
```skript
(modify|set) [p:persistent] (citizen|npc) %npcmetadata% [metadata] of %npcs% to (%-boolean%|%number%)
(modify|set) %npcs%['s] [p:persistent] (citizen|npc) %npcmetadata% [metadata] to (%-boolean%|%number%)
```
</details>
<details>
<summary><b>Citizen Mirror</b></summary>
Enable/Disable a Citizens NPC's Mirror Trait.
```skript
enable (npc|citizen)[s] %npcs% mirror [n:with name] [e:[and] with equipment]
disable (npc|citizen)[s] %npcs% mirror
```
</details>
<details>
<summary><b>Citizen Mount</b></summary>
Makes a Citizens NPC mount or dismount an entity.
```skript
make (citizen|npc) %npc% mount %entity%
make (citizen|npc) %npc% dismount
```
</details>
<details>
<summary><b>Citizen Player Animation</b></summary>
Plays a player animation on a Citizens NPC.
```skript
make (citizen|npc) %npc% play animation %string%
```
</details>
<details>
<summary><b>Citizen Rotate</b></summary>
Rotates a Citizens NPC to face a location or entity.
```skript
make (citizen|npc) %npc% face %location%
make (citizen|npc) %npc% face %entity%
```
</details>
<details>
<summary><b>Citizen Speak</b></summary>
Makes a Citizens NPC speak a message.
```skript
make (citizen|npc) %npc% say %strings%
```
</details>
</details>
<details>
<summary><b>Expressions</b> (40 new)</summary>
<details>
<summary><b>Citizen Anchors</b></summary>
The anchors of a Citizens NPC.
```skript
anchors of (citizen|npc) %npc%
(citizen|npc) %npc%'[s] anchors
```
</details>
<details>
<summary><b>Citizen Attributes</b></summary>
The attributes of a Citizens NPC as a string.
```skript
(citizen|npc) attributes of %npcs%
%npcs%'[s] (citizen|npc) attributes
```
</details>
<details>
<summary><b>Citizen Avoid Water</b></summary>
Whether a Citizens NPC avoids water when pathfinding.
```skript
(citizen|npc) avoid water of %npcs%
%npcs%'[s] (citizen|npc) avoid water
```
</details>
<details>
<summary><b>Citizen Behaviour</b></summary>
Whether a Citizens NPC has the Behaviour trait.
```skript
(citizen|npc) behaviour of %npcs%
%npcs%'[s] (citizen|npc) behaviour
```
</details>
<details>
<summary><b>Citizen Cosmetic Entity</b></summary>
Whether the cosmetic entity (mirror) trait is enabled on a Citizens NPC.
```skript
(citizen|npc) cosmetic entity of %npcs%
%npcs%'[s] (citizen|npc) cosmetic entity
```
</details>
<details>
<summary><b>Citizen Drops Items</b></summary>
Whether a Citizens NPC drops items.
```skript
(citizen|npc) drops items of %npcs%
%npcs%'[s] (citizen|npc) drops items
```
</details>
<details>
<summary><b>Citizen Face Location</b></summary>
The location a Citizens NPC is facing.
```skript
(citizen|npc) face location of %npcs%
%npcs%'[s] (citizen|npc) face location
```
</details>
<details>
<summary><b>Citizen Hidden</b></summary>
Whether a Citizens NPC is hidden.
```skript
(citizen|npc) hidden [state] of %npcs%
%npcs%'[s] (citizen|npc) hidden [state]
```
</details>
<details>
<summary><b>Citizen Home Location</b></summary>
The home location of a Citizens NPC.
```skript
(citizen|npc) home [location] of %npcs%
%npcs%'[s] (citizen|npc) home [location]
```
</details>
<details>
<summary><b>Citizen Inventory</b></summary>
The inventory of a Citizens NPC.
```skript
(citizen|npc) inventory of %npcs%
%npcs%'[s] (citizen|npc) inventory
```
</details>
<details>
<summary><b>Citizen Should Take Knockback</b></summary>
Whether a Citizens NPC should take knockback.
```skript
(citizen|npc) knockback of %npcs%
%npcs%'[s] (citizen|npc) knockback
```
</details>
<details>
<summary><b>Citizen Is Leashable</b></summary>
Whether a Citizens NPC is leashable (leash protected).
```skript
(citizen|npc) leashable of %npcs%
%npcs%'[s] (citizen|npc) leashable
```
</details>
<details>
<summary><b>Citizen Metadata</b></summary>
The value of a Citizen's metadata.
```skript
%npcmetadata% (citizen|npc) ([meta]data) of %npc%
(citizen|npc) ([meta]data) %npcmetadata% of %npc%
```
</details>
<details>
<summary><b>Citizen Move Destination</b></summary>
The navigation target location of a Citizens NPC.
```skript
(citizen|npc) move destination of %npcs%
%npcs%'[s] (citizen|npc) move destination
```
</details>
<details>
<summary><b>Citizen Open Doors</b></summary>
Whether a Citizens NPC opens doors when pathfinding.
```skript
(citizen|npc) open[ed] doors of %npcs%
%npcs%'[s] (citizen|npc) open[ed] doors
```
</details>
<details>
<summary><b>Citizen Owner (UUID)</b></summary>
The 'owner' of a Citizens NPC, if null, then it is owned by the server, else a player.
```skript
(citizen|npc) owner [uuid] of %npcs%
%npcs%'[s] (citizen|npc) owner [uuid]
```
</details>
<details>
<summary><b>Citizen Packet Update Delay</b></summary>
The packet update delay of a Citizens NPC.
```skript
(citizen|npc) packet [update] delay of %npcs%
%npcs%'[s] (citizen|npc) packet [update] delay
```
</details>
<details>
<summary><b>Citizen Pathfinding Range</b></summary>
The pathfinding range of a Citizens NPC's navigator.
```skript
(citizen|npc) pathfind[ing] range of %npcs%
%npcs%'[s] (citizen|npc) pathfind[ing] range
```
</details>
<details>
<summary><b>Citizen Picks Up Items</b></summary>
Whether a Citizens NPC picks up items.
```skript
(citizen|npc) picks up items of %npcs%
%npcs%'[s] (citizen|npc) picks up items
```
</details>
<details>
<summary><b>Citizen Player Filter</b></summary>
Whether a Citizens NPC has a PlayerFilter trait.
```skript
(citizen|npc) player filter of %npcs%
%npcs%'[s] (citizen|npc) player filter
```
</details>
<details>
<summary><b>Citizen Player List Visibility</b></summary>
Whether a Citizens NPC is removed from the player list.
```skript
(citizen|npc) player list [visibility] of %npcs%
%npcs%'[s] (citizen|npc) player list [visibility]
```
</details>
<details>
<summary><b>Citizen Rotation</b></summary>
The rotation of a Citizens NPC (yaw).
```skript
(citizen|npc) rotation of %npcs%
%npcs%'[s] (citizen|npc) rotation
```
</details>
<details>
<summary><b>Citizen Reset Pitch on Tick</b></summary>
Whether a Citizens NPC resets its pitch on tick.
```skript
(citizen|npc) reset pitch [on tick] of %npcs%
%npcs%'[s] (citizen|npc) reset pitch [on tick]
```
</details>
<details>
<summary><b>Citizen Scaled Max Health</b></summary>
The scaled max health of a Citizens NPC.
```skript
(citizen|npc) scaled max health of %npcs%
%npcs%'[s] (citizen|npc) scaled max health
```
</details>
<details>
<summary><b>Citizen Shop</b></summary>
Whether a Citizens NPC has a shop trait.
```skript
(citizen|npc) shop [trait] of %npcs%
%npcs%'[s] (citizen|npc) shop [trait]
```
</details>
<details>
<summary><b>Citizen Should Jump</b></summary>
Whether a Citizens NPC should jump when navigating.
```skript
(citizen|npc) should jump of %npcs%
%npcs%'[s] (citizen|npc) should jump
```
</details>
<details>
<summary><b>Citizen Sitting</b></summary>
Whether a Citizens NPC is sitting.
```skript
(citizen|npc) sitting [state] of %npcs%
%npcs%'[s] (citizen|npc) sitting [state]
```
</details>
<details>
<summary><b>Citizen Skin Layers</b></summary>
Whether a Citizens NPC has the SkinLayers trait.
```skript
(citizen|npc) skin layers of %npcs%
%npcs%'[s] (citizen|npc) skin layers
```
</details>
<details>
<summary><b>Citizen Skin Name</b></summary>
The skin name of a Citizens NPC.
```skript
(citizen|npc) skin name of %npcs%
%npcs%'[s] (citizen|npc) skin name
```
</details>
<details>
<summary><b>Citizen Sneaking</b></summary>
Whether a Citizens NPC is sneaking.
```skript
(citizen|npc) sneaking of %npcs%
%npcs%'[s] (citizen|npc) sneaking
```
</details>
<details>
<summary><b>Citizen Sounds</b></summary>
Whether a Citizens NPC is silent.
```skript
(citizen|npc) silent of %npcs%
%npcs%'[s] (citizen|npc) silent
```
</details>
<details>
<summary><b>Citizen Speech</b></summary>
The speech trait of a Citizens NPC.
```skript
(citizen|npc) speech [trait] of %npcs%
%npcs%'[s] (citizen|npc) speech [trait]
```
</details>
<details>
<summary><b>Citizen Speed</b></summary>
The navigation speed of a Citizens NPC.
```skript
(citizen|npc) speed of %npcs%
%npcs%'[s] (citizen|npc) speed
```
</details>
<details>
<summary><b>Citizen Stored Location</b></summary>
The stored (current) location of a Citizens NPC.
```skript
(citizen|npc) stored location of %npcs%
%npcs%'[s] (citizen|npc) stored location
```
</details>
<details>
<summary><b>Citizen Swim</b></summary>
Whether a Citizens NPC can swim.
```skript
(citizen|npc) swim of %npcs%
%npcs%'[s] (citizen|npc) swim
```
</details>
<details>
<summary><b>Citizen Tablist Visibility</b></summary>
Whether a Citizens NPC is removed from the tab list.
```skript
(citizen|npc) tablist visibility of %npcs%
%npcs%'[s] (citizen|npc) tablist visibility
```
</details>
<details>
<summary><b>Citizen Tracking Range</b></summary>
The tracking range of a Citizens NPC.
```skript
(citizen|npc) tracking range of %npcs%
%npcs%'[s] (citizen|npc) tracking range
```
</details>
<details>
<summary><b>Citizen UUID</b></summary>
The UUID of a Citizens NPC or its entity.
```skript
(citizen|npc) uuid of %npc%
%npc%'[s] (citizen|npc) uuid
(citizen|npc) (entity|minecraft) uuid of %npc%
%npc%'[s] (entity|minecraft) uuid
```
</details>
<details>
<summary><b>Citizen Use Held Item</b></summary>
Whether a Citizens NPC is using its held item.
```skript
(citizen|npc) using held item of %npcs%
%npcs%'[s] (citizen|npc) using held item
```
</details>
<details>
<summary><b>Citizen Wander</b></summary>
Whether a Citizens NPC has the Waypoints trait (wandering).
```skript
(citizen|npc) wander[ing] of %npcs%
%npcs%'[s] (citizen|npc) wander[ing]
```
</details>
</details>
<details>
<summary><b>Events</b> (9 new)</summary>
<details>
<summary><b>Citizen Combust</b></summary>
Called when a Citizens NPC combusts.
```skript
(citizen|npc) combust
```
</details>
<details>
<summary><b>Citizen Knockback</b></summary>
Called when a Citizens NPC is knocked back.
```skript
(citizen|npc) knockback
```
</details>
<details>
<summary><b>Citizen Push</b></summary>
Called when a Citizens NPC is pushed.
```skript
(citizen|npc) push[ed]
```
</details>
<details>
<summary><b>Citizen Seen by Player</b></summary>
Called when a Citizens NPC is seen by a player.
```skript
(citizen|npc) seen by [a] player
```
</details>
<details>
<summary><b>Citizen Open Door</b></summary>
Called when a Citizens NPC opens a door.
```skript
(citizen|npc) open[ed] [a] door
```
</details>
<details>
<summary><b>Citizen Open Gate</b></summary>
Called when a Citizens NPC opens a gate.
```skript
(citizen|npc) open[ed] [a] gate
```
</details>
<details>
<summary><b>Citizen Rename</b></summary>
Called when a Citizens NPC is renamed.
```skript
(citizen|npc) rename[d]
```
</details>
<details>
<summary><b>Citizen Vehicle Damage</b></summary>
Called when a Citizens NPC's vehicle is damaged.
```skript
(citizen|npc) vehicle damage
```
</details>
<details>
<summary><b>Citizen Clone</b></summary>
Called when a Citizens NPC is cloned.
```skript
(citizen|npc) clone[d]
```
</details>
</details>
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }