Guild Plugin - Feature-Complete Minecraft Guild System(需要官方中文翻译请往下滑)

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

/guild - Main guild command
/guildadmin - Guild administration command

Permission Nodes

Uses built-in permission system

Basic Guild Information Variables

Guild Basic Info

%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 Info

%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 Variables

Player Status

%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 Variables

Permission Status

%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+
Optional Dependencies: Vault (for economy support), PlaceholderAPI (for placeholder support)

Installation Steps

Place the plugin jar file in your server's plugins folder
Start the server - the plugin will automatically generate configuration files
Edit configuration files as needed
Restart server to apply changes

✨ 功能特性

核心功能

工会创建与管理: 支持工会创建、删除、信息查看
成员管理: 邀请、踢出、提升、降级成员
权限系统: 基于角色的权限管理（会长、官员、成员）
GUI界面: 完整的图形用户界面，操作便捷
经济系统: 工会资金管理、存款、取款、转账
等级系统: 工会等级提升，增加成员上限
关系管理: 工会间关系（盟友、敌对、中立、开战、停战）
工会家: 设置和传送到工会家
申请系统: 玩家申请加入工会

高级功能

异步处理: 所有数据库操作均为异步，不影响服务器性能
多数据库支持: 支持SQLite和MySQL
占位符支持: 集成PlaceholderAPI
经济集成: 通过Vault支持多种经济插件
权限集成: 与Bukkit权限系统完全集成

🚀 安装指南

前置要求

Minecraft服务器: 1.13+ (推荐1.21+)
Java: JDK 8+ (推荐JDK 17+)
Vault: 经济系统支持 (可选)
PlaceholderAPI: 占位符支持 (可选)

安装步骤

下载插件

# 从发布页面下载最新版本的jar文件
# 或使用Maven编译
mvn clean package

安装到服务器

# 将编译好的jar文件放入plugins文件夹
cp target/guild-plugin-1.0.0.jar plugins/

启动服务器

# 启动服务器，插件会自动生成配置文件
java -jar server.jar

配置插件

# 编辑生成的配置文件
nano plugins/GuildPlugin/config.yml
nano plugins/GuildPlugin/messages.yml
nano plugins/GuildPlugin/gui.yml
nano plugins/GuildPlugin/database.yml

重启服务器

# 重启服务器使配置生效
restart

⚙️ 配置说明

主配置文件 (config.yml)

# 数据库配置
database:
  type: sqlite  # sqlite 或 mysql
  mysql:
    host: localhost
    port: 3306
    database: guild
    username: root
    password: ""
    pool-size: 10

# 工会配置
guild:
  min-name-length: 3
  max-name-length: 20
  max-tag-length: 6
  max-description-length: 100
  max-members: 50
  creation-cost: 1000.0  # 创建工会费用

# 权限配置
permissions:
  default:
    can-create: true
    can-invite: true
    can-kick: true
    can-promote: true
    can-demote: false
    can-delete: false

消息配置文件 (messages.yml)

# 通用消息
general:
  prefix: "&6[工会] &r"
  no-permission: "&c您没有权限执行此操作！"

# 工会创建消息
create:
  success: "&a工会 {name} 创建成功！"
  insufficient-funds: "&c您的余额不足！创建工会需要 {cost} 金币。"

GUI配置文件 (gui.yml)

# 主界面配置
main-menu:
  title: "&6工会系统"
  size: 54
  items:
    create-guild:
      slot: 4
      material: EMERALD_BLOCK
      name: "&a创建工会"
      lore:
        - "&7创建新的工会"
        - "&7需要消耗金币"

数据库配置文件 (database.yml)

# SQLite配置
sqlite:
  file: "plugins/GuildPlugin/guild.db"
  
# MySQL配置
mysql:
  host: localhost
  port: 3306
  database: guild
  username: root
  password: ""
  pool-size: 10
  min-idle: 5
  connection-timeout: 30000
  idle-timeout: 600000
  max-lifetime: 1800000

📝 命令列表

玩家命令

命令	权限	描述
`/guild`	`guild.use`	打开工会主界面
`/guild create <名称> [标签] [描述]`	`guild.create`	创建工会
`/guild info`	`guild.info`	查看工会信息
`/guild members`	`guild.members`	查看工会成员
`/guild invite <玩家>`	`guild.invite`	邀请玩家加入工会
`/guild kick <玩家>`	`guild.kick`	踢出工会成员
`/guild leave`	`guild.leave`	离开工会
`/guild delete`	`guild.delete`	删除工会
`/guild promote <玩家>`	`guild.promote`	提升成员职位
`/guild demote <玩家>`	`guild.demote`	降级成员职位
`/guild accept <邀请者>`	`guild.accept`	接受工会邀请
`/guild decline <邀请者>`	`guild.decline`	拒绝工会邀请
`/guild sethome`	`guild.sethome`	设置工会家
`/guild home`	`guild.home`	传送到工会家
`/guild apply <工会> [消息]`	`guild.apply`	申请加入工会

管理员命令

命令	权限	描述
`/guildadmin`	`guild.admin`	管理员主命令
`/guildadmin reload`	`guild.admin.reload`	重载配置文件
`/guildadmin list`	`guild.admin.list`	列出所有工会
`/guildadmin info <工会>`	`guild.admin.info`	查看工会详细信息
`/guildadmin delete <工会>`	`guild.admin.delete`	强制删除工会
`/guildadmin kick <玩家> <工会>`	`guild.admin.kick`	从工会踢出玩家
`/guildadmin relation`	`guild.admin.relation`	关系管理
`/guildadmin test`	`guild.admin.test`	测试功能

🖥️ GUI界面

主界面

创建工会: 创建新的工会
工会信息: 查看当前工会信息
成员管理: 管理工会成员
申请管理: 处理加入申请
工会设置: 修改工会设置
工会列表: 查看所有工会
工会关系: 管理工会关系

创建工会界面

工会名称输入: 设置工会名称（3-20字符）
工会标签输入: 设置工会标签（最多6字符，可选）
工会描述输入: 设置工会描述（最多100字符，可选）
确认创建: 支付费用创建工会
取消: 返回主界面

成员管理界面

成员列表: 显示所有成员
邀请成员: 邀请新成员
踢出成员: 踢出现有成员
提升成员: 提升成员职位
降级成员: 降级成员职位

💰 经济系统

功能特性

工会资金: 每个工会独立的资金账户
存款系统: 成员可以向工会存款
取款系统: 成员可以从工会取款
转账系统: 工会间资金转账
贡献记录: 记录每个成员的贡献
等级升级: 资金达到要求自动升级

等级系统

等级	资金要求	最大成员数
1	0-5,000	6
2	5,000-10,000	12
3	10,000-20,000	18
4	20,000-35,000	24
5	35,000-50,000	30
6	50,000-75,000	40
7	75,000-100,000	50
8	100,000-150,000	60
9	150,000-200,000	80
10	200,000+	100

经济命令

/guild deposit <金额> - 向工会存款
/guild withdraw <金额> - 从工会取款
/guild transfer <工会> <金额> - 向其他工会转账
/guild balance - 查看工会余额

🤝 工会关系

关系类型

中立 (Neutral): 默认关系，无特殊效果
盟友 (Ally): 友好关系，显示为绿色
敌对 (Enemy): 敌对关系，显示为红色
开战 (War): 战争状态，登录时通知
停战 (Truce): 临时停战，需要双方同意结束

关系管理

创建关系: 工会会长可以创建关系
接受关系: 目标工会需要接受关系
拒绝关系: 目标工会可以拒绝关系
取消关系: 可以取消已建立的关系
关系过期: 关系有自动过期机制

关系命令

/guild relation create <工会> <类型> - 创建关系
/guild relation accept <工会> - 接受关系
/guild relation reject <工会> - 拒绝关系
/guild relation cancel <工会> - 取消关系

🗄️ 数据库

数据表结构

guilds (工会表)

CREATE TABLE guilds (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name VARCHAR(20) UNIQUE NOT NULL,
    tag VARCHAR(6),
    description TEXT,
    leader_uuid VARCHAR(36) NOT NULL,
    leader_name VARCHAR(16) NOT NULL,
    balance DOUBLE DEFAULT 0.0,
    level INTEGER DEFAULT 1,
    max_members INTEGER DEFAULT 6,
    home_world VARCHAR(64),
    home_x DOUBLE,
    home_y DOUBLE,
    home_z DOUBLE,
    home_yaw FLOAT,
    home_pitch FLOAT,
    frozen BOOLEAN DEFAULT FALSE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

guild_members (成员表)

CREATE TABLE guild_members (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    guild_id INTEGER NOT NULL,
    player_uuid VARCHAR(36) NOT NULL,
    player_name VARCHAR(16) NOT NULL,
    role VARCHAR(20) DEFAULT 'MEMBER',
    joined_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (guild_id) REFERENCES guilds(id) ON DELETE CASCADE
);

guild_applications (申请表)

CREATE TABLE guild_applications (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    guild_id INTEGER NOT NULL,
    player_uuid VARCHAR(36) NOT NULL,
    player_name VARCHAR(16) NOT NULL,
    message TEXT,
    status VARCHAR(20) DEFAULT 'PENDING',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (guild_id) REFERENCES guilds(id) ON DELETE CASCADE
);

guild_relations (关系表)

CREATE TABLE guild_relations (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    guild1_id INTEGER NOT NULL,
    guild2_id INTEGER NOT NULL,
    relation_type VARCHAR(20) NOT NULL,
    status VARCHAR(20) DEFAULT 'PENDING',
    initiator_uuid VARCHAR(36) NOT NULL,
    initiator_name VARCHAR(16) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    expires_at TIMESTAMP,
    FOREIGN KEY (guild1_id) REFERENCES guilds(id) ON DELETE CASCADE,
    FOREIGN KEY (guild2_id) REFERENCES guilds(id) ON DELETE CASCADE
);

guild_economy (经济表)

CREATE TABLE guild_economy (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    guild_id INTEGER NOT NULL,
    player_uuid VARCHAR(36) NOT NULL,
    player_name VARCHAR(16) NOT NULL,
    amount DOUBLE NOT NULL,
    type VARCHAR(20) NOT NULL,
    description TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (guild_id) REFERENCES guilds(id) ON DELETE CASCADE
);

GuildPlugin - 完整功能的 Minecraft 公会系统插件

English Below | 官方主页/文档

GuildPlugin 是一个为 Minecraft 服务器打造的高性能公会系统插件，支持多语言，涵盖公会管理、经济、关系、等级、GUI等丰富功能，适配多种主流经济与权限插件，完全免费开源！

核心特性

公会管理

支持创建、解散、编辑公会（名称、标签、描述）
成员增删、升降职，基于“会长/官员/成员”的角色权限体系
公会家园设置与传送
公会申请/邀请机制

经济系统

公会资金管理：存款、取款、转账
公会创建费用可配置
支持通过 Vault 集成多种经济插件

关系系统

支持公会间联盟、敌对、中立、战争、停战等关系
状态变更和通知机制，战争警报与联盟反馈

等级系统

公会等级成长，提升成员上限
解锁更多公会功能

用户界面

完整 GUI 菜单与操作界面
可自定义配置，操作便捷

技术特性

所有数据库操作均为异步，无卡顿
支持 SQLite 与 MySQL 灵活切换
与 PlaceholderAPI 深度集成，变量丰富
完全兼容 Bukkit 权限体系
高性能优化，稳定可靠

快速开始

环境需求

Minecraft 服务器版本：1.21+
Java 版本：JDK 17+
可选依赖：Vault（经济支持）、PlaceholderAPI（变量支持）

安装步骤

下载最新版插件 jar 文件，放入服务器 /plugins 目录
启动服务器，插件会自动生成配置文件
按需修改配置文件（config.yml/messages.yml/gui.yml/database.yml）
重启服务器即可生效

Maven 构建（开发者）

mvn clean package

主要命令一览

玩家命令

命令	权限节点	说明
/guild	guild.use	打开主菜单
/guild create ...	guild.create	创建公会
/guild info	guild.info	查看公会信息
/guild members	guild.members	查看成员列表
/guild invite ...	guild.invite	邀请加入
/guild kick ...	guild.kick	移除成员
/guild leave	guild.leave	离开公会
/guild delete	guild.delete	解散公会
/guild promote ...	guild.promote	升职成员
/guild demote ...	guild.demote	降职成员
/guild accept ...	guild.accept	接受邀请
/guild decline ...	guild.decline	拒绝邀请
/guild sethome	guild.sethome	设置家园
/guild home	guild.home	传送家园
/guild apply ...	guild.apply	申请加入

管理员命令

命令	权限节点	说明
/guildadmin	guild.admin	管理主命令
/guildadmin reload	guild.admin.reload	重载配置文件
/guildadmin list	guild.admin.list	查看所有公会
/guildadmin info ...	guild.admin.info	查看公会详情
/guildadmin delete ...	guild.admin.delete	强制删除公会
/guildadmin kick ... ...	guild.admin.kick	移除玩家
/guildadmin relation	guild.admin.relation	管理关系
/guildadmin test	guild.admin.test	测试功能

变量支持（PlaceholderAPI）

公会变量

%guild_name%：公会名称
%guild_tag%：公会标签
%guild_membercount%：当前成员数
%guild_maxmembers%：最大成员数
%guild_level%：公会等级
%guild_balance%：资金（2位小数）
%guild_frozen%：状态（正常/冻结/无公会）

玩家变量

%guild_role%：角色（会长/官员/成员）
%guild_joined%：加入时间
%guild_contribution%：贡献值

状态变量

%guild_hasguild%：是否有公会
%guild_isleader%、%guild_isofficer%、%guild_ismember%：角色判定

权限变量

%guild_caninvite%、%guild_cankick%、%guild_canpromote%、%guild_candemote%、%guild_cansethome%、%guild_canmanageeconomy%

配置示例

config.yml

database:
  type: sqlite # 支持 sqlite 或 mysql
  mysql:
    host: localhost
    port: 3306
    database: guild
    username: root
    password: ""
    pool-size: 10

guild:
  min-name-length: 3
  max-name-length: 20
  max-tag-length: 6
  max-description-length: 100
  max-members: 50
  creation-cost: 1000.0
permissions:
  default:
    can-create: true
    can-invite: true
    can-kick: true
    can-promote: true
    can-demote: false
    can-delete: false

数据库结构（主表）

guilds（公会表）
guild_members（成员表）
guild_applications（申请表）
guild_relations（关系表）
guild_economy（经济表）

SQL 示例见 plugins/database.sql。

FAQ 常见问题

插件无法启动？请确认服务器版本、JDK、依赖是否齐全，配置文件格式是否正确。
经济系统不工作？请确认 Vault 和经济插件已安装，config.yml 配置正确。
数据库连接失败？检查数据库配置、MySQL运行状态、账号权限等。
GUI界面异常？检查配置文件格式与变量替换。
公会创建失败？检查玩家资金、名称是否重复或过长，玩家是否已加入其他公会等。

更新日志

v1.0.0

初始版本发布
完整公会管理系统
经济系统集成
公会关系管理
等级系统
完整 GUI 界面
支持多数据库
权限系统
PlaceholderAPI 集成

v1.2.3

基础功能发布
完全正确的逻辑处理
完全支持插件扩展
完全实现GUI
完全实现folia支持
支持多数据库
完全使用内置权限系统

计划功能

项目主页与支持

GitHub: chenasyd/-GuildPlugin
官方主页/文档：http://chenasyd.codewaves.cn/
B站作者主页：https://space.bilibili.com/1930829400

许可证

GuildPlugin 遵循 GNU GPL v3.0 开源协议，欢迎二次开发与贡献！

GuildPlugin - Feature-Complete Minecraft Guild System (English)

GuildPlugin is a comprehensive and high-performance Minecraft server plugin that delivers a full-featured guild/faction system, including management, economy, relations, leveling, GUI, and more. Free and open-source!

Core Features

Create and manage guilds (name, tag, description)
Role-based system: Leader, Officer, Member
Invite, kick, promote, demote members
Guild home set and teleport
Guild application system
Economy: guild funds, deposit, withdraw, transfer (Vault support)
Inter-guild relati

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
.github/workflows		.github/workflows
.idea		.idea
src/main		src/main
target		target
LICENSE		LICENSE
README.md		README.md
build.bat		build.bat
build.sh		build.sh
config.yml		config.yml
database.yml		database.yml
dependency-reduced-pom.xml		dependency-reduced-pom.xml
gui.yml		gui.yml
guild-plugin.iml		guild-plugin.iml
messages.yml		messages.yml
plugin.yml		plugin.yml
pom.xml		pom.xml

License

chenasyd/-GuildPlugin

Folders and files

Latest commit

History

Repository files navigation

Guild Plugin - Feature-Complete Minecraft Guild System(需要官方中文翻译请往下滑)

Core Features

Guild Management

Economy System

Relationship System

Leveling System

User Interface

Technical Features

Commands

Permission Nodes

Basic Guild Information Variables

Guild Basic Info

Player Guild Info

Guild Status Check Variables

Player Status

Guild Permission Check Variables

Permission Status

Requirements

Installation Steps

📋 中文目录

✨ 功能特性

核心功能

高级功能

🚀 安装指南

前置要求

安装步骤

⚙️ 配置说明

主配置文件 (config.yml)

消息配置文件 (messages.yml)

GUI配置文件 (gui.yml)

数据库配置文件 (database.yml)

📝 命令列表

玩家命令

管理员命令

🖥️ GUI界面

主界面

创建工会界面

成员管理界面

💰 经济系统

功能特性

等级系统

经济命令

🤝 工会关系

关系类型

关系管理

关系命令

🗄️ 数据库

数据表结构

guilds (工会表)

guild_members (成员表)

guild_applications (申请表)

guild_relations (关系表)

guild_economy (经济表)

GuildPlugin - 完整功能的 Minecraft 公会系统插件

核心特性

公会管理

经济系统

关系系统

等级系统

用户界面

技术特性

快速开始

环境需求

安装步骤

Maven 构建（开发者）

主要命令一览

玩家命令

管理员命令

变量支持（PlaceholderAPI）

公会变量

玩家变量

状态变量

权限变量

配置示例

Packages