Sentry
|
Updates
v. 0.7.1 beta 8/3/2012
- Added commands: info, armor, strength
- All combat (ranged, player-npc, npc-npc, mob-npc) goes through the same calculations for armor, strength, and critical hits.
- More bugfixes and cleanup.
v. 0.7.0 beta 8/2/2012
- MC 1.3.1 Compatible
- Added commands: invincible, retaliate, drops, criticals
- Added ability to shoot bows and projectiles.
- Sentries respond to damage from arrows.
- Lots of bugfixes and minor updates.
v. 0.5.6 beta
- Now working with the new builds of C2.
v. 0.5.5 beta
- Fixed bugs.
v. 0.5 beta
- Added the ability to specify targets.
- Added the ability to set the Health and Speed of a Sentry.
- 'Stuck' Sentries now respawn after a while.
- Fixed the death handling.
- Fixed Sentries remembering their guard location on a restart.
v. 0.3 beta
- Added ability to kill the NPCs. Swords kill faster. Built-in chance of criticals, etc.
- Fixed targeting code, should be more efficient now.
- Implemented respawning sequence.
Up next: Warning targeted Players.
How to Use
Installation
- Ensure Citizens2 and Vault are installed
- Download Sentry.jar
- Place Sentry.jar in your Plugins folder.
- Start Server
Note. Sentry folder and config.yml will generate when you add the first target or set the guard position.
Commands
Sentries are useful for guarding areas from intruders. Giving a Citizens NPC the Sentry trait will also make it killable.
Creation
To create a sentry, use:
/npc create '[NPC Name]'
then
/npc trait sentry
To place your sentry use:
/npc path
And use the citizens waypoint editor to give your Sentry a place to stand, or a path to walk.
You can give Sentries weapons and armor to make them more lethal with the core Citizens2 command:
/npc equip
And right click with the desired weapon or armor. Sentries can be equipped with Bows, Blaze Rods (throw fireballs!) or any projectile.
Targets
To add a target: /sentry target add [target]
[target] can be entity:Name, entity:monster, group:Name, or player:Name
Example: /sentry target add PLAYER:Notch
or /sentry target add ENTITY:CREEPER
To remove a target:
/sentry target remove [target]
To view the target list:
/sentry target list
To clear the target list:
/sentry target clear
Stats
To set a Sentry's health:
(Default is 20)
/sentry health [1-20]
To set a Sentry's armor:
(Default is 0)
/sentry armor [0-10]
To set a Sentry's strength:
(Default is 0)
/sentry strength [0-10]
To set a Sentry's speed:
(Default is 1.0)
/sentry speed[0.0-1.5]
Options
To make the sentry drop his equipment on death:
(Default is no drops)
/sentry drops
To make the sentry impervious to all damage and knockback:
(Default is normal damage)
/sentry invincible
To make the sentry ignore an attacker if not in the target list:
(Default is retailiate against all attackers)
/sentry retaliate
To make the sentry take standard damage, instead of the default MUD-style critical hits and misses:
(Default is crtical hits)
/sentry criticals
Combat
Sentries can engage in rewarding combat with players, monsters, and even each other!
Equipment
A Sentry should be equipped with a weapon to make it effective, although any hand held item can be used.
Sentries equipped with a Bow, Blaze Rod, Egg, or Snowball become RANGED sentries. and will fire projectiles at the target.
Armor equipped on a sentry is purely cosmetic, deck out your sentries any way you want and it will not affect combat.
Dealing Damage
The damage dealt by a Sentry when attacking a target is determined by the weapon used, and the sentry's STRENGTH.
Strength is a value from 0 to 10 and this is added to the normal damage of the Sentry's weapon. This can make eggs deadly, so watch out!
Receiving Damage
Sentries can receive damage from any source, just like a monster. If the Sentry is set to RETALIATE, it will target any living entity that attacks it, ignoring any current target.
If the Sentry is set to INVINCIBLE, it takes NO damage or knockback at all!
If the Sentry has CRITICALS turned on, any incoming damage is randomized resulting in a normal hit, a miss, or one of several degrees of critical hit. If the attacker is a player, a message is shown based on the type of hit.
If the Sentry has ARMOR the damage will be reduced by the amount of armor. If the damage is reduced to nothing, the attack results in a block. Blocked hits cause no damage but DO cause knockback!
Finally if the Sentry is set to DROP ITEMS on death, when it dies it drops its equipment like a normal monster. Watch out for farmers!
Advanced Usage
In Citizens 2 a single NPC can be multiple character types at the same time. This can lead to very powerful player interactions.
A Sentry-Denizen for example, can be used to create advanced aggression systems. Here's an example:
Let's say you have an adventure server with a town called Hillside, populated by shopkeepers, guards, blacksmiths, etc.
Create a number of Sentry-Denizens to act as your town's police force. Set each Sentry to target a GROUP called Hillside_Enemy.
Now create a Denizen script with a DamageTrigger. On that damage trigger call FLAG HillsideEnemy:++
Create another script with a requirement of FLAGGED HillsideEnemy 3, and a DamageTrigger. On that damage trigger execute your server's group plugin to place the offending player in group Hillside_Enemy.
Now assign those 2 scripts to all your town's NPCs.
Now if a player attacks a member of Hillside, he gets a strike. 3 strikes.. and every Sentry in town will become aggressive. Neat eh?
This is just a basic example and can be expanded in any number of ways, using the commands in denizen you could:
- warn the player he is commiting a crime.
- forgive the player after a period of time (remove the player from the hillside_enemy group)
- Create a quest for the player to earn forgiveness.
- Create hostility in other towns if harassment of Hillside continues.
- etc etc etc.
Known caveats and upcoming features
Using /citizens reload may break your sentries or waypoints.
Sentries may get lost or fall through the world.
Suggestions
Suggestions are, of course, always welcome! Visit us in #citizens on EsperNet.
Quick Navigation | |
---|---|
Usage | Installation · Frequently Asked Questions · Commands · Editors · Characters · API · |
Configuration | Configuration · Text Syntax · Permissions · Waypoints · Data Storage |