My the GUI like in the image
--- 📎 Attached 1 file(s):
File: pasted-code-1790728872709.txt
Create a complete, production-ready Teams plugin for Paper 1.21.11.
The plugin should be lightweight, modular, configurable, and use SQLite for persistent storage. Do not use MariaDB/MySQL. Do not depend on EssentialsX or another team plugin.
Main GUI
Create a "/team" command that opens a professional chest-style GUI.
The GUI must contain these features:
- Ender Chest → Team Ender Chest
- Chest → Team Invites
- Book → Team Members
- Orange Bed → Team Home
- Clock → Team Stats
- Bell → Team Settings
- Sword → Team Allies
- Red Bed → Leave Team
Do NOT hardcode or specify exact inventory slots. Arrange the GUI cleanly and make the layout configurable.
All GUI items, names, lore, sounds, titles, and messages should be configurable.
Team Ender Chest
Add a shared storage system for each team.
Features:
- Shared team storage
- Configurable size
- Persistent storage
- Permission-based access
- Members can have different access permissions
- Prevent players from taking/moving GUI items accidentally
Team Invites
Create a complete invitation system.
Features:
- Send team invitations
- Accept invitations
- Decline invitations
- View pending invitations
- Cancel outgoing invitations
- Player heads in the GUI
- Configurable invitation expiration
Commands:
/team invite <player>
/team accept <team>
/team deny <team>
/team invites
Team Members
The members GUI should display all team members using player heads.
Default team ranks:
Owner
Co-Owner
Officer
Member
Make the rank system configurable.
When clicking a member, open a management GUI with options such as:
- Promote
- Demote
- Kick
- Transfer ownership
- View member information
- Manage permissions
Use permission checks so members cannot manage players above their own authority.
Team Home
Create a completely self-contained team home system.
Commands:
/team home
/team sethome
/team delhome
Features:
- Team home location
- Configurable teleport delay
- Configurable cooldown
- Optional movement cancellation
- Permission checks
- GUI access
Do not use EssentialsX homes.
Team Stats
Create a team statistics GUI.
Possible statistics:
- Team name
- Owner
- Member count
- Team kills
- Team deaths
- K/D
- Blocks broken
- Blocks placed
- Playtime
- Team creation date
- Number of allies
- Other useful configurable statistics
Only track statistics that can be implemented reliably.
Team Settings
Create a settings GUI available only to authorized team ranks.
Settings should include:
- Team name
- Team description
- Open/closed team
- Who can invite players
- Member permissions
- Team chat settings
- Friendly fire
- Team home settings
- Team Ender Chest permissions
Every setting should have proper permission checks.
Team Allies
Create a complete alliance system.
Features:
- View allied teams
- Send alliance requests
- Accept alliance requests
- Decline alliance requests
- Remove alliances
- View ally information
Commands:
/team ally <team>
/team ally accept <team>
/team ally deny <team>
/team ally remove <team>
/team allies
Optional configurable ally features:
- Disable friendly fire between allies
- Ally chat
- Ally name/status indicators
- Configurable access to team features
Team Chat
Add team chat functionality.
Commands:
/team chat
/tc
/team chat <message>
/tc <message>
Players should be able to toggle team chat or send individual team messages.
Also optionally support ally chat:
/team allychat
/ac <message>
Make chat formats configurable.
Main Commands
Implement:
/team
/team create <name>
/team disband
/team info [team]
/team invite <player>
/team accept <team>
/team deny <team>
/team invites
/team leave
/team kick <player>
/team promote <player>
/team demote <player>
/team transfer <player>
/team members
/team home
/team sethome
/team delhome
/team stats
/team ally <team>
/team allies
/team chat
/team settings
Add proper tab completion for every command.
Team Creation
When creating a team:
/team create <name>
Validate:
- Team name length
- Allowed characters
- Duplicate team names
- Invalid names
- Configurable creation requirements
Make all limits configurable.
Team Disbanding
Only the owner should be able to disband a team.
Require a confirmation through the GUI or command confirmation to prevent accidental deletion.
When a team is disbanded, properly clean up all related data.
Owner Protection
The owner cannot simply leave the team.
They must either:
- Transfer ownership to another member, or
- Disband the team.
SQLite Database
Use SQLite for all persistent data.
Suggested tables:
teams
team_members
team_invites
team_allies
team_homes
team_settings
team_stats
team_enderchest
Use safe database operations and make sure data persists through server restarts.
Do not store important team data only in memory.
GUI Requirements
All GUIs must:
- Prevent item stealing
- Prevent item movement
- Prevent unwanted interaction
- Support pagination
- Have back buttons where appropriate
- Have close buttons
- Use confirmation menus for destructive actions
- Use player heads where useful
- Have configurable titles
- Have configurable item names
- Have configurable lore
- Have configurable sounds
- Have configurable messages
- Support permissions
- Handle offline players correctly
Configuration
Create a clean configuration system for:
- Team limits
- Maximum members
- Team name rules
- Invitation expiration
- Team ranks
- Permissions
- Team homes
- Home cooldowns
- Teleport delays
- Team Ender Chest size
- Friendly fire
- Ally settings
- Team chat
- GUI appearance
- Messages
- Sounds
- Statistics
- Database settings
Do not hardcode values that server owners would reasonably want to change.
Performance
The plugin should be lightweight and optimized.
Avoid unnecessary database queries on every player action.
Use caching where appropriate and safely save changes to SQLite.
Do not block the main server thread with expensive operations.
Make sure the plugin works properly with multiple teams and many players.
Compatibility
Target:
Paper 1.21.11
Use the modern Paper API appropriate for this version.
Do not require EssentialsX.
Do not require Vault unless there is a genuinely necessary feature that cannot be implemented without it.
The plugin should function independently.
Code Quality
Use a clean modular architecture.
Separate systems into appropriate classes/modules such as:
TeamManager
Team
TeamMember
TeamRank
TeamInviteManager
TeamAllyManager
TeamHomeManager
TeamChatManager
TeamStatsManager
TeamStorage
TeamGUI
TeamCommand
TeamSettings
Use proper error handling and logging.
Avoid duplicated code.
Add comments where logic is not obvious.
Make the plugin easy to extend later.
Final Requirement
Build the plugin completely rather than creating a mockup or partial implementation.
Generate all required Java source files, plugin.yml, configuration files, SQLite/database code, GUI code, commands, tab completion, permissions, and supporting classes.
The final result should compile successfully on Paper 1.21.11 and be ready to place inside the server's "plugins" folder.
Build a Paper 1.21.11 plugin scaffold with configurable menus, messages, and SQLite persistence.
Implement team management, invitations, ranks, alliances, home teleporting, shared storage, and statistics.
Connect commands, tab completion, GUIs, and gameplay listeners.
Built the Paper 1.21.11 teams plugin with a configurable chest menu styled after the screenshot, including its centered row of team actions and configurable slots.
Implemented SQLite persistence, ranks and member permissions, invitations, alliances, shared team storage, team homes with delays and cooldowns, team/ally chat, statistics, confirmation GUIs, commands, and tab completion. The project scaffold, configuration, and plugin descriptor are included.
[10:47:31]: [ERROR]: Cannot load plugins/KodariTeams/config.yml org.bukkit.configuration.InvalidConfigurationException: while parsing a block mapping in 'reader', line 158, column 3: prefix: '&8[&bTeams&8] ' ^ expected <block end>, but found '<scalar>' in 'reader', line 187, column 62: ... rting in %seconds% seconds. Don't move.' ^ at org.bukkit.configuration.file.YamlConfiguration.loadFromString(YamlConfiguration.java:112) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.configuration.file.FileConfiguration.load(FileConfiguration.java:160) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.configuration.file.FileConfiguration.load(FileConfiguration.java:128) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.configuration.file.YamlConfiguration.loadConfiguration(YamlConfiguration.java:310) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.java.JavaPlugin.reloadConfig(JavaPlugin.java:172) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.java.JavaPlugin.getConfig(JavaPlugin.java:149) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at KodariTeams-1.0.0.jar//com.kodari.teams.TeamPlugin.onEnable(TeamPlugin.java:17) ~[?:?] at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:279) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.plugin.manager.PaperPluginInstanceManager.enablePlugin(PaperPluginInstanceManager.java:207) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.enablePlugin(PaperPluginManagerImpl.java:109) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:520) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.CraftServer.enablePlugin(CraftServer.java:639) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:596) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.MinecraftServer.initPostWorld(MinecraftServer.java:636) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:365) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1253) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:388) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at java.base/java.lang.Thread.run(Thread.java:1474) ~[?:?] Caused by: org.yaml.snakeyaml.parser.ParserException: while parsing a block mapping in 'reader', line 158, column 3: prefix: '&8[&bTeams&8] ' ^ expected <block end>, but found '<scalar>' in 'reader', line 187, column 62: ... rting in %seconds% seconds. Don't move.' ^ at org.yaml.snakeyaml.parser.ParserImpl$ParseBlockMappingKey.produce(ParserImpl.java:654) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.parser.ParserImpl.peekEvent(ParserImpl.java:161) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector$1.peek(CommentEventsCollector.java:57) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector$1.peek(CommentEventsCollector.java:43) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector.collectEvents(CommentEventsCollector.java:136) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector.collectEvents(CommentEventsCollector.java:116) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeScalarNode(Composer.java:241) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeNode(Composer.java:205) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeValueNode(Composer.java:369) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingChildren(Composer.java:348) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingNode(Composer.java:323) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeNode(Composer.java:209) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeValueNode(Composer.java:369) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingChildren(Composer.java:348) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingNode(Composer.java:323) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeNode(Composer.java:209) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.getNode(Composer.java:131) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.getSingleNode(Composer.java:157) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.Yaml.compose(Yaml.java:575) ~[snakeyaml-2.2.jar:?] at org.bukkit.configuration.file.YamlConfiguration.loadFromString(YamlConfiguration.java:105) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] ... 17 more [10:47:31]: [ERROR]: Cannot load configuration from stream org.bukkit.configuration.InvalidConfigurationException: while parsing a block mapping in 'reader', line 158, column 3: prefix: '&8[&bTeams&8] ' ^ expected <block end>, but found '<scalar>' in 'reader', line 187, column 62: ... rting in %seconds% seconds. Don't move.' ^ at org.bukkit.configuration.file.YamlConfiguration.loadFromString(YamlConfiguration.java:112) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.configuration.file.FileConfiguration.load(FileConfiguration.java:160) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.configuration.file.YamlConfiguration.loadConfiguration(YamlConfiguration.java:339) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.java.JavaPlugin.reloadConfig(JavaPlugin.java:179) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.java.JavaPlugin.getConfig(JavaPlugin.java:149) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at KodariTeams-1.0.0.jar//com.kodari.teams.TeamPlugin.onEnable(TeamPlugin.java:17) ~[?:?] at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:279) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.plugin.manager.PaperPluginInstanceManager.enablePlugin(PaperPluginInstanceManager.java:207) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.enablePlugin(PaperPluginManagerImpl.java:109) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:520) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.CraftServer.enablePlugin(CraftServer.java:639) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:596) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.MinecraftServer.initPostWorld(MinecraftServer.java:636) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:365) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1253) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:388) ~[paper-1.21.11.jar:1.21.11-132-c5eb079] at java.base/java.lang.Thread.run(Thread.java:1474) ~[?:?] Caused by: org.yaml.snakeyaml.parser.ParserException: while parsing a block mapping in 'reader', line 158, column 3: prefix: '&8[&bTeams&8] ' ^ expected <block end>, but found '<scalar>' in 'reader', line 187, column 62: ... rting in %seconds% seconds. Don't move.' ^ at org.yaml.snakeyaml.parser.ParserImpl$ParseBlockMappingKey.produce(ParserImpl.java:654) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.parser.ParserImpl.peekEvent(ParserImpl.java:161) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector$1.peek(CommentEventsCollector.java:57) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector$1.peek(CommentEventsCollector.java:43) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector.collectEvents(CommentEventsCollector.java:136) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.comments.CommentEventsCollector.collectEvents(CommentEventsCollector.java:116) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeScalarNode(Composer.java:241) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeNode(Composer.java:205) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeValueNode(Composer.java:369) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingChildren(Composer.java:348) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingNode(Composer.java:323) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeNode(Composer.java:209) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeValueNode(Composer.java:369) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingChildren(Composer.java:348) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeMappingNode(Composer.java:323) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.composeNode(Composer.java:209) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.getNode(Composer.java:131) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.composer.Composer.getSingleNode(Composer.java:157) ~[snakeyaml-2.2.jar:?] at org.yaml.snakeyaml.Yaml.compose(Yaml.java:575) ~[snakeyaml-2.2.jar:?] at org.bukkit.configuration.file.YamlConfiguration.loadFromString(YamlConfiguration.java:105) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] ... 16 more
Fixed the YAML parse error in src/main/resources/config.yml: the home-teleporting message now uses double quotes, so the apostrophe in “Don’t” no longer terminates the string.
remove toggle friendly fire and add a create team option in the gui
Remove the friendly-fire toggle from the team feature and its UI.
Add a create-team option to the GUI.
Removed the friendly-fire toggle from settings and config; teammates can no longer damage each other.
Added a Create a Team GUI option for players without a team. It prompts for a name in chat;
cancelaborts.
Add support for the PlaceholderAPI placeholder %team_name% to the plugin. It should return the current player's team name dynamically and update correctly when the player joins, leaves, or switches teams. If the player has no team, return a configurable fallback or None. Ensure it integrates properly with PlaceholderAPI and works in TAB, scoreboards, and other plugins that support PlaceholderAPI.
Add a PlaceholderAPI expansion that resolves the player’s current team on every request.
Configure the no-team fallback and declare PlaceholderAPI as an optional integration.
Added %team_name% PlaceholderAPI support. It looks up the player’s current team whenever requested, so membership changes are reflected without cached values. Players without a team receive None by default; configure the fallback with placeholders.no-team in config.yml.
PlaceholderAPI is optional: when installed, the expansion registers automatically and works with TAB, scoreboards, and other PlaceholderAPI-compatible plugins.
package com.kodari.teams;
import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.command.CommandSender;
import org.bukkit.plugin.java.JavaPlugin;
import java.nio.file.Path;
public final class TeamPlugin extends JavaPlugin {
private TeamManager teamManager;
private TeamGUI teamGUI;
@Override
public void onEnable() {
saveDefaultConfig();
Path database = getDataFolder().toPath().resolve(getConfig().getString("database.file", "teams.db"));
teamManager = new TeamManager(this, new TeamStorage(database));
if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) {
new TeamPlaceholderExpansion(this, teamManager).register();
}
teamGUI = new TeamGUI(this, teamManager);
Bukkit.getPluginManager().registerEvents(teamGUI, this);
Bukkit.getPluginManager().registerEvents(new TeamListener(this, teamManager), this);
TeamCommand command = new TeamCommand(this, teamManager, teamGUI);
getCommand("team").setExecutor(command);
getCommand("team").setTabCompleter(command);
getCommand("tc").setExecutor(command);
getCommand("tc").setTabCompleter(command);
getCommand("ac").setExecutor(command);
getCommand("ac").setTabCompleter(command);
teamManager.load(() -> Bukkit.getOnlinePlayers().forEach(teamManager::onJoin));
}
@Override
public void onDisable() {
if (teamManager != null) {
Bukkit.getOnlinePlayers().forEach(teamManager::onQuit);
teamManager.shutdown();
}
}
public TeamManager getTeamManager() {
return teamManager;
}
public TeamGUI getTeamGUI() {
return teamGUI;
}
public String color(String text) {
return ChatColor.translateAlternateColorCodes('&', text == null ? "" : text);
}
public void msg(CommandSender sender, String key, String... replacements) {
String message = getConfig().getString("messages." + key, key);
for (int index = 0; index + 1 < replacements.length; index += 2) {
message = message.replace("%" + replacements[index] + "%", replacements[index + 1]);
}
String prefix = getConfig().getString("messages.prefix", "");
sender.sendMessage(color(prefix + message));
}
}