AmethystGuilds

AmethystGuilds
A complete, configurable guild system for Paper 1.21+ servers.

AmethystGuilds brings a powerful and polished guild experience to your Minecraft server, giving players everything they need to create, manage, and grow their own guilds.

Create guilds, manage ranks and permissions, communicate through private guild chat, share a guild Ender Chest, customize guild colors, and compete on persistent leaderboards.

✨ Features

• Guild Creation — Create guilds with configurable name rules and member limits.
  
  
• Rank System — Built-in Leader, Officer, and Member ranks with configurable names and weights.
  
  
• Invitations — Invite players with automatically expiring invitations.
  
  
• Guild Chat — Private chat channel for guild members.
  
  
• Custom Guild Colors — Choose from 12 configurable tag colors.
  
  
• ️ Player Suffixes — Display guild and rank information in chat and the TAB list.
  
  
• Shared Guild Ender Chest — A persistent storage chest shared by guild members.
  
  
• ✏️ Guild Renaming — Rename your guild with a configurable cooldown.
  
  
• ⚔️ Guild Statistics — Track kills, deaths, and KOTH victories.
  
  
• Guild Leaderboards — Compete for the top spot based on kills or deaths.
  
  
• KOTH Integration — Automatically track KOTH victories through KothWars.
  
  
• PlaceholderAPI Support — Extensive player, guild, and leaderboard placeholders.
  
  
• TAB Integration — Live guild suffix updates in the tab list.
  
  
• Multi-Language Support — English and Hungarian included, with fully translatable messages.
  
  
• ⚙️ Highly Configurable — Ranks, formats, colors, limits, messages, titles, cooldowns, and more can all be customized.
  

️ Rank System
AmethystGuilds includes three configurable ranks:

Leader → Officer → Member

Ranks use configurable weights, meaning higher-ranked members automatically have access to everything available to lower-ranked members.

Statistics & Leaderboards
Guilds have persistent statistics for:

• ⚔️ Kills
  
  
• ☠️ Deaths
  
  
• KOTH Wins
  

Use these statistics to create competitive guild leaderboards and display rankings using PlaceholderAPI.

Integrations
PlaceholderAPI
Access guild, rank, statistics, and leaderboard data through placeholders.

KothWars
Automatically track guild KOTH victories and announce wins in guild chat.

TAB
Keep guild suffixes synchronized and updated live in the player tab list.

⚙️ Requirements

• Paper 1.21+ (or compatible fork)
  
  
• Java 21
  

Optional Dependencies

• PlaceholderAPI
  
  
• KothWars
  
  
• TAB
  

Installation

1. Stop your server.
   
   
2. Place AmethystGuilds-1.0.0.jar into your plugins/ folder.
   
   
3. Start the server.
   
   
4. Configure plugins/AmethystGuilds/config.yml.
   
   
5. Customize the language files if desired.
   
   
6. Run /guild reload to apply configuration changes.
   

Commands
Command Description
/guild create <name> Create a guild
/guild invite <player> Invite a player
/guild accept Accept a guild invitation
/guild leave Leave your guild
/guild kick <player> Kick a member
/guild rank <player> <rank> Change a member's rank
/guild disband Disband your guild
/guild chat <message> Send a guild chat message
/guild info [guild] View guild information
/guild list List all guilds
/guild color <color> Change guild tag color
/guild rename <name> Rename your guild
/guild chest Open the shared guild Ender Chest
/guild reload Reload configuration
/guild help Show the help menu
Aliases: /g, /guilds

Permissions
amethystguilds.admin
Required for administrative commands such as /guild reload.

Fully Configurable
Almost every aspect of AmethystGuilds can be customized, including:

• Guild name rules
  
  
• Maximum members
  
  
• Rank names and weights
  
  
• Guild chat format
  
  
• Invite expiration
  
  
• Rename cooldown
  
  
• Ender Chest access requirements
  
  
• Guild colors
  
  
• Chat and TAB suffix formats
  
  
• Creation announcements and titles
  
  
• KOTH announcements
  
  
• All plugin messages
  

All messages are stored in language files, making AmethystGuilds easy to translate and adapt to your server.

Developed by AmethystPlugins

License: See the included LICENSE file. Redistribution or resale is not permitted without permission.