1.x/Wizard: Difference between revisions

From Citizens Wiki

< 1.x

No edit summary
No edit summary
Line 1: Line 1:
Description here.
Wizards are the most versatile NPC type. They perform 5 different tasks: storm-toggling, teleportation, command-execution, mob-spawning, and time-changing. You can set a wizard up to get drained of mana or set it to unlimited mana. You interact with a wizard by left and right-clicking it with the interact-item (default is a feather).


== Configuration Nodes ==
== Configuration Nodes ==
These nodes can be found in ''citizens.yml''.
'''Setting''' - path of the setting
<br>'''Default Value''' - default value of the setting
<br>'''Description''' - short description of the setting
{| class="wikitable" style="text-align: center;"
! style="width: 250px;" | Setting
! style="width: 200px;" | Default Value
! Description
|-
| economy.prices.wizard.(mode)
| 100
| Amount that is charged each time a player uses the specific mode
|-
| wizard.max-locations
| 10
| Maximum locations that a wizard can have at once
|-
| wizard.max-mana
| 100
| Maximum mana that a wizard can have
|-
| wizard.interact-item
| 288
| ID of the item that a player must use to interact with a wizard
|-
| wizard.regen-mana
| true
| Whether to regenerate mana
|-
| wizard.regen-rate
| 6000
| Ticks between each mana-regen
|-
| wizard.regen-item
| 348
| ID of the item that a player can use to manually regenerate mana
|}


== Commands ==
== Commands ==


== Wizard Modes ==
== Wizard Modes ==
All modes require the interact-item to be in your hand in order for it to work. You can also change the amount of mana that each mode drains from a wizard in ''citizens.yml''.


* Storm-toggler (/wizard mode weather)
'''Mode''' - name of the mode, use this when changing the wizard's mode with ''/wizard mode''
 
<br>'''Description''' - short description of the mode
Simply right-clicking a wizard with the interaction item will toggle a storm in your world. '''Cost: 5 mana'''
 
 
* Teleporter (/wizard mode teleport)
 
You can control a wizard's locations using the /wizard addloc and /wizard removeloc commands. When you set your locations, you can left-click with the interaction item to cycle to the locations you want to teleport to. Once you get the location that you want to teleport to, right-click with the interaction item to teleport. '''Cost: 5 mana'''
 


* Command-executor (/wizard mode command)
{| class="wikitable" style="text-align: center;"
 
! style="width: 250px;" | Mode
The command-executor mode executes commands when a wizard is right-clicked with the interaction item. To change the command to execute, type the command ''/wizard command [command] (arguments)''. The player right-clicking the wizard must have permission for the command to be executed. '''Cost: 5 mana'''
! Description
 
|-
 
| teleport
* Time-changer (/wizard mode time)
| Ability to teleport to various locations. You can add and remove locations using ''/wizard addloc'' and ''/wizard removeloc''. Left-click to cycle through locations, right-click to teleport.
 
|-
There are 4 time settings that a wizard is capable of changing the time to: morning, day, afternoon, and night. To change the setting, left-click with the interaction item. Change the time by right-clicking with the interaction item. '''Cost: 5 mana'''
| storm
 
| Ability to toggle a storm in your world. Right-click to toggle a storm.
 
|-
* Mob-spawner (/wizard mode spawn)
| command
 
| Ability to execute commands. Set a command to execute using the ''/wizard command'' command. Right-click to execute the command. (Note: A player must have permission to use the command for it to work)
All Minecraft mobs are supported. To cycle through mobs to spawn, left-click the wizard with the interaction item. To spawn the mob at your location, right-click with the interaction item. '''Cost: 5 mana'''
|-
| time
| Ability to change the time in your world. There are 4 time settings that you can cycle through by left-clicking: morning, day, afternoon, and night. Right-click to change the time.
|-
| spawn
| Ability to spawn mobs at your location. Left-click to cycle through mobs (all Minecraft mobs are supported). Right-click to spawn the mob.
|}


== Future ==
== Future ==


* Ability to configure mana cost per mode
* Cooldowns for all modes
* Cooldowns for all modes


== FAQ ==
== FAQ ==
'''My wizard isn't healing when I left-click him! I am using the correct interact-item I am sure of this ZOMGGG!!!!!1111'''
'''Why can't I use wizards? I have all of the correct permissions!'''
<br>Make sure you are using the wizard interact-item (configurable in ''citizens.yml'', default is feather).
 
'''Why isn't my wizard working when I left-click him! I am sure that I am using the correct interact-item.'''
<br>Left-clicking a wizard does not work in areas where PvP is disabled. Make sure your wizard is not in one of those areas and that PvP is set to true for your world. This is a Bukkit bug.
<br>Left-clicking a wizard does not work in areas where PvP is disabled. Make sure your wizard is not in one of those areas and that PvP is set to true for your world. This is a Bukkit bug.

Revision as of 17:27, 1 September 2011

Wizards are the most versatile NPC type. They perform 5 different tasks: storm-toggling, teleportation, command-execution, mob-spawning, and time-changing. You can set a wizard up to get drained of mana or set it to unlimited mana. You interact with a wizard by left and right-clicking it with the interact-item (default is a feather).

Configuration Nodes

These nodes can be found in citizens.yml.

Setting - path of the setting
Default Value - default value of the setting
Description - short description of the setting

Setting Default Value Description
economy.prices.wizard.(mode) 100 Amount that is charged each time a player uses the specific mode
wizard.max-locations 10 Maximum locations that a wizard can have at once
wizard.max-mana 100 Maximum mana that a wizard can have
wizard.interact-item 288 ID of the item that a player must use to interact with a wizard
wizard.regen-mana true Whether to regenerate mana
wizard.regen-rate 6000 Ticks between each mana-regen
wizard.regen-item 348 ID of the item that a player can use to manually regenerate mana

Commands

Wizard Modes

All modes require the interact-item to be in your hand in order for it to work. You can also change the amount of mana that each mode drains from a wizard in citizens.yml.

Mode - name of the mode, use this when changing the wizard's mode with /wizard mode
Description - short description of the mode

Mode Description
teleport Ability to teleport to various locations. You can add and remove locations using /wizard addloc and /wizard removeloc. Left-click to cycle through locations, right-click to teleport.
storm Ability to toggle a storm in your world. Right-click to toggle a storm.
command Ability to execute commands. Set a command to execute using the /wizard command command. Right-click to execute the command. (Note: A player must have permission to use the command for it to work)
time Ability to change the time in your world. There are 4 time settings that you can cycle through by left-clicking: morning, day, afternoon, and night. Right-click to change the time.
spawn Ability to spawn mobs at your location. Left-click to cycle through mobs (all Minecraft mobs are supported). Right-click to spawn the mob.

Future

  • Cooldowns for all modes

FAQ

Why can't I use wizards? I have all of the correct permissions!
Make sure you are using the wizard interact-item (configurable in citizens.yml, default is feather).

Why isn't my wizard working when I left-click him! I am sure that I am using the correct interact-item.
Left-clicking a wizard does not work in areas where PvP is disabled. Make sure your wizard is not in one of those areas and that PvP is set to true for your world. This is a Bukkit bug.