Skip to content

Home

Jump to bottom
chenasyd edited this page Aug 15, 2025 · 2 revisions

Welcome to the -GuildPlugin wiki!

Guild Plugin – The Ultimate GUI-Based Guild System for Minecraft

Tired of command-heavy interactions? Want to add deep social gameplay to your server? This 100% GUI-driven guild system is your ultimate solution!

✨ Key Features

Fully Visual Interface (GUI)

  • Create guilds, declare wars/alliances, edit descriptions, manage members, and configure permissions—all through intuitive menus!
  • Admins can view all guilds, freeze/unfreeze, or delete them—no commands needed!
  • No mandatory dependencies! Works as a standalone Bukkit plugin with built-in permissions.

Deep Social Systems

  • Hierarchical Ranks (Leader/Officer/Member) with GUI-based role management (promote/demote with clicks).
  • Guild Economy: Members can deposit/withdraw funds. Note: If a guild disbands, all funds go to the leader.
  • Dynamic Diplomacy: Set relations (Neutral/Hostile/War) via GUI—just select the target guild!
  • Guild Progression: Auto-levels up when funds reach thresholds (max Lv.10 = 100 members). No manual costs!

Tech-Friendly

  • Async Database (MySQL/SQLite support).
  • Vault & PlaceholderAPI integration (50+ variables like %guild_level%).
  • Low-latency (async processing minimizes performance impact).
  • Folia-compatible (next-gen server support).

For Developers

  • Open-source: GitHub.
  • Extensive API for custom integrations.

📥 Download & Links

🎯 Perfect for:

  • RPG Servers (boost player engagement).
  • Survival Servers (lightweight yet feature-rich).
  • Faction/PvP Servers (war & diplomacy mechanics).

Why Choose This Plugin?
✔ Zero command memorization – Everything in GUI!
✔ True social depth – Economy, wars, and progression.
✔ Server-friendly – Works out of the box, no bloat.

Ready to transform your server? Click the links above! 🚀

Guild Plugin is a comprehensive Minecraft server plugin that provides a complete guild/clan system for your server. With this plugin, players can create and manage their own guilds, invite members, establish inter-guild relationships, and enjoy various guild features.

Core Features

Guild Management

  • Create and customize guilds (name, tag, description)
  • Manage guild members (invite, kick, promote, demote)
  • Role-based permission system (Leader, Officer, Member)
  • Set and teleport to guild home
  • Guild application system

Economy System

  • Guild fund management (deposit, withdraw, transfer)
  • Guild creation fee configuration
  • Economy system integration (supports multiple economy plugins via Vault)

Relationship System

  • Inter-guild relationship management (allied, hostile, neutral, at war, truce)
  • Relationship status notifications
  • War status alerts

Leveling System

  • Guild level progression
  • Increased member capacity
  • Unlock additional guild features

User Interface

  • Complete Graphical User Interface (GUI)
  • Intuitive menu system
  • Customizable interface configuration

Technical Features

  • Asynchronous Processing: All database operations are asynchronous, ensuring no impact on server performance
  • Multi-Database Support: Supports both SQLite and MySQL
  • Placeholder Support: Integrated with PlaceholderAPI
  • Permission Integration: Fully compatible with Bukkit permission system
  • High Performance: Optimized code ensures smooth server operation

Commands

Command Description Permission
/guild Main guild command guild.use
/guildadmin Guild administration command guild.admin

Guild Command Subcommands

  • /guild - Open main guild GUI
  • /guild create <name> [tag] [description] - Create a new guild
  • /guild info - View guild information
  • /guild members - View guild members
  • /guild invite <player> - Invite a player to your guild
  • /guild kick <player> - Kick a member from your guild
  • /guild leave - Leave your current guild
  • /guild delete - Delete your guild (leader only)

Guild Admin Command Subcommands

  • /guildadmin reload - Reload plugin configurations
  • /guildadmin list - List all guilds
  • /guildadmin delete <guild> - Delete a guild

Permission Nodes

Permission Description Default
guild.use Allow using the guild system true
guild.admin Guild administrator permissions op
guild.create Allow creating guilds true
guild.invite Allow inviting players to guild true
guild.kick Allow kicking guild members true
guild.promote Allow promoting guild members true
guild.demote Allow demoting guild members true
guild.delete Allow deleting guilds op
guild.sethome Allow setting guild home true
guild.home Allow teleporting to guild home true
guild.relation Allow managing guild relations true
guild.economy Allow managing guild economy true
guild.deposit Allow depositing money to guild true
guild.withdraw Allow withdrawing money from guild true
guild.transfer Allow transferring money to other guilds true

Placeholder Variables

Guild Basic Information

Placeholder Description
%guild_name% Guild name
%guild_tag% Guild tag
%guild_membercount% Current member count
%guild_maxmembers% Maximum member capacity
%guild_level% Guild level
%guild_balance% Guild balance (2 decimal places)
%guild_frozen% Guild status (Normal/Frozen/No Guild)

Player Guild Information

Placeholder Description
%guild_role% Player's guild role (Leader/Officer/Member)
%guild_joined% When player joined the guild
%guild_contribution% Player's contribution to the guild

Guild Status Check

Placeholder Description
%guild_hasguild% Whether player has a guild (Yes/No)
%guild_isleader% Whether player is leader (Yes/No)
%guild_isofficer% Whether player is officer (Yes/No)
%guild_ismember% Whether player is member (Yes/No)

Guild Permission Check

Placeholder Description
%guild_caninvite% Can invite players (Yes/No)
%guild_cankick% Can kick members (Yes/No)
%guild_canpromote% Can promote members (Yes/No)
%guild_candemote% Can demote members (Yes/No)
%guild_cansethome% Can set guild home (Yes/No)
%guild_canmanageeconomy% Can manage guild economy (Yes/No)

Requirements

  • Minecraft Server Version: 1.21+
  • Java Version: JDK 17+
  • Required Dependencies: None
  • Optional Dependencies:
    • Vault (for economy support)
    • PlaceholderAPI (for placeholder support)

Installation

  1. Place the plugin jar file in your server's plugins folder
  2. Start the server - the plugin will automatically generate configuration files
  3. Edit configuration files as needed:
    • config.yml - Main configuration
    • database.yml - Database settings
    • gui.yml - GUI customization
    • messages.yml - Message localization
  4. Restart server to apply changes

Configuration

Database Configuration

The plugin supports both SQLite (default) and MySQL databases.

SQLite (Default)

No additional configuration required. The database file will be automatically created at plugins/GuildPlugin/guild.db.

MySQL

To use MySQL, edit database.yml:

mysql:
  host: localhost
  port: 3306
  database: guild
  username: your_username
  password: your_password
  pool-size: 10
  min-idle: 5
  connection-timeout: 30000
  idle-timeout: 600000
  max-lifetime: 1800000

And update config.yml:

database:
  type: mysql

API Integration

Guild Plugin provides a comprehensive API for developers to integrate with their own plugins. The main API classes include:

  • GuildPlugin - Main plugin class with access to all services
  • GuildService - Service for guild operations
  • EconomyManager - Guild economy management
  • DatabaseManager - Database operations
  • GUIManager - GUI management system

For detailed API documentation, please refer to the Javadoc included with the plugin.

About: About Me

Clone this wiki locally