定制插件 - CatGuildH 公会插件
￥9,999,999.00
已售 1 次
CatGuildH是一个功能丰富的Minecraft公会插件，为服务器提供完整的公会系统解决方案。插件支持创建和管理公会、成员管理、传送点系统、权限分级、GUI操作界面等核心功能，同时提供多种存储方式选择，满足不同规模服务器的需求。
插件最新版本：1.0.4
最近更新日期：2025年8月14日
维护结束日期：2026年1月3日
每次更新插件请替换原插件文件并删除config.yml配置文件重新生成！
插件信息
- 插件名称: CatGuildH
- 版本: 1.0.4
- 支持版本: 1.20.+ Paper/Folia
- 作者: KleineStar.qq2401023554
主要功能
核心功能
- ✅ 公会创建与管理: 支持创建、解散、改名公会
- ✅ 成员管理系统: 邀请、申请、提升、降级、踢出成员
- ✅ 传送点系统: 自定义传送点设置和管理，支持Folia多线程服务器
- ✅ 在线时间统计: 自动记录和统计玩家在线时间
- ✅ 权限分级管理: 会长、管理员、普通成员三级权限
- ✅ GUI界面操作: 图形化界面，操作便捷
- ✅ 高性能传送系统: 异步处理、队列管理、超时处理、错误恢复
高级功能
- ✅ 多存储支持: YAML、MySQL、SQLite三种存储方式
- ✅ 冷却时间系统: 公会改名、退出公会等操作冷却
- ✅ 广播消息系统: 公会重要事件全服广播
- ✅ Tab列表集成: 显示公会前缀
- ✅ 聊天系统集成: 公会聊天格式
- ✅ PlaceholderAPI支持: 为其他插件提供公会相关占位符
安装说明
1. 下载最新版本的CatGuildH.jar文件
2. 将插件放入服务器的plugins文件夹中
3. 重启服务器或使用插件管理器加载插件
4. 首次启动后，插件将自动生成配置文件
5. 根据需要修改配置文件，然后使用`/cgh reload`重载插件
配置系统
config.yml 主要配置项
存储设置
公会设置
消息设置
GUI设置
监听器设置
指令系统
基础指令
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh` | `catguildh.use` | 打开公会主菜单 |
| `/cgh help` | `catguildh.use` | 显示帮助信息 |
| `/cgh gui` | `catguildh.use` | 打开GUI界面 |
| `/cgh list [页码]` | `catguildh.use` | 查看公会列表 |
| `/cgh info [公会名]` | `catguildh.use` | 查看公会信息 |
公会创建与加入
| 指令 | 权限节点 | 描述 |
|--------------------------|--------------------|--------------------|
| `/cgh create <公会名>` | `catguildh.create` | 创建公会 (公会名默认6个字符) |
| `/cgh apply <公会名>` | `catguildh.use` | 申请加入公会 (需12小时在线时间) |
| `/cgh accept <公会名|玩家名>` | `catguildh.use` | 接受申请/邀请 |
| `/cgh reject <公会名|玩家名>` | `catguildh.use` | 拒绝申请/邀请 |
| `/cgh invite <玩家名>` | `catguildh.use` | 邀请玩家加入公会 (需管理员权限) |
公会管理
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh promote <玩家名>` | `catguildh.use` | 提升成员为管理员 (需会长权限) |
| `/cgh demote <玩家名>` | `catguildh.use` | 降级管理员为普通成员 (需会长权限) |
| `/cgh kick <玩家名>` | `catguildh.use` | 踢出公会成员 (需管理员权限) |
| `/cgh setowner <玩家名>` | `catguildh.use` | 转让会长职位 (需会长权限) |
| `/cgh rename <新名称>` | `catguildh.use` | 公会改名 (需会长权限，24小时冷却) |
| `/cgh disband` | `catguildh.use` | 解散公会 (仅会长) |
| `/cgh leave` | `catguildh.use` | 退出公会 (6小时冷却) |
传送点管理
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh setpoint <名称>` | `catguildh.use` | 设置传送点 (需管理员权限) |
| `/cgh tp <名称>` | `catguildh.use` | 传送到指定点 |
| `/cgh delpoint <名称>` | `catguildh.use` | 删除传送点 (需管理员权限) |
管理员指令
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh reload` | `catguildh.admin` | 重载插件配置 |
| `/cgh setplaytime <玩家名> <小时数>` | `catguildh.admin` | 设置玩家游戏时间 |
| `/cgh removecooldown <玩家名>` | `catguildh.admin` | 移除玩家退出冷却时间 |
| `/cgh debug <on|off>` | `catguildh.admin` | 开启/关闭调试模式 |
权限系统
权限节点说明
基础权限
- `catguildh.use` - 基础使用权限，允许使用所有基础功能
- `catguildh.create` - 创建公会权限，允许创建新公会（默认关闭）
管理员权限
- `catguildh.admin` - 管理员权限，允许使用所有管理员功能
- `catguildh.reload` - 重载配置权限
公会内部权限
会长权限
- 转让会长职位
- 解散公会
- 公会改名
- 提升/降级管理员
- 管理所有成员
- 管理传送点
管理员权限
- 邀请玩家
- 踢出普通成员
- 管理传送点
- 处理申请
普通成员权限
- 查看公会信息
- 使用传送点
- 退出公会
最新更新内容
版本 1.0.0
- 初始版本发布
- 实现公会基础功能
- 支持多种存储方式
- 完整的GUI系统
- 权限分级管理
- 传送点系统
- 在线时间统计
- 修复了退出公会冷却时间功能的问题
- 管理员现在可以查看和处理公会申请
- 修复了退出公会后冷却时间不生效的问题
- 修复了公会管理员无法看到待处理申请的问题
- 修复了数据存储层在移除数据项时的实现问题
版本 1.0.1
- 修复了后台无法执行插件管理指令的问题
- 修复了消息提示中占位符显示为变量的问题
- 修复了 %catguildh_guild_first% 占位符显示空白的问题
- 修复了PlaceholderAPI扩展注册失败的问题
版本 1.0.2
- 优化了 PlaceholderAPI 扩展的注册方式
- 修复了占位符在某些情况下显示不正确的问题
- 改进了 PlaceholderAPI 扩展注册的提示信息
- 增加了更多占位符别名，提高了兼容性
- 修复了后台无法执行相关指令的问题
版本 1.0.3
- 优化了公会传送系统，彻底解决在Folia服务器上的线程死锁问题
- 添加了传送队列系统，避免短时间内大量传送请求
- 添加了传送冷却时间限制，可在配置文件中设置
- 使用Paper的区块票据API预加载目标区块，提高传送稳定性
- 添加了传送超时自动取消机制，防止传送请求无限等待
- 添加了定期清理机制，自动清理过期的传送请求
- 添加了完整的错误处理和恢复机制，提高系统稳定性
- 新增了创建公会的专用权限节点 `catguildh.create`（默认关闭）
- 在配置文件中添加了传送系统的详细设置选项
- 修复了玩家在骑乘、坐下或睡觉状态时传送导致后台报错的问题
- 改进了传送前玩家状态检测，自动处理特殊状态（骑乘、睡觉、潜行、游泳、滑翔等）
- 优化了传送后状态恢复，保留玩家飞行状态
版本 1.0.4
- 优化公会传送点坐标显示机制，可在config中设置是否显示，默认为false关闭显示
- 修复和优化了传送崩服问题，提高了在Folia服务器上的兼容性
- 新增传送等待时间机制（预热系统），玩家需在原地等待一段时间才能传送
- 新增插件消息自定义功能，通过messages.yml文件可以直接修改所有消息
- 兼容了GSit插件，当玩家处于其他动作状态时会自动取消动作并进行传送
- 新增传送安全检查机制，防止玩家在危险环境中传送
- 优化了权限系统，新增传送冷却和预热豁免权限
- 优化了错误处理机制，提高了系统稳定性
PlaceholderAPI 支持
插件支持 PlaceholderAPI，为其他插件提供公会相关的占位符。如果服务器安装了 PlaceholderAPI，插件会自动注册以下占位符：
可用占位符
| 占位符 | 描述 | 示例 |
|--------|------|------|
| `%catguildh_guild%` | 玩家所在公会名称 | `[公会名]` |
| `%catguildh_guild_first%` | 玩家所在公会名称第一个字符 | `[公]` |
| `%catguildh_guild_owner%` | 玩家所在公会会长名称 | `玩家名` |
| `%catguildh_guild_members%` | 玩家所在公会成员数量 | `15` |
| `%catguildh_guild_max_members%` | 公会最大成员数量 | `50` |
| `%catguildh_guild_role%` | 玩家在公会中的角色 | `会长`/`管理员`/`成员` |
| `%catguildh_has_guild%` | 玩家是否有公会 | `true`/`false` |
使用示例
在其他插件的配置文件中可以使用这些占位符：
技术支持
联系方式
- 作者: KleineStar.qq2401023554
常见问题
Q: 插件无法启动
A: 检查Java版本是否为17+，确保Paper版本为1.20.1
Q: 数据库连接失败
A: 检查MySQL配置是否正确，确保数据库服务正常运行
Q: GUI界面显示异常
A: 检查配置文件中的GUI标题设置，确保颜色代码正确
Q: 权限不生效
A: 确保权限插件正确安装，检查权限节点是否正确设置
Q: 退出公会冷却时间不生效
A: 确保最新版本已正确安装，并检查config.yml中的leave-cooldown设置
Q: 使用GSit插件时，传送导致服务器崩溃？
A: 请升级到1.0.4或更高版本，该版本修复了与GSit插件的兼容性问题
Q: PlaceholderAPI占位符不显示？
A: 请检查以下几点：
1. 确认服务器已安装PlaceholderAPI插件
2. 重启服务器让插件自动注册占位符
3. 检查控制台是否有相关错误信息
4. 确认占位符格式正确（使用`%catguildh_xxx%`格式）
API 支持
CatGuildH 插件提供了完整的 API，供其他插件调用公会数据。
错误报告
如遇到问题，请提供以下信息：
1. 服务器版本和插件版本
2. 错误日志
3. 配置文件内容
4. 复现步骤
---
CatGuildH - 专业的公会管理系统
版本 1.0.4 | 适用于 Minecraft 1.20.+ Paper
© 2025 KleineStar.qq2401023554 - 保留所有权利
插件最新版本：1.0.4
最近更新日期：2025年8月14日
维护结束日期：2026年1月3日
每次更新插件请替换原插件文件并删除config.yml配置文件重新生成！
插件信息
- 插件名称: CatGuildH
- 版本: 1.0.4
- 支持版本: 1.20.+ Paper/Folia
- 作者: KleineStar.qq2401023554
主要功能
核心功能
- ✅ 公会创建与管理: 支持创建、解散、改名公会
- ✅ 成员管理系统: 邀请、申请、提升、降级、踢出成员
- ✅ 传送点系统: 自定义传送点设置和管理，支持Folia多线程服务器
- ✅ 在线时间统计: 自动记录和统计玩家在线时间
- ✅ 权限分级管理: 会长、管理员、普通成员三级权限
- ✅ GUI界面操作: 图形化界面，操作便捷
- ✅ 高性能传送系统: 异步处理、队列管理、超时处理、错误恢复
高级功能
- ✅ 多存储支持: YAML、MySQL、SQLite三种存储方式
- ✅ 冷却时间系统: 公会改名、退出公会等操作冷却
- ✅ 广播消息系统: 公会重要事件全服广播
- ✅ Tab列表集成: 显示公会前缀
- ✅ 聊天系统集成: 公会聊天格式
- ✅ PlaceholderAPI支持: 为其他插件提供公会相关占位符
安装说明
1. 下载最新版本的CatGuildH.jar文件
2. 将插件放入服务器的plugins文件夹中
3. 重启服务器或使用插件管理器加载插件
4. 首次启动后，插件将自动生成配置文件
5. 根据需要修改配置文件，然后使用`/cgh reload`重载插件
配置系统
config.yml 主要配置项
存储设置
storage:
type: yaml 存储类型: yaml/mysql/sqlite
MySQL 配置 (仅当 type: mysql 时使用)
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: ''
SQLite 配置 (仅当 type: sqlite 时使用)
sqlite:
file: plugins/CatGuildH/database.db
公会设置
guild:
create-time-required: 24 创建公会所需时间(小时)
join-time-required: 12 加入公会所需时间(小时)
leave-cooldown: 6 退出公会后加入新公会的冷却时间(小时)
# 传送系统设置
teleport-cooldown: 5 传送点传送冷却时间(秒)
teleport-timeout: 3 传送超时时间(秒)
max-concurrent-teleports: 2 最大并发传送数量
max-members: 50 最大成员数量
max-admins: 2 最大管理员数量
max-name-length: 6 公会名称最大长度
allow-color-codes: true 是否允许颜色代码
max-teleport-points: 10 最大传送点数量
消息设置
messages:
prefix: '&bCatGuildH &7>> &3' 消息前缀
guild-created: '&3成功创建公会 &b%guild%&3.'
guild-disbanded: '&3公会 &b%guild% &3已解散.'
guild-joined: '&3你已加入公会 &b%guild%&3.'
guild-left: '&3你已退出公会 &b%guild%&3.'
... 更多消息配置
GUI设置
gui:
main-title: '&9公会界面'
list-title: '&9公会列表'
info-title: '&9公会信息'
invite-title: '&9公会邀请'
application-title: '&9公会申请'
teleport-title: '&9公会传送点'
settings-title: '&9公会设置'
members-title: '&9公会成员'
help-title: '&9公会帮助'
监听器设置
listeners:
broadcast:
guild-join: true 是否启用加入公会全服提示
guild-leave: false 是否启用退出公会全服通告
guild-create: false 是否启用公会创建全服通告
guild-disband: true 是否启用公会解散全服通告
guild-owner-transfer: false 是否启用会长转让全服通告
debug-mode: false 是否启用调试模式
admin-debug: true 是否启用管理员调试功能
指令系统
基础指令
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh` | `catguildh.use` | 打开公会主菜单 |
| `/cgh help` | `catguildh.use` | 显示帮助信息 |
| `/cgh gui` | `catguildh.use` | 打开GUI界面 |
| `/cgh list [页码]` | `catguildh.use` | 查看公会列表 |
| `/cgh info [公会名]` | `catguildh.use` | 查看公会信息 |
公会创建与加入
| 指令 | 权限节点 | 描述 |
|--------------------------|--------------------|--------------------|
| `/cgh create <公会名>` | `catguildh.create` | 创建公会 (公会名默认6个字符) |
| `/cgh apply <公会名>` | `catguildh.use` | 申请加入公会 (需12小时在线时间) |
| `/cgh accept <公会名|玩家名>` | `catguildh.use` | 接受申请/邀请 |
| `/cgh reject <公会名|玩家名>` | `catguildh.use` | 拒绝申请/邀请 |
| `/cgh invite <玩家名>` | `catguildh.use` | 邀请玩家加入公会 (需管理员权限) |
公会管理
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh promote <玩家名>` | `catguildh.use` | 提升成员为管理员 (需会长权限) |
| `/cgh demote <玩家名>` | `catguildh.use` | 降级管理员为普通成员 (需会长权限) |
| `/cgh kick <玩家名>` | `catguildh.use` | 踢出公会成员 (需管理员权限) |
| `/cgh setowner <玩家名>` | `catguildh.use` | 转让会长职位 (需会长权限) |
| `/cgh rename <新名称>` | `catguildh.use` | 公会改名 (需会长权限，24小时冷却) |
| `/cgh disband` | `catguildh.use` | 解散公会 (仅会长) |
| `/cgh leave` | `catguildh.use` | 退出公会 (6小时冷却) |
传送点管理
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh setpoint <名称>` | `catguildh.use` | 设置传送点 (需管理员权限) |
| `/cgh tp <名称>` | `catguildh.use` | 传送到指定点 |
| `/cgh delpoint <名称>` | `catguildh.use` | 删除传送点 (需管理员权限) |
管理员指令
| 指令 | 权限节点 | 描述 |
|------|----------|------|
| `/cgh reload` | `catguildh.admin` | 重载插件配置 |
| `/cgh setplaytime <玩家名> <小时数>` | `catguildh.admin` | 设置玩家游戏时间 |
| `/cgh removecooldown <玩家名>` | `catguildh.admin` | 移除玩家退出冷却时间 |
| `/cgh debug <on|off>` | `catguildh.admin` | 开启/关闭调试模式 |
权限系统
权限节点说明
基础权限
- `catguildh.use` - 基础使用权限，允许使用所有基础功能
- `catguildh.create` - 创建公会权限，允许创建新公会（默认关闭）
管理员权限
- `catguildh.admin` - 管理员权限，允许使用所有管理员功能
- `catguildh.reload` - 重载配置权限
公会内部权限
会长权限
- 转让会长职位
- 解散公会
- 公会改名
- 提升/降级管理员
- 管理所有成员
- 管理传送点
管理员权限
- 邀请玩家
- 踢出普通成员
- 管理传送点
- 处理申请
普通成员权限
- 查看公会信息
- 使用传送点
- 退出公会
最新更新内容
版本 1.0.0
- 初始版本发布
- 实现公会基础功能
- 支持多种存储方式
- 完整的GUI系统
- 权限分级管理
- 传送点系统
- 在线时间统计
- 修复了退出公会冷却时间功能的问题
- 管理员现在可以查看和处理公会申请
- 修复了退出公会后冷却时间不生效的问题
- 修复了公会管理员无法看到待处理申请的问题
- 修复了数据存储层在移除数据项时的实现问题
版本 1.0.1
- 修复了后台无法执行插件管理指令的问题
- 修复了消息提示中占位符显示为变量的问题
- 修复了 %catguildh_guild_first% 占位符显示空白的问题
- 修复了PlaceholderAPI扩展注册失败的问题
版本 1.0.2
- 优化了 PlaceholderAPI 扩展的注册方式
- 修复了占位符在某些情况下显示不正确的问题
- 改进了 PlaceholderAPI 扩展注册的提示信息
- 增加了更多占位符别名，提高了兼容性
- 修复了后台无法执行相关指令的问题
版本 1.0.3
- 优化了公会传送系统，彻底解决在Folia服务器上的线程死锁问题
- 添加了传送队列系统，避免短时间内大量传送请求
- 添加了传送冷却时间限制，可在配置文件中设置
- 使用Paper的区块票据API预加载目标区块，提高传送稳定性
- 添加了传送超时自动取消机制，防止传送请求无限等待
- 添加了定期清理机制，自动清理过期的传送请求
- 添加了完整的错误处理和恢复机制，提高系统稳定性
- 新增了创建公会的专用权限节点 `catguildh.create`（默认关闭）
- 在配置文件中添加了传送系统的详细设置选项
- 修复了玩家在骑乘、坐下或睡觉状态时传送导致后台报错的问题
- 改进了传送前玩家状态检测，自动处理特殊状态（骑乘、睡觉、潜行、游泳、滑翔等）
- 优化了传送后状态恢复，保留玩家飞行状态
版本 1.0.4
- 优化公会传送点坐标显示机制，可在config中设置是否显示，默认为false关闭显示
- 修复和优化了传送崩服问题，提高了在Folia服务器上的兼容性
- 新增传送等待时间机制（预热系统），玩家需在原地等待一段时间才能传送
- 新增插件消息自定义功能，通过messages.yml文件可以直接修改所有消息
- 兼容了GSit插件，当玩家处于其他动作状态时会自动取消动作并进行传送
- 新增传送安全检查机制，防止玩家在危险环境中传送
- 优化了权限系统，新增传送冷却和预热豁免权限
- 优化了错误处理机制，提高了系统稳定性
PlaceholderAPI 支持
插件支持 PlaceholderAPI，为其他插件提供公会相关的占位符。如果服务器安装了 PlaceholderAPI，插件会自动注册以下占位符：
可用占位符
| 占位符 | 描述 | 示例 |
|--------|------|------|
| `%catguildh_guild%` | 玩家所在公会名称 | `[公会名]` |
| `%catguildh_guild_first%` | 玩家所在公会名称第一个字符 | `[公]` |
| `%catguildh_guild_owner%` | 玩家所在公会会长名称 | `玩家名` |
| `%catguildh_guild_members%` | 玩家所在公会成员数量 | `15` |
| `%catguildh_guild_max_members%` | 公会最大成员数量 | `50` |
| `%catguildh_guild_role%` | 玩家在公会中的角色 | `会长`/`管理员`/`成员` |
| `%catguildh_has_guild%` | 玩家是否有公会 | `true`/`false` |
使用示例
在其他插件的配置文件中可以使用这些占位符：
聊天格式
chat-format: '&7[%catguildh_guild%&7] &f%player%: %message%'
Tab列表格式（显示公会名称第一个字符）
tab-format: '&7[%catguildh_guild_first%&7] &f%player%'
计分板显示
scoreboard:
- '&b公会信息'
- '&7公会: &f%catguildh_guild%'
- '&7角色: &f%catguildh_guild_role%'
- '&7成员: &f%catguildh_guild_members%/%catguildh_guild_max_members%'
技术支持
联系方式
- 作者: KleineStar.qq2401023554
常见问题
Q: 插件无法启动
A: 检查Java版本是否为17+，确保Paper版本为1.20.1
Q: 数据库连接失败
A: 检查MySQL配置是否正确，确保数据库服务正常运行
Q: GUI界面显示异常
A: 检查配置文件中的GUI标题设置，确保颜色代码正确
Q: 权限不生效
A: 确保权限插件正确安装，检查权限节点是否正确设置
Q: 退出公会冷却时间不生效
A: 确保最新版本已正确安装，并检查config.yml中的leave-cooldown设置
Q: 使用GSit插件时，传送导致服务器崩溃？
A: 请升级到1.0.4或更高版本，该版本修复了与GSit插件的兼容性问题
Q: PlaceholderAPI占位符不显示？
A: 请检查以下几点：
1. 确认服务器已安装PlaceholderAPI插件
2. 重启服务器让插件自动注册占位符
3. 检查控制台是否有相关错误信息
4. 确认占位符格式正确（使用`%catguildh_xxx%`格式）
API 支持
CatGuildH 插件提供了完整的 API，供其他插件调用公会数据。
错误报告
如遇到问题，请提供以下信息：
1. 服务器版本和插件版本
2. 错误日志
3. 配置文件内容
4. 复现步骤
---
CatGuildH - 专业的公会管理系统
版本 1.0.4 | 适用于 Minecraft 1.20.+ Paper
© 2025 KleineStar.qq2401023554 - 保留所有权利
使用要求
- Minecraft 服务器版本：1.16.5 或者 1.20.1+
- 支持的服务端：Spigot, Paper, Bukkit
- 安装方式：将插件放入服务器的 plugins 目录，然后重启服务器或使用插件加载器加载