- 版权类型
- 原创
- 插件中文名称
- 社团
- 插件英文名称
- Shetuan
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- Leaves
- 语言支持
- 中文(简体)
- 前置组件
- Vault https://www.spigotmc.org/resources/vault.34315/ (必须)
PlaceholderAPI https://www.spigotmc.org/resources/placeholderapi.6245/ (可选)
Luckperms https://www.spigotmc.org/resources/luckperms.28140/ (可选)
- 适配版本(Java)
- 1.21
- 1.20
Shetuan 是一个 Spigot/Paper 1.20+ 的社团(公会)插件,提供社团创建、入社申请/邀请、社团公告、社团主城、社团聊天(可选跨服)、GUI 菜单等功能,并支持 MySQL 与本地 YAML 双存储模式。
主要指令(Commands)
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| `/shetuan` | 打开社团主菜单(已入社)/显示帮助(未入社) | 玩家 |
| `/shetuan create <名字>` | 创建社团(会扣费) | 未入社 |
| `/shetuan join <社团名>` | 申请加入社团(由社长审核) | 未入社 |
| `/shetuan accept <社长名字>` | 接受该社长发出的邀请 | 未入社 |
| `/shetuan deny` | 拒绝所有待处理邀请(拒绝反馈给社长,支持离线) | 未入社 |
| `/shetuan list` | 打开社团预览列表 | 任意 |
| `/shetuan top [数量]` | 社团排行榜(默认 10,范围 1-50) | 任意 |
| `/shetuan invite <玩家>` | 邀请玩家加入社团(支持离线邀请提示) | 社长 |
| `/shetuan joinrequests` | 打开入社申请列表(GUI 处理) | 社长 |
| `/shetuan kick <玩家>` | 踢出成员(支持离线踢出提示) | 社长 |
| `/shetuan transfer <玩家>` | 转让社长(GUI 二次确认) | 社长 |
| `/shetuan leave` | 退出社团(社长不可用) | 成员 |
| `/shetuan disband` | 解散社团(GUI 二次确认,支持离线通知) | 社长 |
| `/shetuan rename <新名字>` | 修改社团名字(会扣费) | 社长 |
| `/shetuan color` | 打开颜色选择(GUI) | 社长 |
| `/shetuan icon` | 打开图标选择(GUI) | 社长 |
| `/shetuan upgrade` | 升级社团等级(提升人数上限,会扣费) | 社长 |
| `/shetuan home` | 传送到社团主城(有冷却,可配置跨服检查) | 已入社 |
| `/shetuan sethome` | 设置社团主城为当前位置 | 社长 |
| `/shetuan chat` | 开关社团聊天(仅影响自己是否接收/发送) | 已入社 |
| `/shetuan notice list` | 打开公告列表(GUI) | 已入社 |
| `/shetuan notice read <公告ID>` | 阅读公告并标记已读 | 已入社 |
| `/shetuan notice add <内容...>` | 发布公告(最多 3 条;发布时全员提示,在线可点击阅读,离线会收到提示) | 社长 |
| `/shetuan notice status <公告ID>` | 查看已读/未读成员列表 | 已入社 |
| `/shetuan info` | 查看本社团信息与成员列表 | 已入社 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| `/shetuanadmin reload` | 重载 `config.yml/messages.yml/gui.yml` 并重新加载缓存 |
| `/shetuanadmin set <社团名\|none> <玩家>` | 强制设置玩家所属社团(`none` 表示移除社团;不允许对社长执行) |
| `/shetuanadmin delete <社团名>` | 删除社团(清理成员、公告、聊天数据) |
| `/shetuanadmin transfer <社团名> <玩家>` | 强制转让社长(对社团全员发送通知,支持离线) |
| `/shetuanadmin remove <玩家>` | 强制踢出玩家;若是社长则触发继承(玩家管理员会弹 GUI 确认) |
| `/shetuanadmin autotransfer <天数\|reset>` | 修改自动转让判定天数(写入配置) |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
权限节点(Luckperms)
- `shetuan.command.**`
- `shetuan.command.*`
- `shetuan.command.<子命令>`(例如 `shetuan.command.create`、`shetuan.command.notice`)
- `shetuan.user`:默认 true,包含 `shetuan.use` 与 `shetuan.command.*`
- `shetuan.admin`:默认 op,包含 `shetuan.admin.use` 与 `shetuan.command.**`
- `shetuan.admin.nocd`:主城传送冷却绕过
变量(PlaceholderAPI)
- %shetuan_name% 显示当前加入的社团名字
- %shetuan_leader% 显示当前加入社团的社长名字
获取帮助(GetHelp)
QQ群反馈:1056324728
源码也在Q群内部
配置文件(Configs)
主要指令(Commands)
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| `/shetuan` | 打开社团主菜单(已入社)/显示帮助(未入社) | 玩家 |
| `/shetuan create <名字>` | 创建社团(会扣费) | 未入社 |
| `/shetuan join <社团名>` | 申请加入社团(由社长审核) | 未入社 |
| `/shetuan accept <社长名字>` | 接受该社长发出的邀请 | 未入社 |
| `/shetuan deny` | 拒绝所有待处理邀请(拒绝反馈给社长,支持离线) | 未入社 |
| `/shetuan list` | 打开社团预览列表 | 任意 |
| `/shetuan top [数量]` | 社团排行榜(默认 10,范围 1-50) | 任意 |
| `/shetuan invite <玩家>` | 邀请玩家加入社团(支持离线邀请提示) | 社长 |
| `/shetuan joinrequests` | 打开入社申请列表(GUI 处理) | 社长 |
| `/shetuan kick <玩家>` | 踢出成员(支持离线踢出提示) | 社长 |
| `/shetuan transfer <玩家>` | 转让社长(GUI 二次确认) | 社长 |
| `/shetuan leave` | 退出社团(社长不可用) | 成员 |
| `/shetuan disband` | 解散社团(GUI 二次确认,支持离线通知) | 社长 |
| `/shetuan rename <新名字>` | 修改社团名字(会扣费) | 社长 |
| `/shetuan color` | 打开颜色选择(GUI) | 社长 |
| `/shetuan icon` | 打开图标选择(GUI) | 社长 |
| `/shetuan upgrade` | 升级社团等级(提升人数上限,会扣费) | 社长 |
| `/shetuan home` | 传送到社团主城(有冷却,可配置跨服检查) | 已入社 |
| `/shetuan sethome` | 设置社团主城为当前位置 | 社长 |
| `/shetuan chat` | 开关社团聊天(仅影响自己是否接收/发送) | 已入社 |
| `/shetuan notice list` | 打开公告列表(GUI) | 已入社 |
| `/shetuan notice read <公告ID>` | 阅读公告并标记已读 | 已入社 |
| `/shetuan notice add <内容...>` | 发布公告(最多 3 条;发布时全员提示,在线可点击阅读,离线会收到提示) | 社长 |
| `/shetuan notice status <公告ID>` | 查看已读/未读成员列表 | 已入社 |
| `/shetuan info` | 查看本社团信息与成员列表 | 已入社 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| `/shetuanadmin reload` | 重载 `config.yml/messages.yml/gui.yml` 并重新加载缓存 |
| `/shetuanadmin set <社团名\|none> <玩家>` | 强制设置玩家所属社团(`none` 表示移除社团;不允许对社长执行) |
| `/shetuanadmin delete <社团名>` | 删除社团(清理成员、公告、聊天数据) |
| `/shetuanadmin transfer <社团名> <玩家>` | 强制转让社长(对社团全员发送通知,支持离线) |
| `/shetuanadmin remove <玩家>` | 强制踢出玩家;若是社长则触发继承(玩家管理员会弹 GUI 确认) |
| `/shetuanadmin autotransfer <天数\|reset>` | 修改自动转让判定天数(写入配置) |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
权限节点(Luckperms)
- `shetuan.command.**`
- `shetuan.command.*`
- `shetuan.command.<子命令>`(例如 `shetuan.command.create`、`shetuan.command.notice`)
- `shetuan.user`:默认 true,包含 `shetuan.use` 与 `shetuan.command.*`
- `shetuan.admin`:默认 op,包含 `shetuan.admin.use` 与 `shetuan.command.**`
- `shetuan.admin.nocd`:主城传送冷却绕过
变量(PlaceholderAPI)
- %shetuan_name% 显示当前加入的社团名字
- %shetuan_leader% 显示当前加入社团的社长名字
获取帮助(GetHelp)
QQ群反馈:1056324728
源码也在Q群内部
配置文件(Configs)
YAML:
server:
id: "server-1"
storage:
mysql:
enabled: false
host: "127.0.0.1"
port: 3306
database: "minecraft"
username: "root"
password: ""
poolSize: 10
permissions:
use: "shetuan.user"
adminUse: "shetuan.admin"
bypassHomeCooldown: "shetuan.admin.nocd"
name:
min: 2
max: 6
suffix: "社"
members:
defaultMax: 20
autoTransfer:
enabled: true
offlineDays: 30
candidateOnlineDays: 60
cooldown:
homeSeconds: 10
costs:
create: 10000.0
rename: 5000.0
changeColor: 2000.0
changeIcon: 2000.0
upgrade:
2: 50000.0
3: 120000.0
levels:
1:
maxMembers: 20
2:
maxMembers: 30
3:
maxMembers: 40
colors:
- id: "red"
display: "&c红色"
value: "&c"
- id: "hex_red"
display: "&f#FF5555"
value: "#FF5555"
- id: "gradient_rg"
display: "&f红绿渐变"
value: "gradient:#FF0000-#00FF00"
icons:
- id: "paper"
display: "&f纸"
material: "PAPER"
- id: "diamond"
display: "&b钻石"
material: "DIAMOND"
- id: "book"
display: "&a书"
material: "BOOK"
chat:
enabled: true
format: "&7[&a社团&7] {club} &f{player}&7: &f{message}"
crossServer:
enabled: false
pollTicks: 20
placeholders:
name:
format: "{club}"
join:
defaultPolicy: "OPEN"
inviteExpireSeconds: 300
YAML:
main:
title: "&a社团菜单"
size: 54
items:
color:
slot: 20
material: "NAME_TAG"
name: "&e修改颜色"
lore:
- "&7点击选择社团名称颜色"
icon:
slot: 22
material: "ITEM_FRAME"
name: "&e修改图标"
lore:
- "&7点击选择社团图标"
notice:
slot: 24
material: "PAPER"
name: "&e公告"
lore:
- "&7查看与阅读公告"
browse:
slot: 13
material: "BOOK"
name: "&e社团预览"
lore:
- "&7查看所有社团列表"
home:
slot: 31
material: "ENDER_PEARL"
name: "&e社团主城"
lore:
- "&7点击传送到主城"
upgrade:
slot: 40
material: "EXPERIENCE_BOTTLE"
name: "&e升级社团"
lore:
- "&7提升人数上限"
join_requests:
slot: 42
material: "WRITABLE_BOOK"
name: "&e入社申请"
lore:
- "&7查看并处理入社申请(社长)"
join_policy:
slot: 44
material: "COMPARATOR"
name: "&e加入设置"
lore:
- "&7设置社团加入策略(社长)"
joinRequests:
title: "&a入社申请"
size: 54
requestItem:
material: "PAPER"
name: "&e{player}"
lore:
- "&7申请加入: {club}"
- "&a点击处理"
close:
slot: 49
material: "BARRIER"
name: "&c关闭"
lore:
- "&7关闭界面"
joinRequestConfirm:
title: "&a处理申请"
size: 27
approve:
slot: 11
material: "LIME_WOOL"
name: "&a同意"
lore:
- "&7同意 &f{player} &7加入 {club}"
deny:
slot: 15
material: "RED_WOOL"
name: "&c拒绝"
lore:
- "&7拒绝 &f{player} &7的申请"
cancel:
slot: 22
material: "BARRIER"
name: "&7返回"
lore:
- "&7返回列表"
joinPolicy:
title: "&a加入设置"
size: 27
open:
slot: 11
material: "LIME_WOOL"
name: "&a任何人可申请加入"
lore:
- "&7当前: {current}"
inviteOnly:
slot: 13
material: "YELLOW_WOOL"
name: "&e仅邀请加入"
lore:
- "&7当前: {current}"
closed:
slot: 15
material: "RED_WOOL"
name: "&c禁止加入"
lore:
- "&7当前: {current}"
back:
slot: 22
material: "BARRIER"
name: "&7关闭"
lore:
- "&7关闭界面"