SomeClans
SomeClans 是一款适用于 Paper / Purpur 1.16.5+ 的公会插件,支持经济系统、图形用户界面(GUI)、公会升级、公会特效、钱包功能、占位符、MySQL / SQLite 存储以及管理工具。
特性
- 公会创建、邀请、职位、公会聊天及公会管理
- 基于 GUI 的公会菜单
- 公会钱包,支持:
- 公会升级:
- 公会特效及其激活/购买逻辑
- 共享存储的公会箱子
- 可配置公会成员间的友军伤害
- 在 GUI 中选择公会盔甲颜色
- PlaceholderAPI 支持
- MySQL / SQLite / 本地存储模式
- 从数据库同步的管理员缓存
- 管理员与成员的操作日志记录在数据库中:
要求
- Java
17+
- Paper / Purpur
1.16.5 - 1.20.x
可选插件:
Vault
CMI 或通过 Vault 连接的其他经济提供商
PlaceholderAPI
PlayerPoints
安装
- 构建插件:
mvn -U -q -DskipTests package
- 将
target/ 目录中生成的 jar 文件放入服务器的 plugins/ 文件夹。
- 启动服务器。
- 配置插件文件夹中生成的文件。
生成的文件
首次运行时,插件会创建以下文件:
plugins/SomeClans/
├── config.yml
├── messages.yml
├── gui.yml
├── upgrades.yml
├── effects.yml
└── data/
如果启用了 SQLite,数据库文件将存储在 plugins/SomeClans/data/ 中。
存储
支持的存储模式:
数据库表:
clans
members
adminlogs
memberlogs
主要命令
玩家命令
/clan
/clan create <name>
/clan tag <tag>
/clan invite <player>
/clan accept
/clan deny
/clan leave
/clan disband
/clan deposit <amount>
/clan withdraw <amount>
/clan chat <message>
/clan togglechat
/clan members
/clan upgrades
/clan effects
管理员命令
/clanadmin reload
/clanadmin delete <clan>
/clanadmin setlevel <clan> <level>
/clanadmin addmoney <clan> <amount>
/clanadmin info <player>
/clanadmin look <clan>
/clanadmin updatebydatabase
权限
someclans.use
someclans.create
someclans.invite
someclans.join
someclans.leave
someclans.chat
someclans.admin
占位符
需要 PlaceholderAPI。
%someclans_name%
%someclans_tag%
%someclans_level%
%someclans_role%
%someclans_members%
%someclans_balance%
%someclans_points%
行为说明:
%someclans_name% 如果设置了标签则返回公会标签
- 如果标签为空,则返回公会名称
- 如果玩家没有加入公会,则返回配置的默认回退值
经济
支持的经济来源:
公会钱包支持两种独立的余额:
公会箱子
- 共享公会箱子
- 基于升级的容量增长
- 允许在公会箱子中使用“Shift+点击”
- 允许在公会箱子中使用数字键快捷栏转移物品
- 在其他 GUI 菜单中阻止快速物品转移
视觉盔甲模式
公会盔甲颜色仅对公会成员可见。
重要提示:
- 真实的盔甲物品和属性不会改变
- 同一公会的其他玩家会收到带有颜色的视觉效果更新
- 其他玩家仍然看到真实的盔甲
SomeClans
SomeClans is a clan plugin for Paper / Purpur 1.16.5+ with economy, GUI, clan upgrades, clan effects, wallet support, placeholders, MySQL / SQLite storage, and admin tools.
Features
- Clan creation, invitations, roles, clan chat, and clan management
- GUI-based clan menus
- Clan wallet with:
- coin deposit / withdraw
PlayerPoints deposit / withdraw
- Clan upgrades:
- member slots
- effect slots
- clan chest size
- Clan effects and active / purchased effect logic
- Clan chest with shared storage
- Configurable friendly-fire between clan members
- Clan armor color selection in GUI
- PlaceholderAPI support
- MySQL / SQLite / local storage mode
- Admin cache sync from database
- Admin and member action logs in database:
Requirements
- Java
17+
- Paper / Purpur
1.16.5 - 1.20.x
Optional plugins:
Vault
CMI or another economy provider through Vault
PlaceholderAPI
PlayerPoints
Installation
- Build the plugin:
mvn -U -q -DskipTests package
- Put the built jar from
target/ into your server plugins/ folder.
- Start the server.
- Configure the generated files in the plugin folder.
Generated files
On first launch the plugin creates:
plugins/SomeClans/
├── config.yml
├── messages.yml
├── gui.yml
├── upgrades.yml
├── effects.yml
└── data/
If SQLite is enabled, the database file is stored in plugins/SomeClans/data/.
Storage
Supported storage modes:
Database tables:
clans
members
adminlogs
memberlogs
Main commands
Player commands
/clan
/clan create <name>
/clan tag <tag>
/clan invite <player>
/clan accept
/clan deny
/clan leave
/clan disband
/clan deposit <amount>
/clan withdraw <amount>
/clan chat <message>
/clan togglechat
/clan members
/clan upgrades
/clan effects
Admin commands
/clanadmin reload
/clanadmin delete <clan>
/clanadmin setlevel <clan> <level>
/clanadmin addmoney <clan> <amount>
/clanadmin info <player>
/clanadmin look <clan>
/clanadmin updatebydatabase
Permissions
someclans.use
someclans.create
someclans.invite
someclans.join
someclans.leave
someclans.chat
someclans.admin
Placeholders
Requires PlaceholderAPI.
%someclans_name%
%someclans_tag%
%someclans_level%
%someclans_role%
%someclans_members%
%someclans_balance%
%someclans_points%
Behavior:
%someclans_name% returns clan tag if set
- if tag is empty, it returns the clan name
- if the player has no clan, it returns the configured fallback value
Economy
Supported economy sources:
Clan wallet supports two separate balances:
Clan chest
- Shared clan chest
- Upgrade-based size growth
Shift-click is allowed in the clan chest
- Number key hotbar transfer is allowed in the clan chest
- Fast item transfer is blocked in other GUI menus
Visual armor mode
Clan armor color is visual for clan members.
Important:
- real armor items and stats are not changed
- viewers in the same clan receive a colored visual equipment update
- other players still see the real armor
Build notes
If mvn package fails during shading with an error similar to:
Could not replace original artifact with shaded artifact
it usually means the previous jar in target/ is locked by the server or another process.
Project
- Language:
Java 17
- API:
Paper 1.16.5
- Build tool:
Maven
评论 0
登录后参与评分
还没有评论,来抢沙发吧