1.x/Wizard
< 1.x
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
[] - Mandatory
() - Optional
Command - command's syntax
Args Description - description of the command's arguments
Require Selected - whether the command requires an NPC to be selected
Require Ownership - whether the commands requires you to be the owner of the NPC
Required Mode - mode that a wizard must be in to use this command
Permission - command's permission node
Description - short description of the command
| Command | Args Description | Require Selected | Require Ownership | Required Mode | Permission | Description |
|---|---|---|---|---|---|---|
| /wizard help | None | false | false | None | citizens.wizard.use.help | View the help page for wizards |
| /wizard status | None | true | true | None | citizens.wizard.use.status | View the current mode and mana of a wizard |
| /wizard unlimited | None | true | true | None | citizens.wizard.modify.unlimited | Toggle a wizard's mana as unlimited |
| /wizard mode [mode] | mode - mode to set a wizard to | true | true | None | citizens.wizard.modify.mode | Change a wizard's mode |
| /wizard locations | None | true | true | teleport | citizens.wizard.use.locations | View a wizard's locations |
| /wizard addloc [location] | location - name of the location to add | true | true | teleport | citizens.wizard.modify.addloc | Add your current location to a wizard's locations |
| /wizard removeloc [location] | location - name of the location to remove | true | true | teleport | citizens.wizard.modify.removeloc | Add your current location to a wizard's locations |
| /wizard command [command] | command - name of command to add, split with spaces for multiple arguments | true | true | command | citizens.wizard.modify.command | Set a wizard's command to execute |
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.