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.
@zachrywilsn
1. I like the team pick colors idea, and it sound a bit like a TagAPI option, which I will be exploring soon. 2. Rank and prefix has been suggested before, and I see how that can be valuable additions. 3. I will add the inactivity delete to the backlog, thanks for the suggestion!
@xs0lidus
I have been seeing some of these lately from various clients, I am still investigating the issue and have not been able to replicate it on my end yet. It has something to do with the locations stored in the players.txt file and how the location is retrieved. My first hypothesis is that somehow the world that is stored in the players.txt file is corrupted, hence the NullPointerException when it tries to load it back into memory.
If you could do me a huge favor and go into your "players.txt" file and copy one of the "lastKnownLocation" attributes from one of the players and PM it to me? It should look something like "lastKnownLocation:world,1.1,2.2,3.3,4.4,5.5".
Error on startup -> http://i.imgur.com/lo23i6T.png
@protocos
Suggestion, just thoughts not issues.
Teams should be ability to pick the team color. Not server owner pick. Team Chat You should still be able to see your team prefix or maybe both rank and prefix. Team delete after leader has been afk from server for so many days if not already added.
Think thats it! Works Flawless!!!!!! 100% Flawless I say!
Want to see some pretty happy players PM me an I can give you our Ip.
@helptiger
Currently there is no integration with chat manager or any tag APIs. I do intend to add this, but right now I don't have a release in mind where it gets included just yet.
Thanks for the input though.. Hearing from users does help me prioritize what needs the most attention.
Is there a way to integrate the xteamtag into essentials chat or another chatmanager? I'd like to set the position of the xteamtag. thanks
@zachrywilsn
So, occasionally the server adds asynchronous tasks to monitor things like team invites or if a player is waiting on a teleport. This was something I left in for my sanity when I was testing to make sure the tasks were canceled if the server is reloaded.
Essentially, if you reload the server, the invite tasks and teleport tasks will be canceled.
You bring up a good point though in that it shouldn't be flooding the console. I will disable the messaging in the next update. ;)
@protocos
All is working great!!! Just wondering why do I see this on restarts and it seams to get loner each time?
@protocos
My players wont mind that there teams where lost, etc. I had it in for only 2-3 days. They loved it, but it wont hurt them to do a few extra commands over again.
@zachrywilsn
So what the newest version will do is essentially cope with the corrupted data. The only thing that will be lost is the headquarters. Like I was saying though, I could detail a procedure for you if you absolutely need to save the data... Let me know what you think.
@protocos
I can just restart there teams. It wont be a issue. Unless i cant just restart it from scratch... :/
@zachrywilsn
So the next update will actually be a bit of an experiment for me. I did a little refactoring to the plugin to better allow for extensions. I should be including the first extension in the next update along with some fixes to issues I found from anonymous error reports. I would say at this point that the ETA is somewhere within the next week, so keep an eye out for it. ;)
Also, I should note that the problem you were having was most certainly to do with the fact that your world names had spaces in them. This issue has been fixed but it will mean that the previous data is corrupted. Unless you fix the data yourself before the next update, The broken locations will be overwritten with default blank data. Let me know in a PM if you need help recovering data. Sorry about that.
@LegendaryAdmin
Hmm, I hadn't thought about it. I will add it to my backlog. Thanks for the input!
Love the plugin, a lot of great configurations =]
Suggestion: Can we please make /team chatspy remain enabled between logins? Most of our mods forget to turn this on, myself included, on a regular basis. It would be nice if we could just enable it once and leave it =]
Any Eta? no rush.
@Freddytheunknowledgeable
I hate to ask this, but are you 100% positive you configured your bPermissions config file correctly? The permission node you are looking for is 'xteam.core.user.headquarters' if it helps... Let me know if the problem persists and I'll look into it more. You may have to help me out and pm me your permissions file so that I can try to replicate it on my end in order to fix it.
@zachrywilsn
Thanks for the help! As a developer, it really helps to have detailed information. I believe I fixed the issue with the world names, but the build is not ready to be pushed out yet.
@zachrywilsn
Thanks a ton! It means a lot to me more than anything. ;)
@protocos
Set Some Support. Hope It Encourages You To Keep This Up! Not A Huge Amount I Know. I Just Wanted To Say Thanks For This From All The Players On My Server!
@Freddytheunknowledgeable
You may have something like "xteam.core.user.headquarters " try xteam.core.user.hq also!
Hope that helps!
Hello, I gave the permission node to the group I wanted to use "/team hq" however it says "Permission Denied" what do you think is wrong? Also we're using bPermissions.
@protocos
As We confirmed its a world name issue with spaces. I'm posting this just in case someone else has the issue in future. V1.8.1 is confirmed to not allow spaces in world names.
Example: World_Nether works "World Nether" does not work.
"I'm on a build down currently an will report issues if any."
Thank you for looking into this short coming. An I hope you can fix the restart Issue also. Any Info you need I'm sure I can provide you with.
@zachrywilsn
To help me see what exactly the data looks like, can you pm me your 'teams.txt' file? I think what is happening is that your data has been corrupted somehow. Did you change the file in any way? Or is this happening after a fresh boot up?