Vitals
Information about commands, permissions, and other extensive documentation for this plugin is available on our website: http://6d7.com/vitals You can also get the latest download there if it hasn't been approved yet here at DevBukkit.
Requirements
- Vault
- a Vault-compatible economy plugin like BOSeconomy
- All features of this plugin are turned off (set to false) by default. You must enable the modules you want!
If you install this plugin and don't turn any modules on, it will do nothing. This is so that it runs as efficiently as possible, giving you only the features you want and nothing else. Don't worry, this plugin is designed to run well even with everything turned on! (we have a very underpowered server, it's a necessity). Join our minecraft server 6d7.com which runs Vitals with almost every feature enabled if you want to see how something works.
Installation / Configuration
Just put the .jar file in your plugins folder, and when you start your server it will create the config.yml file for you.
You can then edit the config file while the server is running and type /vreload to load any changes you made to the file.
Or, you can modify settings with commands... See current settings with /vhelp, turn a module on or off with /vtoggle [modulename], or change config settings with /vsetting [setting] [value]
General Features
- Announcements: Setup a list of messages that are broadcast in sequential or random order every X seconds
- Arenas: Let your players participate in arena matches (pvp, spleef, hungergames, or racetothefinish) that start manually or automatically at a set interval
- Auctions: Players with the permission v.auction (default op) can put items up for auction with /auction and players with v.auction.bid (default everyone) can bid on items with /bid. Configurable fees, duration, announce interval, and fair queueing system. Items that are damaged or enchanted are noted in the auction description.
- BetterHelp: If enabled, /help shows a simple list of basic commands, /help advanced shows a simple list of advanced commands, /help [command] shows help for a specific command. The commands shown are chosen in config.yml, or can be changed with /help (addbasic,addadvanced,remove) [command] if you have permission v.help.edit. If BetterHelp is not enabled, the normal help system on your server is used
- BetterNews: Players see the latest news when they login or when they type /news. Ops can edit the latest news with /news [add|change|delete]
- Bounties: When a player kills another player, a bounty is offered to whoever can kill them. Additional unique kills by the killer increase the bounty on their head. Players can also create their own bounties with /bounty [player] [amount] (deducted from their balance)
- ChatWorlds: Players can only see chat messages from other players in the same world, unless they have the permission v.chatworlds.bypass
- CustomWarps: Define one or more custom warps using /customwarp [warpname], that players can then use by typing /[warpname]
- EconPromotions: Players can buy ranks/promotions with the command /buyrank [rank]. Configurable costs and rank prerequisites. They can type /buyrank by itself to see ranks that are available to them
- Gameplay: Many different game mechanics modifications that can be turned on or off individually...
- CancelFlyingWhenDamaged, VillagerPermission, VillagerProfessions, Superchainmail, BouncySponges, EmeraldBlockHaste, FeatherFly, BlazerodFireball
- DamagedItemSales (lets Essentials /sell work with damaged items, more damaged equals less value),
- DeathRetention (keep some or all items when you die),
- SafeJukebox (play records without putting them in jukebox),
- UsefulCompass (compasses point to the nearest player)
- HelperBot: Will answer with preprogrammed responses when it says certain pairs of words in chat, setup by the admin. For example, if it sees "where" and "shops?" it might respond with "The shops are located in the downtown area, type /downtown to get there."
- ModVote: Players can type /modvote [name] to vote for that person to be a moderator. They can only vote for 1 person at a time, but they can change their vote. Ops can see the top votes for mod with /modvote top or reset the votes with /modvote reset
- PlayerPasswords: Players can type /password [pass] to save a password to a flatfile on the server, which can be used for player authentication on a web server or other software
- Playtime: Records total playtime of each user in users.yml, and the info can be accessed with the command /playtime. Ops can see other players' playtime with /playtime [name], or the top 10 players with /playtime top. Also can display the average daily playtime over the last 30 days in addition to total playtime
- PlaytimePromotions: Ranks/groups can be specified to autopromote players after a certain playtime has been reached (from a specific rank or from 'any' rank)
- RegionLabels: Announce to players as they enter/leave regions on the map
- TownyMods: Enhancements to towny...
- Findmyplot to teleport to your own plot, Findplot to teleport to the cheapest plot for sale, PlotSaleSign to put a for-sale sign on a plot, SethomeReminder when you buy a plot, RestrictedPlots purchasable only by certain groups
- WorldDate: Keeps track of the game date as well as time, starting at a specified year. Optionally announces as dawn/dusk approaches and the current game date, or use /date to see it whenever you want
Admin Features
- ChunkRegen: Ops can use /chunkregen to regenerate the chunk they are standing on, and optionally to clear everything at the level they are standing or above after the regeneration occurs
- Countdown: Ops can use /countdown [seconds] [message] to start a countdown, with the message broadcasting more frequently as the countdown approaches zero
- GamemodeAll: Ops can see who is in which gamemode with /gmall (including op and flying), or a specific player with /gmall [name], or set everyone's gamemode with /gmall creative|survival
- ModWarnings: Ops/permissible players can warn other players with /warn [name] [reason]. Keeps track of warning level, and can have commands autoexecute at each level
- OnlinePlayers: Generates a flatfile list of players on the server, updated automatically as players join and leave
- RegionProtect: Protect regions from block placement/destruction
- RegionRestore: Save the current state of a region (block data, chest inventory, etc), then restore it at a set interval or manually
- ServerLogArchive: Archives the server log every X hours or when an op runs the command /serverlogarchive
- WordSwap: Ops can define words to be replaced in chat with new words
Antigriefing Features
- AbandonedMinecarts: No more minecarts left behind blocking rail usage! Removes minecarts if they have no passenger and have been motionless for X minutes
- Antiadvertising: Detects IP addresses and domain names in chat, and handles them in 1 of 4 ways: mute (cancel the message), secretmute (show the message only to the person who sent it and to ops), replace (delete the ip/domain in the message but show the rest), or mutekick (cancel the message and kick the player who sent it)
- Anticaps: Prevent players from sending chat messages in all or mostly-all caps, and give them a message why when it happens
- AntiStickyKeys: Characters repeated 5 or more times are reduced to one, so "LOL!!!!!!!!!" becomes "LOL!" and "really........ ya think?????" becomes "really. ya think?"
- Antiovercrowding: Prevents more than X entities (mobs/animals/villagers) from being in a 9x9x9 area
- CommandsThatAutokickIfNotOp: You can define a list of commands that automatically kick any player from the server that tries to execute them while not being an op. Many hacking/modding clients like Nodus by default run certain commands when they login to test the limits of the server, like /give, this will make players running those clients unable to logon to your server until/unless they change the default configuration of their modding client
- OpOnlyFromConsole: Makes it so the op command cannot be executed by a player, only by the console
- UnkillableVillagers: Makes villagers immortal
Author Message
We are not allowed to sell Minecraft plugins (or even sell premium features), so Vitals come packaged with ALL features for you to pick and choose from. However, it broadcasts this message once every 4 hours: "This server uses the Vitals plugin, made by 6d7.com". We ask that you leave this message in so that other people will hear about this great plugin.
Commands/Permissions
"module", "permission", "command", "description"
- "announcements", "v.announce", "/announce [list,add,edit,remove]", "List or edit announcements"
- "antiadvertising", "v.antiadvertising.bypass", "", "Can send domains and IP addresses"
- "anticaps", "v.anticaps.bypass", "", "Can speak in all-caps"
- "arena", "v.arena", "/arena", "Participate in arena matches"
- "arena", "v.arena.admin", "/arena setup [1,2,3...,race1,race2,race3...,spleef,hunger]", "Define the location of an arena so players can be teleported * appropriately"
- "arena", "v.arena.admin", "/arena list", "List all arenas that have been set up"
- "arena", "v.arena.admin", "/arena delete [arenaname]", "Delete the setup for an arena"
- "arena", "v.arena.admin", "/arena start", "Start an arena match immediately (random type, or specific type with /arena start [type])"
- "arena", "v.arena.admin", "/arena end", "Terminate an arena match early (don't award prizes)"
- "auctions", "v.auction", "/auction", "Put an item up for auction"
- "auctions", "v.auction.startingbid", "/auction [startingbid]", "Put an item up for auction with a minimum bid"
- "auctions", "v.auction.skipqueue", "", "Can auction repeatedly without waiting for someone else"
- "auctions", "v.auction.bid", "/bid", "Bid on an item that is being auctioned"
- "betterhelp", "v.help", "/help", "See a list of commands you can use"
- "betterhelp", "v.help", "/help [command]", "See the description and usage for a command"
- "betterhelp", "v.help.admin", "/help [addbasic,addadvanced,remove] [command", "Add or remove a command to the list of basic/advanced commands"
- "betternews", "v.news", "/news", "See the latest server news"
- "betternews", "v.news.admin", "/news [add,change,delete] [message]", "Add a news, change the latest news, or delete the latest news"
- "bounties", "v.bounty", "/bounty", "See the top bounties"
- "bounties", "v.bounty.buy", "/bounty [player] [amount]", "Put up a reward for whoever can kill your named enemy"
- "chatworlds", "v.chatworlds.bypass", "", "Can see chat from all worlds and send chat to all worlds"
- "chunkregen", "v.chunkregen", "/chunkregen", "Regenerate the chunk you are standing on"
- "countdown", "v.countdown", "/countdown [seconds] [message]", "Start a countdown for the specified number of seconds, with the message broadcasting more frequently as the countdown approaches zero"
- "customwarps", "v.customwarp", "/customwarp", "List the custom warps that have been defined"
- "customwarps", "v.customwarp", "/customwarp [warpname]", "Define a custom warp that can be used with /[warpname]"
- "customwarps", "v.customwarp", "/customwarp [warpname] delete", "Delete a custom warp"
- "customwarps", "v.customwarps.[warpname] or v.customwarps.*", "/[warpname]", "Teleport to the specified custom warp"
- "econpromotions", "v.buyrank", "/buyrank", "See list of ranks you can buy"
- "econpromotions", "v.buyrank", "/buyrank [rank]", "Buy a promotion to a higher rank"
- "gamemodeall", "v.gmall", "/gmall", "See which players are in which gamemode, or flying, or op"
- "gamemodeall", "v.gmall", "/gmall [name]", "See which gamemode a specific player is in"
- "gamemodeall", "v.gmall.admin", "/gmall [survival,creative,adventure]", "Change the gamemode of all online players"
- "gameplay_blazerodfireball", "v.blazerodfireball", "", "Right-clicking with a blaze rod casts a fireball, but uses up the blaze rod"
- "gameplay_bouncysponges", "v.bouncysponges", "", "Sponges make you bounce when you step on them, and you take no falling damage when * landing on a spone"
- "gameplay_deathretention", "v.deathretention.weapons", "", "Can keep weapons when you die"
- "gameplay_deathretention", "v.deathretention.armor", "", "Can keep armor when you die"
- "gameplay_deathretention", "v.deathretention.tools", "", "Can keep tools when you die"
- "gameplay_deathretention", "v.deathretention.allitems", "", "Can keep all items when you die"
- "gameplay_deathretention", "v.deathretention.experience", "", "Can keep experience when you die"
- "gameplay_bouncysponges", "v.bouncysponges", "", "Sponges make you jump high (bounce) when you walk on them"
- "gameplay_emeraldblockhaste", "v.emeraldblockhaste", "", "Emerald blocks make you sprint when you walk on them"
- "gameplay_featherfly", "v.featherfly", "", "Right-clicking with a feather lets you fly, but it uses up feathers over time"
- "gameplay_safejukebox", "v.safejukebox", "", "Clicking a jukebox with a record plays the record without inserting it into the jukebox"
- "gameplay_superchainmail", "v.superchainmail", "", "Your chainmail armor provides damage reduction"
- "gameplay_usefulcompass", "v.usefulcompass", "", "Your compass points toward the nearest player"
- "gameplay_villagerpermission", "v.villagerpermission", "", "Can trade with villagers"
- "helperbot", "v.helperbot", "", "HelperBot will respond to you when it sees a pair of words in your chat that match one of its responses"
- "helperbot", "v.helperbot.admin", "/helperbot [word1] [word2] [response]", "Set a response for HelperBot to give when it sees a pair of words in * chat"
- "modvote", "v.modvote", "/modvote [player]", "Vote for who you think would make the best moderator"
- "modvote", "v.modvote.top", "/modvote top", "See the top players voted to be moderator"
- "modvote", "v.modvote.reset", "/modvote reset", "Reset all the votes for moderator"
- "modvote", "v.modvote.mod", "", "You can't be voted for because you are already a moderator"
- "modwarnings", "v.warn", "/warn [player] [reason]", "Warns a player for inappropriate behavior"
- "modwarnings", "v.warn.exempt", "", "Immune from being warned"
- "playerpasswords", "v.password", "/password [password]", "Set a password associated with your account which is saved to a flatfile, for use in * * * external authentication such as on a website"
- "playtime", "v.playtime", "/playtime", "See how long you have been playing on the server"
- "playtime", "v.playtime.top", "/playtime top", "See the list of players with the highest playtime"
- "playtime", "v.playtime.others", "/playtime [player]", "See how long another player has been playing on the server"
- "playtime", "v.playtime.edit", "/playtime [player] [minutes]", "Set a player's total playtime manually"
- "playtime", "v.playtime.average", "", "Show the average daily playtime over the last 30 days (in addition to total playtime) on all playtime reports"
- "regionlabels", "v.regionlabels", "", "Tells you when you enter or leave a region that has been labeled"
- "regionlabels", "v.regionlabels.admin", "/regionlabel [name]", "Define a region to be announced to players as they enter or leave it (ignoring the Y * coordinate, thus going from bedrock to sky)"
- "regionlabels", "v.regionlabels.admin", "/regionlabel [name] exact", "Define an exact 3d region to be announced to players as they enter or leave it * (x,y,z cuboid)"
- "regionlabels", "v.regionlabels.admin", "/regionlabel [name] delete", "Delete a region label"
- "regionprotect", "v.regionprotect", "/regionprotect [name]", "Define a region to be protected from block placement and destruction"
- "regionprotect", "v.regionprotect", "/regionprotect [name] delete", "Unprotects a region"
- "regionprotect", "v.regionprotect.bypass", "", "Can place/break blocks in protected regions"
- "regionrestore", "v.regionrestore", "/regionsave [name] [inventory,all]", "Save the current state of a region (you'll be asked to click opposite corners * of the cuboid region)"
- "regionrestore", "v.regionrestore", "/regionsave [name] interval [minutes]", "Sets an interval for a saved region to be restored periodically"
- "regionrestore", "v.regionrestore", "/regionsave list", "Lists the regions saved for restoration"
- "regionrestore", "v.regionrestore", "/regionrestore [name]", "Restore the state of a region"
- "serverlogarchive", "v.serverlogarchive", "/serverlogarchive", "Archives the server log immediately"
- "townymods_findmyplot", "v.findmyplot", "/findmyplot", "Teleport to your plot"
- "townymods_findmyplot", "v.findmyplot.others", "/findmyplot [player] [plot#]", "Teleport to another player's plot"
- "townymods_findplot", "v.findplot", "/findplot", "Teleport to the cheapest plot for sale"
- "townymods_plotsalesign", "v.plotsalesign", "/plotsalesign", "Place a grass/wool for sale sign on the current plot"
- "townymods_plotsalesign", "v.plotsalesign", "/plotsalesign [material]", "Place a wool and [material] for-sale sign on the current plot"
- "townymods_plotsalesign", "v.plotsalesign", "/plotsalesign [material] remove", "Remove a for-sale sign on a plot, replacing it with [material]"
- "townymods_restrictedplots", "v.restrictedplots.buy", "", "Can buy restricted plots (all plots at the configured 'restricted price')"
- "wordswap", "v.wordswap", "/wordswap [word] [replacement]", "Replace words in chat with other words"
- "wordswap", "v.wordswap", "/wordswap [word]", "Cancel a word replacement"
- "worlddate", "v.date", "/date", "See the current in-character date and time"
- "worlddate", "v.date.admin", "/date [mm/dd/yyyy]", "Set the current game date"
Thanks for a speedy response! I will try what you said with negative perms, however I seem to remember having * and op and a negative perm just ignoring the negative perm. I will try though. If it dosent work is there a possibility of that feature being toggle able ?
I really like this plugin and have used it since v0.22. I was using all of the features without an errors. Everything was fine until I updated to v0.32.
I am OP on my server and I can use the vtoggle to turn the features on and off. The problem happens when I try to use the features I get the error "you do not have access to that"
Even after giving myself the v.admin permissions I still get the same message.
Any Ideas??
I've now loaded a clean Craftbukkit server and still have the same msg "you do not have access to that"
@pzxc
It was enabled and after I changed the number I reloaded the plugin so the change applies. I'll try again in a bit to see if it still isn't working for me. Edit: Still didn't work for me. I tried with voxel sniper this time to spawn the mobs faster. config - http://pastebin.com/tztv0NY1
I have antiadvertising: true but people can spam ips without problem...
Also how can i change the texts of the auction messages?
/vitreload doesn't works, it just says uknown command the command is /vreload (you writed bad in the "Installation / Configuration" comments but is well writed whith the rest of commands.
The permission for auctions is "v.auction" not "vitals.auction", in the first time you write about auctions is wrong writed, but in the perms on the botton of the page is fine :)
Note. This is for older version of Vitals but it helped me, so I hope it helps you. Also I found all of this in the forum (Help).
Issue with setting up arena go here and read this. http://dev.bukkit.org/server-mods/vitals-plugin/forum/help/39942-can-not-end-or-start-a-match/#p7
Issue with Vault go here and read this. http://dev.bukkit.org/server-mods/vitals-plugin/forum/help/39825-vitals-didnt-find-vault/#p4
Issue with Vitals loading go here and read this.. http://dev.bukkit.org/server-mods/vitals-plugin/forum/help/39275-trouble-loading-vitals/#p7
I'm running Vitals 0.32, Vault 1.2.17,mChatSuite b275, and BOSEconomy 0.7.3.1a. So far everything is working fine.
Thanks Notownz
@Manuestaire ... Regarding announcement changes via /announce not taking effect immediately, this is fixed in upcoming v0.33. Regarding arena setup, I will be adding a section specifically about the arenas and how it all works soon to the main page here on devbukkit.
@JM120897 ... Regarding editing bounty messages, soon I will adding a separate config file for all the various messages that Vitals generates with all its features. This will allow you to edit the text that appears for various commands (including bounties) if you want to put it in a different language or just edit it a bit. I doubt this will be in version 0.33, maybe the one after that, but I'll try to get it in as soon as possible.
@_Ronald_C_ ... Both vault *and* a vault-compatible economy plugin, like BOSeconomy or iconomy, is required. Personally I use BOSeconomy
@Baffu ... Regarding auction messages, there is a permission v.global.muteeventbroadcasts. This permission prevents you from seeing any event broadcasts, like auctions and arena announcements. If you are granted the * permission because of your permissions plugin or having op status, you'll need to give yourself or your group the negative permission -v.global.muteventbroadcasts to cancel them being hidden. This should be the only negative permission you need to worry about though, it's in there because I use it for my newbie rank "Wanderer" when players are new to the server, they aren't overwhelmed by event broadcasts and can get used to the server before being introduced to auctions and arenas.
v.playtime.average lets you see your own average playtime (with /playtime), and if you have permission to see someone else's playtime (with /playtime [name], permission v.playtime.others) you see their average as well as total, and if you have permission to see the top playtime list (with /playtime top, permission v.playtime.top) you see the total and average for each person on the top 10 list. The permission v.playtime.average lets you see average playtime as well as total on all 3 screens. Without v.playtime.average you only see the total playtime, not average.
You can already set a min price for an auction... you need the permission v.auction.startingbid. With that permission it allows you to use /auction [startingbid] like you suggest. Without that permission any auction you start has a minimum bid of 0.
Your other suggestions about playtime commands and more colors, I have written down and will keep them in mind.
Ok so,
Everyone can see the auction messages but me! I am op and have * perms! I do not see the blue [Auction] message or anything!
Also, I would like to be able to set a min price for an item to sold with in an auction! IE /auction 300 would set a min of 300 for the auction!
v.playtime.average - default op-only - shows the average daily playtime over the last 30 days (plus total playtime) when using /playtime [name] or /playtime top
Is this average playtime of all players on the server or me?
A bug?
My users say they can not see the countdown messages I create?
Im using PEX and Essentials Chat
I like the plugin! I have some ideas:
1. Please allow me to have commands executed after people have X playtime. I would like to reward players with like a diamond every few days of playing! Thats just an example that would be a bad perk.
2. Please color more outputs! For example /playtime looks messy and some color on the times or something would make it look a bit better
3. Auctions: I did not see the message that my users did about the auction, it would be nice to see the message about my item for sale.
@pzxc
I do use Essentials, but not Vault, could that be the problem? I haven't seen an error message as of yet, but with those hundreds of lines when I start the server, it's very much possible I missed it when it happened.
When starting my server the Vitals plugin and the Vault plugin get loaded, but when the Vitals plugin is set to be enabled it gets disabled due to: [SEVERE] [Vitals] Vitals v0.3 - Disabled because of missing dependency (Vault) I've tried with both the newest Vault (1.2.18) and the one before that (1.2.17).
Is it because neither are written for 1.3.1-R2.0 and Vitals is?
I haven't updated Bukkit to 1.3.2-R0.1 yet by the way.
Does someone knows how to edit the display message when you kill someone and you get rewarded? (bounties)
@Manuestaire
Another thing I found, is that when you add or edit announces, chat messages do not change until reload, maybe you could change this to automatically reload the announcements.txt after using any /announce command
Thank you
@pzxc
Thank you.
Someone could explain me how do arenas work, and the steps to setup one, if i try so, i'm said an event is running.
@Fengshen ... check your server log, or watch the console when the server first starts, see if there's any error messages that might explain why the plugin isn't loading. Only thing that comes to mind, is that you need the Vault plugin and a vault-compatible economy plugin (like essentials or boseconomy). Do you have those?
@midnightfang22 ... it should work with any/all entities whether they come from a mob spawner or spawn naturally. Did you enable the overcrowding feature? Try /vtoggle antiovercrowding
@Manuestaire ... Countdowns are cancelled with /countdown stop. Right now warn levels in chat is either on or off, no way to show it for some users and hide for others, but I can add that in the next version. Same for lowering warn levels manually, I'll add that in the next version (0.33)
@Manuestaire
/countdown stop
I can't find any myself. maybe the author will add it or it wasn't listed in an update?
same as above
Can contdowns be cancelled?
Is there any node to prevent normal users seeing warn levels when people chat?
Can warn levels be lowered manually?
I just tried to use the new overcrowding feature and it doesn't seem to work. I set the max to 10 so I could test it and the mobs I am spawning aren't committing suicide. Does it not work with mob spawner eggs? http://i46.tinypic.com/28vanmo.png
Hey there! Just found out about Vitals and wanted to install it on my server. Put in the plugins folder, as described in the installation guide, but for some reason, the server doesn't load the plugin. The commands aren't available and it didn't write any yml files.
Do you have any idea what could be wrong here?
Cheers, Feng