
Ultimate Teams
A simple yet complete Teams/Clans plugin for Minecraft, with cross-server support.
This version fixes a specific performance issue that would happen on Leaf when using team echests, and also slighly improves performance on all other Paper forks
- Fixed team/ally chat showing on Discord when using DiscordSRV
- Fixed an error that would sometimes happen when using SQLite
- Added apollohook to show LunarClient players the team home position as waypoint and to mark team members
- Added a new setting to sort the Teams in the team list GUI by most members / owner online status (more details in the config)
- Fixed an issue that would reset the player yaw and pitch (where you're looking) when using HuskHomes
- Various optimizations and fixes
Fixed a dupe glitch with the team enderchests
🚀 New Features & Additions
- Full PlaceholderAPI Support: PAPI placeholders are now fully supported across all GUIs, team chat, and ally chat.
- Toggleable Allies & Enemies: Added new settings (
team.allies.enabledandteam.enemies.enabled) to completely toggle the ally and enemy systems on or off. Commands and GUIs will adapt accordingly. - Team Bank Limits: You can now set a maximum bank balance! Limits are strictly enforced during manual deposits and when accepting invites with join fees (fixes #122).
- "Not in Team" GUI: Introduced a brand-new GUI specifically for players who are not currently in a team.
- Separated Cooldowns: Team Home and Team Warps now have their own independent separate cooldowns.
✨ Improvements & Changes
- MineDown Implementation: Converted all plugin messages to use MineDown, allowing for much richer and more flexible text formatting.
- Configuration Overhaul: Fully migrated the config, messages, and GUI configuration systems to use
ConfigLibinstead of Annotaml. - Fixed Economy Formatting: Improved currency name selection so it properly displays singular or plural forms depending on the amount.
🐛 Bug Fixes
- Fixed an issue with team list messages displaying incorrectly.
- Prevented players from paying a team join fee if it would exceed the team's bank limit.
⚙️ Under the Hood
- Completely refactored message accessors and configuration loading to be more efficient.
- Performed major code cleanup: removed unused dependencies (
annotaml,boosted-yaml), tidied imports, and fixed minor typos in config comments.
The primarly reason i changed the config lib is to not ask you to delete the config, messages or teamsgui file everytime i change a setting, and also to improve the config itself. So this is the LAST time you will need to delete a file
TO UPDATE:
Delete the config.yml, messages.yml and teamsgui.yml files.
This build is production ready, but you might still find some minor bugs, if so please let me know in the Discord server or on the GitHub's issues page
Added:
- Display team join fee and currency in invitation messages
- made team GUI member/manager/ally/enemy name colors configurable.
To update:
To update you need to regenerate your teamsgui.yml file.
You also need to regenerate your messages.yml file, otherwise you can add this line in the team invite message:
"[Join fee:](yellow) [%FEE%](gold)[%CURRENCY_NAME%](green)"This version implements quite a bit of new features / bug fixes that some of you have reported!
Additions:
- Added an option in the config to cancel teleports if a player moves / is damaged
- Added an option to disable the team echests backup message
Fixes:
- Fixed a bug that would still send team/ally chat messages to player who disabled it
- Fixes the team list GUI colors
- Other minor fixes / code refactoring
To update, you need to regenerate the config and messages files
fixed error with placeholders while using some plugins like ChatControl
Added team EnderChests migration and minor code optimizations
Do i need to migrate my team EnderChests?
only if you are currently on 1.21.4 or below, or you did update to 1.21.5+ and you are having errors in the console.
how to migrate: https://ultimateteams.gitbook.io/ultimateteams-docs/setup/team-enderchests-migration
if you have any issue, join the Discord server
1.21.4+ ONLY
to prevent any future issue with the team EnderChests, and to be able to use new features available only in the latest versions, i had to update to 1.21.4+. I noticed from bStats that 90% of the servers are already on those versions, so i don't think it'll be a problem.
Addition/fixes:
- improved formatting in teamchat/allychat
- fixed an error for H2 database users
- added a placeholder that shows the team name without colors (%ultimateteams_team_name_raw%)
FOR 1.21.4 USERS OR BELOW:
do not update your server version if you are using team enderchest or the echests data might get corrupted
tomorrow i will publish a new version to migrate the data
- Optimized the plugin's performance
- Fixed a placeholder that was not replaced
- fixed notification for /team transfer in both single and cross-server mode
- fixed duplicate message that would happen in some cases for cross-server users
- improved data consistency
- more that i cannot remember
Thanks @gbpii for your help
Modified the priority in the chat handler to ensure compatibility with some plugins configuration
-
removed some debug messages that would appear in the console while shooting/destroying cystals
-
improved efficency/memory usage of the plugin
-
Fixed error on folia while using teamenderchest
Fixed an error that might happen when a bedrock player joins the server
Fixed an error that would restrict pvp even for teams with pvp enabled
fixed team and allies chat not formatting color codes
Fixed an error in the messages file To avoid regenerating the file, you can modify the related section like this:
(team.info section)
join-fee: "&3Join Fee: &a%AMOUNT%" motd: "&3MOTD: &a%MOTD%"If you skipped v4.7.5 check the related changelog before updating
Additions:
- team MOTD. Players can now set a short message describing their team. the MOTD can be sent to players when they join the team (check the config)
- allychat can now be enabled for every message like team chat
- Added an option to additionally check a regex for team names/prefix/motd. (configurable separately for each one)
- A lot of new placeholders (old ones are still supported) https://ultimateteams.gitbook.io/ultimateteams-docs/hooks#placeholderapi
TO UPDATE
reset both your messages and config files
Fixed paper API version, improved developers API
New Plugins Wiki: https://ultimateteams.gitbook.io/ultimateteams-docs
This is to be considered a major version, because of the big changes i've done.
So please read carefully and do not just drag and drop the file
New Features:
- Team Bank. Teams can now deposit and withdraw money from the team bank
- Team Join Fee. an option can be enabled to allow team owners (and managers) to set a join fee, that will automatically taken from players upon accepting an invite
- Invites now send a message featuring buttons to accept/deny the invite
- invites can now be sent with just /team invite
- there is a new option in the config to always open the team list GUI when using /team list
- The messages now use MineDown, being 100% customizable, and the config has a new format to help finding messages
- Players can now disable invites /invites <enable/disable>, so a player with disabled invites can't be invited in a team
- the chatspy command now has some alies to prevent other plugins overriding the command: /teamchatspy, /tchatspy
- Added 3 new perms for team managers: FEE (manage the join fee), DEPOSIT (deposit money into the team bank), WITHDRAW (withdraw money from the team bank)
Fixes:
- Message sent upon wrong usage of the allychat is now customizable in messages.yml
- Message sent upon wrong usage of the team create command is now customizable in messages.yml
- Switched to the paper integration of the command manager for better performance
- chat spy messages will no longer sent to discord while using DiscordSRV
- fixed an issue that would prevent the plugin to load when Vault was not installed
- fixed an issue in the team gui that would diplay the members line for each team member
- fixed an issue that would send the teleport confirmation message 2 times in some cases
- much more that i can't remember
TO UPDATE:
if you missed the latest beta version go check out the changelog for it, and be sure to change that option in the config for team echests, otherwise they won't work
Delete your config.yml file.
Delete your messages.yml file
i did not have enough time to migrate all the messages to the new format. They will work just fine, and you can use MineDown in any of them to have new features such as clicable buttons, hover text, etc. i will do it within the next versions, so you will be able to do copy and past them manually, or just regenerate the file.
SPIGOT IS NO LONGER SUPPORTED
Will i be affected? most probably not. Almost all the servers (checking from bstats) are using paper forks, that includes like Purpur, pufferfish, leaf etc. If you are not using paper, use it. it is just way more optimized and there is no reasons to use spigot anymore.
1.19.4+ ONLY FROM NOW ON
As for paper, also almost everyones uses at least 1.20, so i updated to the 1.19.4 api to have more features that can help me bring more to the plugin. if you are running an older version don't update the plugin as it won't work.
If you find any issue please report them on GitHub
Added Team EnderChests!
This version is 99% production-ready but i marked it as beta while waiting for more tests and reported issues.
Teams can now have one or more shared enderchest (with variable size)
permission to use the echest: ultimateteams.team.echest
Team Echests are not compatible with cross-server yet
Admins can view, manage, delete, add, backup and rollback teams echests with their dedicated command **/teamadmin echest **
other fixes/additions:
- teams will now be updated even if there are no players online for cross-server setups that use REDIS (impossible with pluginmessage due to its limitations)
- teamchat spy messages will not be sent via discordsrv anymore
- invites now feature a clickable button for who receive it
- echests are updated real-time to prevent item dupes
TO UPDATE:
-
delete both your config.yml and messages.yml files
-
enable enderchest migration in the config, wait for the server to start, then disable it and restart again.
Thanks to dei0 for the echest system. check out his fork of ultimateteams, that features a slighly different team management (like upgrades for more members and warps)
INFORMATION REGARDING THE NEXT VERSION
in the next version i will convert the messages file to a new format, and it will be published probably within 2-3 days, so i wouldn't recommend you to change the messages file after it regenerates, since you will have to do it again.
i am also gonna add a little bank system, featuring only team balance for now, but with the future vision of adding an optional level system.
End Crystal will no longer damage players that are on the same teams/allies when friendly fire is disabled.
regarding respawn anchors, check here: https://github.com/xF3d33/UltimateTeams/issues/94
