xTeam
xTeam Plugin
Brief Description
xTeam is a team-based PvP plugin that allows for creating and joining teams, setting a headquarters and various other features. It is meant for use on hardcore PvP servers where land is not protected.
This is a mod I've been working on for some time. Initially I figured a mod like this would be made eventually and I would just switch to using the alternative instead of mine but surprisingly I haven't quite found an equivalent. Factions is nice but if you want more of a 'hardcore' team plugin, then this mod is for you.
____________________________________________________________________________
!!! IMPORTANT !!!
Version 1.8.1 of the plugin contains an Anonymous Error Reporting feature for sending errors directly to me when they are thrown.
This feature does not reveal any private information. In fact the only one thing that could possibly identify the client is encrypted even from me. The benefit of this feature is that I can see which errors are happening the most and fix them more quickly. Having said that, there is an option in the configuration file to disable this feature by setting 'anonymouserrorreporting = false' if you feel so inclined. Just know that if this is disabled, I will not be able to see what errors are happening frequently from your server.
____________________________________________________________________________
Command Aliases: '/team', '/xteam', '/xt'
Command Parameters: {optional} [required] pick/one
Features
- create and join teams
- get info for any team
- change the team tag
- set a headquarters
- rally team to a location
- teleport to teammates and headquarters
- teleport to return location that is saved upon using any of the other teleport functions
- teleport to rally location set by team leader
- promote and demote players to use team admin commands
- team chat function to toggle between team chat and regular chat
- disable friendly fire
- wolves can be team members too!
- default teams for automatic joining on login
Team User Commands
- /team - main help menu for xTeam
- /team {help} {Page} - user help page for xTeam
- /team info {Team/Player} - get team info or other team's info
- /team list - list all teams on the server
- /team create [Name] - create a team
- /team join [Team] - join a team
- /team leave - leave your team
- /team accept - accept the most recent team invite
- /team hq - teleport to the team headquarters
- /team tele {Player} - teleport to nearest or specific teammate
- /team return - teleport to saved return location (1 use)
- /team rally - teleport to team rally location
- /team chat {On/Off} - toggle chatting with teammates
- /team message [Message] - send message to teammates
Team Admin Commands
- /team sethq - set headquarters of team
- /team invite [Player] - invite player to your team
- /team promote [Player] - promote player to team admin
Team Leader Commands
- /team demote [Player] - demote team admin
- /team disband - disband the team
- /team open - open team to public joining
- /team remove [Player] - remove player from your team
- /team rename [Name] - rename the team
- /team tag [Tag] - set the team tag
- /team setleader [Player] - set new leader for the team
- /team setrally - set rally point for the team
Server Admin Commands
- /team chatspy - spy on team chat
- /team debug {Option} - server admin debug menu for xTeam
- /team disband [Team] - disband a team
- /team demote [Team] [Player] - demote team admin
- /team hq [Team] - teleport to team headquarters for team
- /team promote [Team] [Player] - promote player to admin
- /team remove [Player] [Team] - remove player from team
- /team rename [Team] [Name] - rename a team
- /team tag [Team] [Tag] - set team tag
- /team open [Team] - open team to public joining
- /team set [Player] [Team] - set team of player
- /team sethq [Team] - set team headquarters for team
- /team setleader [Team] [Player] - set leader of team
- /team setrally [Team] - set team rally point for team
- /team teleallhq - teleports everyone to their headquarters
- /team tpall [Team] - teleports a team to yourself
Console Commands
- team {help} - console help menu for xTeam
- team debug {Option} - console debug menu for xTeam
- team demote [Team] [Player] - demote team admin
- team disband [Team] - disband a team
- team info [Player/Team] - get info on player/team
- team list - list all teams on the server
- team promote [Team] [Player] - promote player to admin
- team remove [Player] [Team] - remove player from team
- team rename [Team] [Name] - rename a team
- team tag [Team] [Tag] - set team tag
- team open [Team] - open team to public joining
- team set [Player] [Team] - set team of player
- team sethq [Team] [World] [X] [Y] [Z] - set headquarters of team
- team setleader [Team] [Player] - set leader of team
- team setrally [Team] [World] [X] [Y] [Z] - set rally point of team
- team teleallhq - teleports everyone to their headquarters
Permission Support
- Supports bukkit SuperPerms (PermissionsEx, PermissionsBukkit, and bPermissions, etc.)
Permissions Nodes
- xteam.core.user.accept - Allows team users to accept an invitation
- xteam.core.user.chat - Allows team users to chat/msg their team
- xteam.core.user.create - Allows team users to create a team
- xteam.core.user.headquarters - Allows team users to teleport to headquarters
- xteam.core.user.info - Allows team users view team info
- xteam.core.user.join - Allows team users to join a team
- xteam.core.user.leave - Allows team users to leave a team
- xteam.core.user.list - Allows team users to list all team names
- xteam.core.user.return - Allows team users to return to saved location
- xteam.core.user.rally - Allows team users to rally to a location
- xteam.core.user.tele - Allows team users to teleport to teammates
- xteam.core.user.* - All team user core commands
- xteam.core.admin.invite - Allows team admins to invite other players
- xteam.core.admin.promote - Allows team admins to promote teammates
- xteam.core.admin.sethq - Allows team admins to set a headquarters
- xteam.core.admin.* - All team admin core commands
- xteam.core.leader.demote - Allows team leaders to demote teammates
- xteam.core.leader.disband - Allows team leaders to disband a team
- xteam.core.leader.open - Allows team leaders to open team to public
- xteam.core.leader.remove - Allows team leaders to remove players
- xteam.core.leader.rename - Allows team leaders to rename team
- xteam.core.leader.setleader - Allows team leaders to set leader of team
- xteam.core.leader.setrally - Allows team leaders to set rally point for the team
- xteam.core.leader.tag - Allows team leaders to set team tag
- xteam.core.leader.* - All team leader core commands
- xteam.core.serveradmin.chatspy - Allows server admins to spy on team chat
- xteam.core.serveradmin.debug - Allows server admins to debug the plugin
- xteam.core.serveradmin.disband - Allows server admins to disband a team
- xteam.core.serveradmin.demote - Allows server admins to demote a player on a team
- xteam.core.serveradmin.hq - Allows server admins to teleport to any headquarters
- xteam.core.serveradmin.promote - Allows server admins to promote a player on a team
- xteam.core.serveradmin.reload - Allows server admins to reload the configuration file
- xteam.core.serveradmin.remove - Allows server admins to remove player from a team
- xteam.core.serveradmin.rename - Allows server admins to rename a team
- xteam.core.serveradmin.tag - Allows server admins to set team tag
- xteam.core.serveradmin.open - Allows server admins to open a team to the public
- xteam.core.serveradmin.set - Allows server admins to set the team of a player
- xteam.core.serveradmin.sethq - Allows server admins to set the headquarters of a team
- xteam.core.serveradmin.setleader - Allows server admins to set the leader of a team
- xteam.core.serveradmin.setrally - Allows server admins to set the rally point of a team
- xteam.core.serveradmin.teleallhq - Allows server admins to teleport everyone to their headquarters
- xteam.core.serveradmin.tpall - Allows server admins to teleport a team to current location
- xteam.core.serveradmin.* - All server admin commands
- xteam.core.* - All core commands
Configuration
Contains data that the plugin uses universally - feel free to change the values to suit your needs. Also contains the permission nodes for the plugin. Use these inside whatever permissions plugin you desire to enable or disable commands for certain people or groups.
NOTE: As this project is still in Beta stage, I will be adding/changing features until I'm satisfied with the basic functionality of the plugin. For updating to a newer version of the plugin, check to see whether there are any configuration file changes. If so, you will want to reload the configuration file or add the new options yourself.
FAQ
Many of the frequently asked questions about the plugin.
Source Code Repository
Feel free to download the current source code at https://github.com/protocos/xTeam/
Links
Donations
I work on this project in my spare time and I will always have a love for Minecraft no matter what, but it certainly does make me smile when people feel like contributing. Donating to the project helps encourage me to continue providing support and feedback to all of you awesome peoples! If you feel like helping out, there's a link at the top right of the page. ;)
Bug Reports
Please leave any questions, comments, concerns, and potential bugs in the comments. I will try to squash them when I can. Having said that, I am a real human being, so if the bug is not fixed right away, please be patient.
@deathwing911
Haha, don't be sorry, any concern of a user is a concern of mine.
I was under the impression that many of the permissions plugins can handle this. As in instead of giving global permissions to a default user group, just give them to the default group in each world. For instance, on my server, I use PermissionsEx. In order to limit certain permissions to one world all I would have to do is add something like this under the permissions section for the server:
worlds: world_survival: permissions: - xteam.*
(cannot space it correctly in a comment but look here for a better idea: http://pastebin.com/hBbgeASP)
In this case, whatever group that this example code is under has access to all xTeam commands in world "world_survival".
If that doesn't work for you let me know and I'll see what I can do. It is possible to add a feature like this but might be extraneous.
hey, sorry about asking this i know lots of people have already ask stuff but i was wondering if you can maybe maybe add a little option . let say i got multiWorld server and i want to have xteam in one world but normal freeforall arena in a other by adding a option that i can disable xteam in a specific world ? is that possible ?
that would make lots of peoples i know happy. thanks making this plugin
@AlfieC
I'll try to work on this, but not sure exactly how it will turn out. I think what I will do is add a configuration option to show player team as a prefix. Might add in the next version.
@TaterTotsYum
Would this be separate from the teleport delay configuration option? In the configuration file, setting 'teledelay=15' might solve your problem because it would require the player to stand still for 15 seconds. This is only used when monsters and other non-teammates are nearby (and by 'nearby' I mean the other config option enemyproximity which is by default 16 blocks). This could be done fairly easily so it might be in the next update. But I'd like to see if more bugs turn up in the current version so all of it can be fixed/added at once.
Could you please add a 15 second cool down from PvP before someone can teleport away to an HQ?
Any way we can integrate it with ChatManager to show the team someone is on?
@cyclo666
This was actually the original plan but I see why it could become a nuisance. Fixing the event handlers is what "enabled" this feature although I intended for it to be enabled all along. Thanks for the tip. The newest version 1.4.3 has a configuration option in the config file (you will either have to reload the config or add the option yourself). Set the option 'hqondeath=true' to 'hqondeath=false' and it should spawn the player at the world spawn.
Having an issue with players being teleported to their HQ on death, even in worlds where xteam isnt enabled. I can't find any mention of this 'feature' in the description, or how to disable it.
I'm using the latest version. This wasn't happening with 1.30
@Nickbbeezy
Interesting. What would be the criteria for pitting one team against another? Total team kills? Total other team headquarters found? Most players? Longest lasting team since creation? Total number of deaths for a team? Team with the average longest surviving players? Would it be something like the power factor for factions? How exactly would it be determined who is at the top?
Could there be maybe team leader boards to check team stats so the teams could compete?
Ok, the newest version 1.4.0 has been released and it has a few new features. Among them: configurable default teams, a few more options for server admins to utilize such as '/team set', and other minor tweaks. Check the change-log on the downloads page for full details. The new features, especially the configurable default teams, took a little while to implement because I had to tweak the code in quite a few places. I'm almost certain there are a bugs here and there that I missed. If you could, just leave a comment below and I'll get on it as soon as possible. For anyone who requested a certain feature here or there and it isn't in this update, note that I am probably still looking into it. Some features are just harder to implement.
Thanks.
@protocos
Thanks. I just ended up getting rid of the plugin folder and reloading it. Thanks a ton. saved me 3 hours of work with factions.
@anOnlineUser
Hmm. If you created the team yourself, it should have made you the leader. Which should have allowed you to set the hq yourself. However, if you give yourself admin privileges by adding the xteamadmin.* permission node to your profile, then you can use the '/team setleader [teamname] [your-name-here]' command to set you as the leader for that team.
Hey, so im working with this plugin on my server, and i dont have permissions. Whenever i try to make an HQ for a team, it says "You are not the team Admin". Is there any way to promote myself through commands or the config?
or just change the HQ location for a team in the config?
@protocos
ah thanks for the tip , much better now.Dosent matter if its lower priority this is just a bonus.Thanks for looking into this.
@deathwing911
To turn team-hide-names off there should be a boolean value in the configuration file. Under the spout preferences section just change 'teamhidename=true' to 'teamhidename=false'. I can look into compatibility for other mods but it might take a lower priority to some other things.
Thanks for the input looking forward to that , just a minor bug ,im running your plugin with a other on called Rpgessentials and this plugin changes the players name by adding a LVL3 next to it .But when i setup a team the lvl of my teammates disapear and i see no green names.Its maybe both plugin trying to modify the name at the same time and the server dosent like it lol.
So is there a way to add a possible option in the config to be able to change the way teams are shown because other plugins might have problems.
Or maybe keeping all the same thing but adding the compatibility to have other plugins that changes the name at the same time.Hope that you understand what i mean .
thanks for making this awesome plugin. keep up the Good work 100 %"support !
@ezbik
Thanks for the report. Problem fixed.
@deathwing911
I'll see what I can do. I posted something on the forum. During spring break I had no internet so that's why I haven't responded. I'll add your idea to the list of possibilities - might appear in a future update. I should at least have something out this week with a few new features (no guarantees on this specific one though).
@protocos hi , i am currently using your plugin on my pvp server and its really great stable and have no error so far.Been looking too for a simple plugin as this.All the features are awesome.
But can i make a feature request ? like a timer "peace time" programable with a spout GUI skin on the screen . So that peoples can get ready for battle and then when the timer is off pvp goes enable and the fight starts.
Just noticed this in the console, not sure the circumstances of the error though, and it only appeared once, didn't appear to effect gameplay, least nothing that anyone reported:
@protocos
Awesome, thanks for the fix and additions! Been looking for a simple team plugin like this for a while, does exactly what I need. :D