InfStarMC/EssentialsC
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

release: 发布 1.3.1

Browse Source
This commit is contained in:
Coldsmile
2026-08-16 20:22:10 +08:00
parent ba730cf45f
commit c9bc102d9a
21 changed files with 243 additions and 1074 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+14
View File
@@ -1,5 +1,19 @@
# 更新日志
## 1.3.1 - 2026-08-16
### 移除
- 移除内置维护模式、相关命令、权限、配置和 LuckPerms 软依赖；维护功能建议使用独立的 Maintenance 插件。
### 调整
- GitHub 仓库迁移至 InfstarMC 组织，并同步更新项目文档与下载地址。
### 升级说明
- 升级时不再读取 `maintenance.yml`；为避免删除管理员数据，服务器目录中的旧文件会原样保留，可在确认迁移完成后手动删除。
## 1.3.0 - 2026-08-05
### 新增
README.md
+11 -25
View File
@@ -2,8 +2,8 @@
轻量、现代、面向 Paper 服务端的基础功能插件，灵感来自 CMI，但更聚焦于常用能力与模块化构建。
[![Version](https://img.shields.io/github/v/release/Coldsmiles/EssentialsC?style=flat-square)](https://github.com/Coldsmiles/EssentialsC/releases)
[![License](https://img.shields.io/github/license/Coldsmiles/EssentialsC?style=flat-square)](LICENSE)
[![Version](https://img.shields.io/github/v/release/InfstarMC/EssentialsC?style=flat-square)](https://github.com/InfstarMC/EssentialsC/releases)
[![License](https://img.shields.io/github/license/InfstarMC/EssentialsC?style=flat-square)](LICENSE)
[![Paper](https://img.shields.io/badge/Paper-1.21.11%2B-blue?style=flat-square)](https://papermc.io/)
[![Java](https://img.shields.io/badge/Java-21-orange?style=flat-square)](https://adoptium.net/)
@@ -12,7 +12,7 @@
- 最低支持版本为 `Paper 1.21.11`
- 已适配 `Paper 26.2`
- 插件统一使用 Paper 公共 API 和 Java 21 字节码，无需按服务端版本拆分构建
- 配置按职责拆分：主行为与 SkinBridge、模块开关、菜单布局、维护模式和语言文本分别管理
- 配置按职责拆分：主行为与 SkinBridge、模块开关、菜单布局和语言文本分别管理
- 支持运行期模块开关，避免为不同功能组合构建多个插件版本
## 主要功能
@@ -43,12 +43,10 @@
- `/seen` `(/info)`
- `/tpsbar`
- `/essc admin` 管理模式切换
- `/maintenance` `(/maint)` 维护模式管理
### 控制台命令
- `/essc help`、`/essc version`、`/essc reload`
- `/maintenance [on|off|status|reload|add|remove|list]`，也可通过 `/essc maintenance ...` 执行
- `/seen [玩家]`、`/heal [玩家]`、`/feed [玩家]`、`/tpsbar [玩家]`
- `/essc skin [status|refresh] [玩家]`
@@ -59,7 +57,6 @@
- Shift + 右键快捷打开潜影盒
- 潜影盒交互保护，尽量避免刷物品、吞物品和嵌套放入问题
- 管理模式独立背包、装备栏与状态切换
- 维护模式：替换 MOTD、登录拦截、白名单放行和管理员拦截通知
- Enderman 掉落方块控制
## 模块配置
@@ -72,19 +69,19 @@
| `admin-mode` | 开启 | `/essc admin` 管理模式与独立状态保存 |
| `tpsbar` | 开启 | 插件版 TPSBar，检测到服务端原生命令时自动避免冲突 |
| `mob-drops` | 关闭 | 末影人掉落控制，默认关闭以保留过去标准版行为 |
| `maintenance` | 开启 | 维护模式命令、MOTD 替换、登录拦截、白名单和拦截通知 |
| `skin-bridge` | 关闭 | 查询外置 Yggdrasil profile，并通过 MineSkin 与 Paper Profile API 同步皮肤 |
修改模块开关后使用 `/essc reload` 即可刷新运行期服务、监听器和命令门禁。可选模块命令始终注册，模块关闭时会返回统一的停用提示，因此无需为了启用命令重启服务器。
## 安装说明
1. 从 [Releases](https://github.com/Coldsmiles/EssentialsC/releases) 下载所需版本。
1. 从 [Releases](https://github.com/InfstarMC/EssentialsC/releases) 下载所需版本。
2. 将插件放入服务端的 `plugins/` 目录。
3. 建议安装 LuckPerms；维护模式会优先通过其缓存异步检查登录权限，未安装时会在玩家加入后立即复核。
4. 启动一次服务端以生成配置文件。
5. 按需修改 `plugins/EssentialsC/` 下的配置文件与 `lang/` 语言文件。
6. 使用权限插件为玩家分配所需权限。
3. 启动一次服务端以生成配置文件。
4. 按需修改 `plugins/EssentialsC/` 下的配置文件与 `lang/` 语言文件。
5. 使用权限插件为玩家分配所需权限。
维护功能建议独立安装 [Maintenance](https://github.com/kennytv/Maintenance)。EssentialsC 不再内置维护模式，也不要求安装该插件。
## 配置说明
@@ -103,14 +100,6 @@ SkinBridge 默认关闭。使用前需启用 `modules.yml` 中的 `modules.skin-
- 功能模块开关
- `blocks-menu.yml`
- 便捷菜单分区、槽位、材质和权限
- `maintenance.yml`
- 维护模式状态
- 维护 MOTD
- 维护踢出提示
- 维护 BossBar
- 绕过权限
- 维护白名单
- 拦截通知权限
- `lang/zh_CN.yml`、`lang/en_US.yml`
- 命令反馈
- 帮助信息
@@ -151,13 +140,10 @@ essentialsc.tpa.bypass-cooldown
essentialsc.tpa.warmup.3
essentialsc.command.admin
essentialsc.command.tpsbar
essentialsc.command.maintenance
essentialsc.command.skin
essentialsc.command.skin.status
essentialsc.command.skin.refresh
essentialsc.command.skin.others
essentialsc.maintenance.bypass
essentialsc.maintenance.notify
essentialsc.shulkerbox.open
essentialsc.mobdrops.enderman
essentialsc.*
@@ -168,7 +154,7 @@ essentialsc.*
## 从源码构建
```bash
git clone https://github.com/Coldsmiles/EssentialsC.git
git clone https://github.com/InfstarMC/EssentialsC.git
cd EssentialsC
./gradlew build
```
@@ -216,5 +202,5 @@ IDEA 运行配置会先构建插件，再由启动脚本复制最新 JAR，并
## 仓库
- GitHub: <https://github.com/Coldsmiles/EssentialsC>
- GitHub: <https://github.com/InfstarMC/EssentialsC>
- Gitea: <https://git.infstar.cn/InfStarMC/EssentialsC>
build.gradle
+1 -2
View File
@@ -10,7 +10,7 @@ plugins {
}
group = 'cn.infstar'
def pluginVersion = providers.gradleProperty('pluginVersion').orElse('1.3.0').get()
def pluginVersion = providers.gradleProperty('pluginVersion').orElse('1.3.1').get()
version = pluginVersion
repositories {
@@ -23,7 +23,6 @@ repositories {
dependencies {
paperweight.paperDevBundle('1.21.11-R0.1-SNAPSHOT')
compileOnly 'net.luckperms:api:5.5'
implementation 'com.google.code.gson:gson:2.11.0'
testImplementation platform('org.junit:junit-bom:5.13.4')
testImplementation 'org.junit.jupiter:junit-jupiter'
paper-plugin.yml
+189
View File
@@ -0,0 +1,189 @@
name: EssentialsC
description: 高版本基础工具箱
version: 1.3.1
main: cn.infstar.essentialsC.EssentialsC
api-version: '1.21.11'
load: POSTWORLD
folia-supported: false
authors: [ Coldsmiles_7 ]
website: www.infstar.cn
permissions:
essentialsc.command.workbench:
description: 允许使用 /workbench
default: op
essentialsc.command.anvil:
description: 允许使用 /anvil
default: op
essentialsc.command.cartographytable:
description: 允许使用 /cartographytable
default: op
essentialsc.command.grindstone:
description: 允许使用 /grindstone
default: op
essentialsc.command.loom:
description: 允许使用 /loom
default: op
essentialsc.command.smithingtable:
description: 允许使用 /smithingtable
default: op
essentialsc.command.stonecutter:
description: 允许使用 /stonecutter
default: op
essentialsc.command.enderchest:
description: 允许使用 /enderchest
default: op
essentialsc.command.blocks:
description: 允许使用 /essc blocks
default: true
essentialsc.command.hat:
description: 允许使用 /hat
default: op
essentialsc.command.suicide:
description: 允许使用 /suicide
default: op
essentialsc.command.fly:
description: 允许使用 /fly
default: op
essentialsc.command.nightvision:
description: 允许使用 /nightvision
default: op
essentialsc.command.glow:
description: 允许使用 /glow
default: op
essentialsc.command.heal:
description: 允许使用 /heal
default: op
essentialsc.command.heal.others:
description: 允许治疗其他玩家
default: op
essentialsc.command.vanish:
description: 允许使用 /vanish
default: op
essentialsc.vanish.see:
description: 允许看见隐身玩家
default: op
essentialsc.command.seen:
description: 允许使用 /seen
default: op
essentialsc.command.feed:
description: 允许使用 /feed
default: op
essentialsc.command.feed.others:
description: 允许为其他玩家补充饥饿值
default: op
essentialsc.command.repair:
description: 允许使用 /repair
default: op
essentialsc.command.repair.all:
description: 允许使用 /repair all
default: op
essentialsc.command.tpa:
description: 允许发送 /tpa 请求
default: true
essentialsc.command.tpahere:
description: 允许发送 /tpahere 请求
default: true
essentialsc.command.tpaall:
description: 允许向所有玩家发送 /tpahere 请求
default: op
essentialsc.command.tpaccept:
description: 允许接受 TPA 请求
default: true
essentialsc.command.tpdeny:
description: 允许拒绝 TPA 请求
default: true
essentialsc.command.tpignore:
description: 允许切换是否忽略 TPA 请求
default: true
essentialsc.tpa.bypass-warmup:
description: 允许绕过 TPA 传送预热
default: op
essentialsc.tpa.bypass-cooldown:
description: 允许绕过 TPA 冷却
default: op
essentialsc.command.admin:
description: 允许使用 /essc admin
default: op
essentialsc.command.help:
description: 允许使用 /essc help
default: true
essentialsc.command.reload:
description: 允许使用 /essc reload
default: op
essentialsc.command.tpsbar:
description: 允许使用 /tpsbar
default: op
essentialsc.command.tpsbar.others:
description: 允许为其他玩家切换 /tpsbar
default: op
essentialsc.command.skin:
description: 允许使用 SkinBridge 管理命令
default: op
children:
essentialsc.command.skin.status: true
essentialsc.command.skin.refresh: true
essentialsc.command.skin.others: true
essentialsc.command.skin.status:
description: 允许查看 SkinBridge 状态
default: op
essentialsc.command.skin.refresh:
description: 允许强制刷新自己的皮肤
default: op
essentialsc.command.skin.others:
description: 允许查看或刷新其他玩家的皮肤
default: op
essentialsc.shulkerbox.open:
description: 允许通过 Shift+右键快捷打开潜影盒
default: op
essentialsc.mobdrops.enderman:
description: 允许控制末影人死亡时是否掉落物品
default: op
essentialsc.*:
description: 授予 EssentialsC 的全部权限
default: false
children:
essentialsc.command.workbench: true
essentialsc.command.anvil: true
essentialsc.command.cartographytable: true
essentialsc.command.grindstone: true
essentialsc.command.loom: true
essentialsc.command.smithingtable: true
essentialsc.command.stonecutter: true
essentialsc.command.enderchest: true
essentialsc.command.blocks: true
essentialsc.command.hat: true
essentialsc.command.suicide: true
essentialsc.command.fly: true
essentialsc.command.nightvision: true
essentialsc.command.glow: true
essentialsc.command.heal: true
essentialsc.command.heal.others: true
essentialsc.command.vanish: true
essentialsc.vanish.see: true
essentialsc.command.seen: true
essentialsc.command.feed: true
essentialsc.command.feed.others: true
essentialsc.command.repair: true
essentialsc.command.repair.all: true
essentialsc.command.tpa: true
essentialsc.command.tpahere: true
essentialsc.command.tpaall: true
essentialsc.command.tpaccept: true
essentialsc.command.tpdeny: true
essentialsc.command.tpignore: true
essentialsc.tpa.bypass-warmup: true
essentialsc.tpa.bypass-cooldown: true
essentialsc.command.admin: true
essentialsc.command.help: true
essentialsc.command.reload: true
essentialsc.command.tpsbar: true
essentialsc.command.tpsbar.others: true
essentialsc.command.skin: true
essentialsc.command.skin.status: true
essentialsc.command.skin.refresh: true
essentialsc.command.skin.others: true
essentialsc.shulkerbox.open: true
essentialsc.mobdrops.enderman: true
src/main/java/cn/infstar/essentialsC/EssentialsC.java
-39
View File
@@ -11,8 +11,6 @@ import cn.infstar.essentialsC.listeners.MobDropListener;
import cn.infstar.essentialsC.listeners.MobDropMenuListener;
import cn.infstar.essentialsC.listeners.ShulkerBoxListener;
import cn.infstar.essentialsC.listeners.VanishListener;
import cn.infstar.essentialsC.maintenance.MaintenanceListener;
import cn.infstar.essentialsC.maintenance.MaintenanceManager;
import cn.infstar.essentialsC.player.PlayerStateManager;
import cn.infstar.essentialsC.skinbridge.SkinBridgeManager;
import cn.infstar.essentialsC.teleport.TeleportRequestManager;
@@ -38,10 +36,8 @@ public final class EssentialsC extends JavaPlugin {
private ModuleManager moduleManager;
private FeatureConfigManager featureConfigManager;
private AdminModeManager adminModeManager;
private MaintenanceManager maintenanceManager;
private TeleportRequestManager teleportRequestManager;
private PlayerStateManager playerStateManager;
private MaintenanceListener maintenanceListener;
private TpsBarService tpsBarManager;
private ShulkerBoxListener shulkerBoxListener;
private BlocksMenuCommand blocksMenuCommandListener;
@@ -72,9 +68,6 @@ public final class EssentialsC extends JavaPlugin {
if (adminModeManager != null) {
adminModeManager.shutdown();
}
if (maintenanceManager != null) {
maintenanceManager.shutdown();
}
if (teleportRequestManager != null) {
teleportRequestManager.shutdown();
}
@@ -111,10 +104,6 @@ public final class EssentialsC extends JavaPlugin {
return featureConfigManager;
}
public MaintenanceManager getMaintenanceManager() {
return maintenanceManager;
}
public TeleportRequestManager getTeleportRequestManager() {
return teleportRequestManager;
}
@@ -135,7 +124,6 @@ public final class EssentialsC extends JavaPlugin {
moduleStatus.clear();
refreshCorePlayerFeatures();
refreshAdminMode();
refreshMaintenance();
refreshTpsBar();
refreshBlocks();
refreshMobDrops();
@@ -179,32 +167,6 @@ public final class EssentialsC extends JavaPlugin {
setModuleStatus("管理模式", true, "监听器已注册");
}
private void refreshMaintenance() {
if (!moduleManager.isEnabled(ModuleManager.MAINTENANCE)) {
if (maintenanceManager != null) {
maintenanceManager.shutdown();
maintenanceManager = null;
}
if (maintenanceListener != null) {
HandlerList.unregisterAll(maintenanceListener);
maintenanceListener = null;
}
setModuleStatus("维护模式", false, "已禁用");
return;
}
if (maintenanceManager == null) {
maintenanceManager = new MaintenanceManager(this);
} else {
maintenanceManager.reload();
}
if (maintenanceListener == null) {
maintenanceListener = new MaintenanceListener(this, maintenanceManager);
getServer().getPluginManager().registerEvents(maintenanceListener, this);
}
setModuleStatus("维护模式", true, maintenanceManager.isEnabled() ? "当前开启" : "当前关闭");
}
private void refreshTpsBar() {
if (!moduleManager.isEnabled(ModuleManager.TPSBAR)) {
if (tpsBarManager != null) {
@@ -313,7 +275,6 @@ public final class EssentialsC extends JavaPlugin {
private void unregisterRuntimeListeners() {
unregisterListener(adminModeManager);
unregisterListener(maintenanceListener);
unregisterListener(shulkerBoxListener);
unregisterListener(blocksMenuCommandListener);
unregisterListener(mobDropListener);
src/main/java/cn/infstar/essentialsC/ModuleManager.java
+10 -8
View File
@@ -19,7 +19,6 @@ public final class ModuleManager {
public static final String ADMIN_MODE = "admin-mode";
public static final String TPSBAR = "tpsbar";
public static final String MOB_DROPS = "mob-drops";
public static final String MAINTENANCE = "maintenance";
public static final String SKIN_BRIDGE = "skin-bridge";
private static final Map<String, Boolean> DEFAULT_MODULES = new LinkedHashMap<>();
@@ -29,7 +28,6 @@ public final class ModuleManager {
DEFAULT_MODULES.put(ADMIN_MODE, true);
DEFAULT_MODULES.put(TPSBAR, true);
DEFAULT_MODULES.put(MOB_DROPS, false);
DEFAULT_MODULES.put(MAINTENANCE, true);
DEFAULT_MODULES.put(SKIN_BRIDGE, false);
}
@@ -57,21 +55,25 @@ public final class ModuleManager {
throw new IllegalStateException("无法加载 modules.yml，请修复配置格式后重试。", exception);
}
modulesConfig = loaded;
boolean removedJeiSync = modulesConfig.contains("modules.jei-sync", true);
if (removedJeiSync) {
modulesConfig.set("modules.jei-sync", null);
boolean removedRetiredModules = false;
for (String retiredModule : new String[]{"jei-sync", "maintenance"}) {
String retiredPath = "modules." + retiredModule;
if (modulesConfig.contains(retiredPath, true)) {
modulesConfig.set(retiredPath, null);
removedRetiredModules = true;
}
}
modulesConfig.addDefault("config-version", CURRENT_CONFIG_VERSION);
for (Map.Entry<String, Boolean> module : DEFAULT_MODULES.entrySet()) {
modulesConfig.addDefault(path(module.getKey()), module.getValue());
}
modulesConfig.options().copyDefaults(true);
if (removedJeiSync) {
if (removedRetiredModules) {
try {
AtomicYamlWriter.save(modulesConfig, modulesFile);
plugin.getLogger().info("已从 modules.yml 移除停用的 JEI 配方同步配置。");
plugin.getLogger().info("已从 modules.yml 移除退役功能的配置项。");
} catch (IOException exception) {
plugin.getLogger().warning("清理 modules.yml 中的 JEI 配置失败: " + exception.getMessage());
plugin.getLogger().warning("清理 modules.yml 中的退役配置失败: " + exception.getMessage());
}
}
}
src/main/java/cn/infstar/essentialsC/commands/CommandRegistry.java
-1
View File
@@ -48,7 +48,6 @@ public final class CommandRegistry {
registerCore("tpignore", "essentialsc.command.tpignore", TpIgnoreCommand::new);
register("tpsbar", "essentialsc.command.tpsbar", ModuleManager.TPSBAR, TpsBarCommand::new);
register("mobdrops", "essentialsc.mobdrops.enderman", ModuleManager.MOB_DROPS, MobDropCommand::new);
register("maintenance", "essentialsc.command.maintenance", ModuleManager.MAINTENANCE, MaintenanceCommand::new, "maint");
registerSubCommand("admin", "essentialsc.command.admin", ModuleManager.ADMIN_MODE, AdminCommand::new);
registerSubCommand("skin", "essentialsc.command.skin", ModuleManager.SKIN_BRIDGE, SkinBridgeCommand::new);
}
src/main/java/cn/infstar/essentialsC/commands/HelpCommand.java
-24
View File
@@ -104,10 +104,6 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
if (CommandRegistry.isAvailable("tpsbar") && sender.hasPermission("essentialsc.command.tpsbar")) {
sendPrefixed(sender, lang.getString("help.commands.tpsbar"));
}
if (CommandRegistry.isAvailable("maintenance")
&& sender.hasPermission("essentialsc.command.maintenance")) {
sendPrefixed(sender, lang.getString("help.commands.maintenance"));
}
sender.sendMessage("");
sendPrefixed(sender, lang.getString("help.footer"));
}
@@ -282,10 +278,6 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
otherCommands.append(lang.getString("help.commands.tpsbar")).append("\n");
hasOtherCommands = true;
}
if (CommandRegistry.isAvailable("maintenance") && player.hasPermission("essentialsc.command.maintenance")) {
otherCommands.append(lang.getString("help.commands.maintenance")).append("\n");
hasOtherCommands = true;
}
if (hasOtherCommands) {
sendPrefixed(player, lang.getString("help.section-other"));
@@ -367,8 +359,6 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
{"tpignore", "essentialsc.command.tpignore"},
{"skin", "essentialsc.command.skin"},
{"tpsbar", "essentialsc.command.tpsbar"},
{"maintenance", "essentialsc.command.maintenance"},
{"maint", "essentialsc.command.maintenance"},
{"mobdrops", "essentialsc.mobdrops.enderman"},
{"admin", "essentialsc.command.admin"},
{"version", null},
@@ -451,10 +441,6 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
return players;
}
if ((subCmd.equals("maintenance") || subCmd.equals("maint"))
&& sender.hasPermission("essentialsc.command.maintenance")) {
return completeMaintenanceArgs(args[1]);
}
}
if (args.length == 3 && args[0].equalsIgnoreCase("skin")
@@ -499,14 +485,4 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
return completions;
}
private List<String> completeMaintenanceArgs(String partialInput) {
List<String> completions = new ArrayList<>();
String partial = partialInput.toLowerCase();
for (String option : List.of("on", "off", "status", "reload", "add", "remove", "list")) {
if (option.startsWith(partial)) {
completions.add(option);
}
}
return completions;
}
}
src/main/java/cn/infstar/essentialsC/commands/MaintenanceCommand.java
-179
View File
@@ -1,179 +0,0 @@
package cn.infstar.essentialsC.commands;
import cn.infstar.essentialsC.maintenance.MaintenanceManager;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.command.TabCompleter;
import org.bukkit.entity.Player;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Map;
public class MaintenanceCommand extends BaseCommand implements TabCompleter {
public MaintenanceCommand() {
super("essentialsc.command.maintenance");
}
@Override
protected boolean execute(Player player, String[] args) {
return executeCommand(player, args);
}
@Override
protected boolean executeConsole(CommandSender sender, String[] args) {
return executeCommand(sender, args);
}
private boolean executeCommand(CommandSender sender, String[] args) {
MaintenanceManager maintenanceManager = plugin.getMaintenanceManager();
if (maintenanceManager == null) {
sender.sendMessage(getLang().getPrefixedString("messages.module-disabled"));
return true;
}
if (args.length == 0 || args[0].equalsIgnoreCase("status")) {
sendStatus(sender, maintenanceManager);
return true;
}
switch (args[0].toLowerCase(Locale.ROOT)) {
case "on", "enable", "enabled" -> {
if (maintenanceManager.setEnabled(true) == MaintenanceManager.OperationResult.SAVE_FAILED) {
sendSaveFailed(sender);
return true;
}
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.enabled"));
return true;
}
case "off", "disable", "disabled" -> {
if (maintenanceManager.setEnabled(false) == MaintenanceManager.OperationResult.SAVE_FAILED) {
sendSaveFailed(sender);
return true;
}
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.disabled"));
return true;
}
case "reload" -> {
maintenanceManager.reload();
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.reloaded"));
return true;
}
case "add" -> {
if (args.length < 2) {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.add-usage"));
return true;
}
String target = args[1];
MaintenanceManager.OperationResult result = maintenanceManager.addWhitelistEntry(target);
if (result == MaintenanceManager.OperationResult.SAVE_FAILED) {
sendSaveFailed(sender);
} else if (result == MaintenanceManager.OperationResult.SUCCESS) {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-added",
Map.of("player", target)));
} else {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-exists",
Map.of("player", target)));
}
return true;
}
case "remove" -> {
if (args.length < 2) {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.remove-usage"));
return true;
}
String target = args[1];
MaintenanceManager.OperationResult result = maintenanceManager.removeWhitelistEntry(target);
if (result == MaintenanceManager.OperationResult.SAVE_FAILED) {
sendSaveFailed(sender);
} else if (result == MaintenanceManager.OperationResult.SUCCESS) {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-removed",
Map.of("player", target)));
} else {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-missing",
Map.of("player", target)));
}
return true;
}
case "list" -> {
sendWhitelist(sender, maintenanceManager);
return true;
}
default -> {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.usage"));
return true;
}
}
}
private void sendStatus(CommandSender sender, MaintenanceManager maintenanceManager) {
String status = getLang().getString(maintenanceManager.isEnabled()
? "maintenance.status.enabled"
: "maintenance.status.disabled");
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.status",
Map.of(
"status", status,
"whitelist_count", String.valueOf(maintenanceManager.getWhitelistCount())
)));
}
private void sendWhitelist(CommandSender sender, MaintenanceManager maintenanceManager) {
List<String> entries = maintenanceManager.getWhitelistEntries();
if (entries.isEmpty()) {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-empty"));
return;
}
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-list",
Map.of(
"count", String.valueOf(entries.size()),
"entries", String.join(", ", entries)
)));
}
private void sendSaveFailed(CommandSender sender) {
sender.sendMessage(getLang().getPrefixedString("maintenance.messages.save-failed"));
}
@Override
public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
if (!sender.hasPermission(getPermission())) {
return List.of();
}
if (args.length == 1) {
return complete(args[0], List.of("on", "off", "status", "reload", "add", "remove", "list"));
}
if (args.length == 2 && args[0].equalsIgnoreCase("add")) {
return complete(args[1], plugin.getServer().getOnlinePlayers().stream()
.map(Player::getName)
.toList());
}
if (args.length == 2 && args[0].equalsIgnoreCase("remove")) {
MaintenanceManager maintenanceManager = plugin.getMaintenanceManager();
if (maintenanceManager == null) {
return List.of();
}
return complete(args[1], maintenanceManager.getWhitelistEntries());
}
return List.of();
}
private List<String> complete(String input, List<String> options) {
String partial = input.toLowerCase(Locale.ROOT);
List<String> completions = new ArrayList<>();
for (String option : options) {
if (option.toLowerCase(Locale.ROOT).startsWith(partial)) {
completions.add(option);
}
}
return completions;
}
}
src/main/java/cn/infstar/essentialsC/maintenance/LuckPermsMaintenancePermissionResolver.java
-56
View File
@@ -1,56 +0,0 @@
package cn.infstar.essentialsC.maintenance;
import cn.infstar.essentialsC.EssentialsC;
import net.luckperms.api.LuckPerms;
import net.luckperms.api.model.user.User;
import net.luckperms.api.model.user.UserManager;
import net.luckperms.api.query.QueryOptions;
import java.util.UUID;
import java.util.concurrent.atomic.AtomicBoolean;
public final class LuckPermsMaintenancePermissionResolver implements MaintenancePermissionResolver {
private final EssentialsC plugin;
private final LuckPerms luckPerms;
private final UserManager userManager;
private final AtomicBoolean failureLogged = new AtomicBoolean();
public LuckPermsMaintenancePermissionResolver(EssentialsC plugin) {
this.plugin = plugin;
this.luckPerms = plugin.getServer().getServicesManager().load(LuckPerms.class);
if (luckPerms == null) {
throw new IllegalStateException("LuckPerms 服务尚未注册");
}
this.userManager = luckPerms.getUserManager();
}
@Override
public PermissionResult checkPermission(UUID uniqueId, String permission) {
if (uniqueId == null || permission == null || permission.isBlank()) {
return PermissionResult.DENIED;
}
try {
User user = userManager.getUser(uniqueId);
if (user == null) {
user = userManager.loadUser(uniqueId).join();
}
QueryOptions queryOptions = luckPerms.getContextManager().getQueryOptions(user)
.orElseGet(() -> luckPerms.getContextManager().getStaticQueryOptions());
boolean granted = user.getCachedData()
.getPermissionData(queryOptions)
.checkPermission(permission)
.asBoolean();
failureLogged.set(false);
return granted ? PermissionResult.GRANTED : PermissionResult.DENIED;
} catch (RuntimeException exception) {
if (failureLogged.compareAndSet(false, true)) {
plugin.getLogger().warning("LuckPerms 维护权限查询失败，将在玩家加入后复核权限: "
+ exception.getMessage());
}
return PermissionResult.UNAVAILABLE;
}
}
}
src/main/java/cn/infstar/essentialsC/maintenance/MaintenanceListener.java
-113
View File
@@ -1,113 +0,0 @@
package cn.infstar.essentialsC.maintenance;
import cn.infstar.essentialsC.EssentialsC;
import cn.infstar.essentialsC.ModuleManager;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener;
import org.bukkit.event.player.AsyncPlayerPreLoginEvent;
import org.bukkit.event.player.PlayerJoinEvent;
import org.bukkit.event.player.PlayerQuitEvent;
import org.bukkit.event.server.ServerListPingEvent;
import java.net.InetAddress;
import java.net.InetSocketAddress;
import java.util.Map;
public final class MaintenanceListener implements Listener {
private final EssentialsC plugin;
private final MaintenanceManager maintenanceManager;
private final MaintenancePermissionResolver permissionResolver;
public MaintenanceListener(EssentialsC plugin, MaintenanceManager maintenanceManager) {
this.plugin = plugin;
this.maintenanceManager = maintenanceManager;
this.permissionResolver = MaintenancePermissionResolverFactory.create(plugin);
}
@EventHandler
public void onServerListPing(ServerListPingEvent event) {
if (!plugin.getModuleManager().isEnabled(ModuleManager.MAINTENANCE)
|| !maintenanceManager.isEnabled()
|| !maintenanceManager.isMotdEnabled()) {
return;
}
event.motd(maintenanceManager.getMotd());
}
@EventHandler(priority = EventPriority.HIGHEST)
public void onPlayerPreLogin(AsyncPlayerPreLoginEvent event) {
if (event.getLoginResult() != AsyncPlayerPreLoginEvent.Result.ALLOWED) {
return;
}
MaintenanceManager.AccessSnapshot snapshot = maintenanceManager.getAccessSnapshot();
if (!snapshot.enabled()
|| snapshot.isWhitelisted(event.getUniqueId(), event.getName())
|| maintenanceManager.isOperator(event.getUniqueId())) {
return;
}
if (permissionResolver == null) {
return;
}
MaintenancePermissionResolver.PermissionResult permissionResult = permissionResolver
.checkPermission(event.getUniqueId(), snapshot.bypassPermission());
if (permissionResult != MaintenancePermissionResolver.PermissionResult.DENIED) {
return;
}
event.disallow(AsyncPlayerPreLoginEvent.Result.KICK_OTHER, snapshot.kickMessage());
notifyBlockedLogin(event.getName(), event.getUniqueId().toString(), event.getAddress(), snapshot);
}
@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
if (!plugin.getModuleManager().isEnabled(ModuleManager.MAINTENANCE)) {
return;
}
Player player = event.getPlayer();
if (maintenanceManager.isEnabled() && !maintenanceManager.canJoin(player)) {
MaintenanceManager.AccessSnapshot snapshot = maintenanceManager.getAccessSnapshot();
player.kick(snapshot.kickMessage());
InetSocketAddress socketAddress = player.getAddress();
notifyBlockedLogin(player.getName(), player.getUniqueId().toString(),
socketAddress == null ? null : socketAddress.getAddress(), snapshot);
return;
}
maintenanceManager.addBossBarPlayer(player);
}
@EventHandler
public void onPlayerQuit(PlayerQuitEvent event) {
maintenanceManager.removeBossBarPlayer(event.getPlayer());
}
private void notifyBlockedLogin(String playerName, String uniqueId, InetAddress inetAddress,
MaintenanceManager.AccessSnapshot snapshot) {
if (!snapshot.notifyEnabled()) {
return;
}
String visibleAddress = snapshot.includeAddress() && inetAddress != null ? inetAddress.getHostAddress() : null;
plugin.getServer().getScheduler().runTask(plugin, () -> {
String address = visibleAddress == null
? EssentialsC.getLangManager().getString("maintenance.status.address-hidden")
: visibleAddress;
var message = EssentialsC.getLangManager().getPrefixedComponent("maintenance.messages.login-blocked",
Map.of("player", playerName, "uuid", uniqueId, "address", address));
for (Player onlinePlayer : plugin.getServer().getOnlinePlayers()) {
if (onlinePlayer.hasPermission(snapshot.notifyPermission())) {
onlinePlayer.sendMessage(message);
}
}
});
}
}
src/main/java/cn/infstar/essentialsC/maintenance/MaintenanceManager.java
-461
View File
@@ -1,461 +0,0 @@
package cn.infstar.essentialsC.maintenance;
import cn.infstar.essentialsC.EssentialsC;
import cn.infstar.essentialsC.util.AtomicYamlWriter;
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer;
import org.bukkit.Bukkit;
import org.bukkit.boss.BarColor;
import org.bukkit.boss.BarStyle;
import org.bukkit.boss.BossBar;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.configuration.InvalidConfigurationException;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.entity.Player;
import org.bukkit.scheduler.BukkitTask;
import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;
import java.util.UUID;
public final class MaintenanceManager {
private static final int CURRENT_CONFIG_VERSION = 1;
private static final LegacyComponentSerializer LEGACY_AMPERSAND = LegacyComponentSerializer.legacyAmpersand();
private static final LegacyComponentSerializer LEGACY_SECTION = LegacyComponentSerializer.legacySection();
private final EssentialsC plugin;
private final File configFile;
private final BukkitTask operatorCacheTask;
private FileConfiguration config;
private BossBar bossBar;
private volatile AccessSnapshot accessSnapshot = AccessSnapshot.disabled();
private volatile Set<UUID> operatorUuids = Set.of();
public MaintenanceManager(EssentialsC plugin) {
this.plugin = plugin;
this.configFile = new File(plugin.getDataFolder(), "maintenance.yml");
refreshOperatorCache();
this.operatorCacheTask = plugin.getServer().getScheduler()
.runTaskTimer(plugin, this::refreshOperatorCache, 20L, 20L);
reload();
}
public void reload() {
if (!configFile.exists()) {
plugin.saveResource("maintenance.yml", false);
}
config = loadConfiguration();
config.addDefault("config-version", CURRENT_CONFIG_VERSION);
config.addDefault("enabled", false);
config.addDefault("bypass-permission", "essentialsc.maintenance.bypass");
config.addDefault("notify.enabled", true);
config.addDefault("notify.permission", "essentialsc.maintenance.notify");
config.addDefault("notify.include-address", false);
config.addDefault("whitelist.uuids", List.of());
config.addDefault("whitelist.names", List.of());
config.addDefault("motd.enabled", true);
config.addDefault("motd.lines", List.of("&c服务器维护中", "&7请稍后再试"));
config.addDefault("kick-message", List.of("&c服务器正在维护", "&7请稍后再进入"));
config.addDefault("bossbar.enabled", true);
config.addDefault("bossbar.title", "&c服务器正在维护");
config.addDefault("bossbar.color", "RED");
config.addDefault("bossbar.style", "SOLID");
config.addDefault("bossbar.progress", 1.0D);
config.options().copyDefaults(true);
publishAccessSnapshot();
refreshBossBar();
if (isEnabled()) {
kickUnauthorizedPlayers();
}
}
public boolean isEnabled() {
return config.getBoolean("enabled", false);
}
public OperationResult setEnabled(boolean enabled) {
if (isEnabled() == enabled) {
return OperationResult.UNCHANGED;
}
boolean previous = isEnabled();
config.set("enabled", enabled);
if (!save()) {
config.set("enabled", previous);
return OperationResult.SAVE_FAILED;
}
publishAccessSnapshot();
refreshBossBar();
if (enabled) {
kickUnauthorizedPlayers();
}
return OperationResult.SUCCESS;
}
public String getBypassPermission() {
return config.getString("bypass-permission", "essentialsc.maintenance.bypass");
}
public boolean isNotifyEnabled() {
return config.getBoolean("notify.enabled", true);
}
public String getNotifyPermission() {
return config.getString("notify.permission", "essentialsc.maintenance.notify");
}
public boolean shouldIncludeAddressInNotification() {
return config.getBoolean("notify.include-address", false);
}
public boolean canJoin(Player player) {
return player != null && (player.isOp() || player.hasPermission(getBypassPermission()) || isWhitelisted(player));
}
public boolean isOperator(UUID uniqueId) {
return uniqueId != null && operatorUuids.contains(uniqueId);
}
public AccessSnapshot getAccessSnapshot() {
return accessSnapshot;
}
public boolean isWhitelisted(Player player) {
if (player == null) {
return false;
}
return getWhitelistUuids().contains(player.getUniqueId().toString().toLowerCase(Locale.ROOT))
|| getWhitelistNames().contains(normalizeName(player.getName()));
}
public OperationResult addWhitelistEntry(String input) {
String normalized = normalizeEntry(input);
if (normalized.isEmpty()) {
return OperationResult.UNCHANGED;
}
UUID uuid = parseUuid(normalized);
if (uuid != null) {
return addWhitelistUuid(uuid.toString());
}
Player onlinePlayer = Bukkit.getPlayerExact(normalized);
if (onlinePlayer != null) {
return addWhitelistUuid(onlinePlayer.getUniqueId().toString());
}
return addWhitelistName(input);
}
public OperationResult removeWhitelistEntry(String input) {
String normalized = normalizeEntry(input);
if (normalized.isEmpty()) {
return OperationResult.UNCHANGED;
}
UUID uuid = parseUuid(normalized);
if (uuid != null) {
return removeWhitelistUuid(uuid.toString());
}
Player onlinePlayer = Bukkit.getPlayerExact(normalized);
if (onlinePlayer != null) {
OperationResult uuidResult = removeWhitelistUuid(onlinePlayer.getUniqueId().toString());
if (uuidResult != OperationResult.UNCHANGED) {
return uuidResult;
}
}
return removeWhitelistName(input);
}
public List<String> getWhitelistEntries() {
List<String> entries = new ArrayList<>();
entries.addAll(getWhitelistNames());
entries.addAll(getWhitelistUuids());
return entries;
}
public int getWhitelistCount() {
return getWhitelistEntries().size();
}
public boolean isMotdEnabled() {
return config.getBoolean("motd.enabled", true);
}
public Component getMotd() {
return colorizeLines(config.getStringList("motd.lines"));
}
public Component getKickMessage() {
return colorizeLines(config.getStringList("kick-message"));
}
public void refreshBossBar() {
clearBossBar();
if (!isEnabled() || !isBossBarEnabled()) {
return;
}
bossBar = plugin.getServer().createBossBar(
LEGACY_SECTION.serialize(colorize(config.getString("bossbar.title", "&c服务器正在维护"))),
readBossBarColor(),
readBossBarStyle()
);
bossBar.setProgress(readBossBarProgress());
bossBar.setVisible(true);
for (Player player : plugin.getServer().getOnlinePlayers()) {
addBossBarPlayer(player);
}
}
public void addBossBarPlayer(Player player) {
if (bossBar == null || player == null || !player.isOnline()) {
return;
}
bossBar.addPlayer(player);
}
public void removeBossBarPlayer(Player player) {
if (bossBar != null && player != null) {
bossBar.removePlayer(player);
}
}
private void kickUnauthorizedPlayers() {
Component message = getKickMessage();
for (Player player : List.copyOf(plugin.getServer().getOnlinePlayers())) {
if (!canJoin(player)) {
player.kick(message);
}
}
}
public void shutdown() {
operatorCacheTask.cancel();
accessSnapshot = AccessSnapshot.disabled();
operatorUuids = Set.of();
clearBossBar();
}
private void refreshOperatorCache() {
Set<UUID> operators = new LinkedHashSet<>();
for (org.bukkit.OfflinePlayer operator : plugin.getServer().getOperators()) {
operators.add(operator.getUniqueId());
}
operatorUuids = Set.copyOf(operators);
}
private void clearBossBar() {
if (bossBar == null) {
return;
}
bossBar.removeAll();
bossBar = null;
}
private boolean isBossBarEnabled() {
return config.getBoolean("bossbar.enabled", true);
}
private BarColor readBossBarColor() {
try {
return BarColor.valueOf(config.getString("bossbar.color", "RED").toUpperCase(Locale.ROOT));
} catch (IllegalArgumentException ignored) {
return BarColor.RED;
}
}
private BarStyle readBossBarStyle() {
try {
return BarStyle.valueOf(config.getString("bossbar.style", "SOLID").toUpperCase(Locale.ROOT));
} catch (IllegalArgumentException ignored) {
return BarStyle.SOLID;
}
}
private double readBossBarProgress() {
double progress = config.getDouble("bossbar.progress", 1.0D);
if (!Double.isFinite(progress)) {
return 1.0D;
}
return Math.max(0.0D, Math.min(1.0D, progress));
}
private OperationResult addWhitelistUuid(String uuid) {
return updateWhitelist("whitelist.uuids", uuid.toLowerCase(Locale.ROOT), true);
}
private OperationResult addWhitelistName(String name) {
return updateWhitelist("whitelist.names", normalizeName(name), true);
}
private OperationResult removeWhitelistUuid(String uuid) {
return updateWhitelist("whitelist.uuids", uuid.toLowerCase(Locale.ROOT), false);
}
private OperationResult removeWhitelistName(String name) {
return updateWhitelist("whitelist.names", normalizeName(name), false);
}
private OperationResult updateWhitelist(String path, String value, boolean add) {
if (value == null || value.isBlank()) {
return OperationResult.UNCHANGED;
}
List<String> previousEntries = new ArrayList<>(config.getStringList(path));
Set<String> entries = path.endsWith(".names") ? getWhitelistNames() : getWhitelistUuids();
boolean changed;
if (add) {
changed = entries.add(value);
} else {
changed = entries.remove(value);
}
if (!changed) {
return OperationResult.UNCHANGED;
}
config.set(path, new ArrayList<>(entries));
if (!save()) {
config.set(path, previousEntries);
return OperationResult.SAVE_FAILED;
}
publishAccessSnapshot();
refreshBossBar();
if (isEnabled()) {
kickUnauthorizedPlayers();
}
return OperationResult.SUCCESS;
}
private Set<String> getWhitelistUuids() {
Set<String> entries = new LinkedHashSet<>();
for (String value : config.getStringList("whitelist.uuids")) {
String normalized = normalizeEntry(value).toLowerCase(Locale.ROOT);
if (!normalized.isEmpty()) {
entries.add(normalized);
}
}
return entries;
}
private Set<String> getWhitelistNames() {
Set<String> entries = new LinkedHashSet<>();
for (String value : config.getStringList("whitelist.names")) {
String normalized = normalizeName(value);
if (!normalized.isEmpty()) {
entries.add(normalized);
}
}
return entries;
}
private UUID parseUuid(String input) {
try {
return UUID.fromString(input);
} catch (IllegalArgumentException ignored) {
return null;
}
}
private String normalizeEntry(String input) {
return input == null ? "" : input.trim();
}
private String normalizeName(String input) {
return normalizeEntry(input).toLowerCase(Locale.ROOT);
}
private Component colorizeLines(List<String> lines) {
if (lines == null || lines.isEmpty()) {
return Component.empty();
}
return colorize(String.join("\n", lines));
}
private Component colorize(String text) {
return LEGACY_AMPERSAND.deserialize(text == null ? "" : text);
}
private void publishAccessSnapshot() {
Set<UUID> whitelistUuids = new LinkedHashSet<>();
for (String value : getWhitelistUuids()) {
UUID uuid = parseUuid(value);
if (uuid != null) {
whitelistUuids.add(uuid);
}
}
accessSnapshot = new AccessSnapshot(
isEnabled(),
getBypassPermission(),
whitelistUuids,
getWhitelistNames(),
getKickMessage(),
isNotifyEnabled(),
getNotifyPermission(),
shouldIncludeAddressInNotification()
);
}
private boolean save() {
try {
AtomicYamlWriter.save(config, configFile);
return true;
} catch (Exception e) {
plugin.getLogger().warning("保存 maintenance.yml 失败: " + e.getMessage());
return false;
}
}
private YamlConfiguration loadConfiguration() {
YamlConfiguration loaded = new YamlConfiguration();
loaded.options().parseComments(true);
try {
loaded.load(configFile);
} catch (IOException | InvalidConfigurationException exception) {
plugin.getLogger().severe("加载 maintenance.yml 失败: " + exception.getMessage());
throw new IllegalStateException("无法加载 maintenance.yml，请修复配置格式后重试。", exception);
}
return loaded;
}
public record AccessSnapshot(boolean enabled, String bypassPermission, Set<UUID> whitelistUuids,
Set<String> whitelistNames, Component kickMessage, boolean notifyEnabled,
String notifyPermission, boolean includeAddress) {
public AccessSnapshot {
bypassPermission = bypassPermission == null ? "" : bypassPermission;
whitelistUuids = Set.copyOf(whitelistUuids);
whitelistNames = Set.copyOf(whitelistNames);
kickMessage = kickMessage == null ? Component.empty() : kickMessage;
notifyPermission = notifyPermission == null ? "" : notifyPermission;
}
public boolean isWhitelisted(UUID uniqueId, String playerName) {
return whitelistUuids.contains(uniqueId)
|| whitelistNames.contains(playerName == null ? "" : playerName.trim().toLowerCase(Locale.ROOT));
}
private static AccessSnapshot disabled() {
return new AccessSnapshot(false, "", Set.of(), Set.of(), Component.empty(), false, "", false);
}
}
public enum OperationResult {
SUCCESS,
UNCHANGED,
SAVE_FAILED
}
}
src/main/java/cn/infstar/essentialsC/maintenance/MaintenancePermissionResolver.java
-14
View File
@@ -1,14 +0,0 @@
package cn.infstar.essentialsC.maintenance;
import java.util.UUID;
public interface MaintenancePermissionResolver {
PermissionResult checkPermission(UUID uniqueId, String permission);
enum PermissionResult {
GRANTED,
DENIED,
UNAVAILABLE
}
}
src/main/java/cn/infstar/essentialsC/maintenance/MaintenancePermissionResolverFactory.java
-35
View File
@@ -1,35 +0,0 @@
package cn.infstar.essentialsC.maintenance;
import cn.infstar.essentialsC.EssentialsC;
import org.bukkit.plugin.Plugin;
import java.lang.reflect.InvocationTargetException;
final class MaintenancePermissionResolverFactory {
private static final String LUCKPERMS_RESOLVER_CLASS =
"cn.infstar.essentialsC.maintenance.LuckPermsMaintenancePermissionResolver";
private MaintenancePermissionResolverFactory() {
}
static MaintenancePermissionResolver create(EssentialsC plugin) {
Plugin luckPerms = plugin.getServer().getPluginManager().getPlugin("LuckPerms");
if (luckPerms == null || !luckPerms.isEnabled()) {
plugin.getLogger().info("未检测到 LuckPerms，维护模式将在玩家加入后复核绕过权限。");
return null;
}
try {
Class<?> resolverClass = Class.forName(LUCKPERMS_RESOLVER_CLASS, true, plugin.getClass().getClassLoader());
return (MaintenancePermissionResolver) resolverClass
.getConstructor(EssentialsC.class)
.newInstance(plugin);
} catch (ClassNotFoundException | NoSuchMethodException | InstantiationException
| IllegalAccessException | InvocationTargetException | LinkageError exception) {
plugin.getLogger().warning("LuckPerms 维护权限解析器初始化失败，将在玩家加入后复核权限: "
+ exception.getMessage());
return null;
}
}
}
src/main/resources/config.yml
+1 -1
View File
@@ -1,5 +1,5 @@
# EssentialsC 主配置
# 其他配置：modules.yml、maintenance.yml、blocks-menu.yml
# 其他配置：modules.yml、blocks-menu.yml
# 消息与颜色：lang/<语言>.yml
# 修改后使用 /essc reload 重载；命令注册状态发生变化时建议重启服务器。
src/main/resources/lang/en_US.yml
-23
View File
@@ -107,7 +107,6 @@ help:
skin: '<white>/essc skin [status|refresh] [player]</white> <gray>- View or refresh SkinBridge status</gray>'
admin: '<white>/essc admin</white> <gray>- Toggle admin mode</gray>'
tpsbar: '<white>/tpsbar [player]</white> <gray>- Toggle TPS boss bar</gray>'
maintenance: '<white>/maintenance [on|off|status|reload|add|remove|list]</white> <gray>- Manage maintenance mode</gray>'
tpa:
messages:
@@ -259,25 +258,3 @@ mobdrops-menu:
name: '<#00FB9A>Enderman Drops</#00FB9A>'
status: '<gray>Current status: {status}</gray>'
toggle: '<gray>Click to toggle</gray>'
maintenance:
status:
enabled: '<#FF7E5E>Enabled</#FF7E5E>'
disabled: '<#00FB9A>Disabled</#00FB9A>'
address-hidden: 'hidden'
messages:
enabled: '<#00FB9A>Maintenance mode enabled.</#00FB9A>'
disabled: '<#FF7E5E>Maintenance mode disabled.</#FF7E5E>'
reloaded: '<#00FB9A>Maintenance configuration reloaded.</#00FB9A>'
save-failed: '<#FF3300>Error:</#FF3300> <#FF7E5E>Failed to save maintenance configuration; no changes were applied.</#FF7E5E>'
status: '<gray>Maintenance mode status: {status} | Whitelist: <white>{whitelist_count}</white></gray>'
usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /maintenance [on|off|status|reload|add|remove|list]</#FF7E5E>'
add-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /maintenance add [player|uuid]</#FF7E5E>'
remove-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /maintenance remove [player|uuid]</#FF7E5E>'
whitelist-added: '<#00FB9A>Added {player} to the maintenance whitelist.</#00FB9A>'
whitelist-removed: '<#00FB9A>Removed {player} from the maintenance whitelist.</#00FB9A>'
whitelist-exists: '<#FFC43B>{player} is already on the maintenance whitelist.</#FFC43B>'
whitelist-missing: '<#FF3300>Error:</#FF3300> <#FF7E5E>{player} is not on the maintenance whitelist.</#FF7E5E>'
whitelist-empty: '<gray>The maintenance whitelist is empty.</gray>'
whitelist-list: '<gray>Maintenance whitelist ({count}): <white>{entries}</white></gray>'
login-blocked: '<#FFC43B>{player} was blocked by maintenance mode.</#FFC43B> <gray>UUID: {uuid} | IP: {address}</gray>'
src/main/resources/lang/zh_CN.yml
-23
View File
@@ -107,7 +107,6 @@ help:
skin: '<white>/essc skin [status|refresh] [玩家]</white> <gray>- 查看或刷新皮肤桥接状态</gray>'
admin: '<white>/essc admin</white> <gray>- 切换管理模式</gray>'
tpsbar: '<white>/tpsbar [玩家]</white> <gray>- 切换 TPS 状态栏</gray>'
maintenance: '<white>/maintenance [on|off|status|reload|add|remove|list]</white> <gray>- 管理维护模式</gray>'
tpa:
messages:
@@ -259,25 +258,3 @@ mobdrops-menu:
name: '<#00FB9A>末影人掉落</#00FB9A>'
status: '<gray>当前状态: {status}</gray>'
toggle: '<gray>点击切换</gray>'
maintenance:
status:
enabled: '<#FF7E5E>开启</#FF7E5E>'
disabled: '<#00FB9A>关闭</#00FB9A>'
address-hidden: '已隐藏'
messages:
enabled: '<#00FB9A>维护模式已开启.</#00FB9A>'
disabled: '<#FF7E5E>维护模式已关闭.</#FF7E5E>'
reloaded: '<#00FB9A>维护模式配置已重载.</#00FB9A>'
save-failed: '<#FF3300>错误:</#FF3300> <#FF7E5E>维护模式配置保存失败，操作未生效.</#FF7E5E>'
status: '<gray>维护模式当前状态: {status} | 白名单: <white>{whitelist_count}</white></gray>'
usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /maintenance [on|off|status|reload|add|remove|list]</#FF7E5E>'
add-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /maintenance add [玩家|UUID]</#FF7E5E>'
remove-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /maintenance remove [玩家|UUID]</#FF7E5E>'
whitelist-added: '<#00FB9A>已将 {player} 加入维护白名单.</#00FB9A>'
whitelist-removed: '<#00FB9A>已将 {player} 移出维护白名单.</#00FB9A>'
whitelist-exists: '<#FFC43B>{player} 已在维护白名单中.</#FFC43B>'
whitelist-missing: '<#FF3300>错误:</#FF3300> <#FF7E5E>{player} 不在维护白名单中.</#FF7E5E>'
whitelist-empty: '<gray>维护白名单为空.</gray>'
whitelist-list: '<gray>维护白名单 ({count}): <white>{entries}</white></gray>'
login-blocked: '<#FFC43B>{player} 被维护模式拦截.</#FFC43B> <gray>UUID: {uuid} | IP: {address}</gray>'
src/main/resources/maintenance.yml
-45
View File
@@ -1,45 +0,0 @@
# EssentialsC 维护模式配置
config-version: 1
# 是否开启维护模式。
enabled: false
# 拥有该权限的玩家可以在维护模式下进入服务器。
bypass-permission: "essentialsc.maintenance.bypass"
notify:
# 玩家因维护模式被拒绝进入时，是否通知在线管理员。
enabled: true
# 拥有该权限的在线玩家会收到拦截通知。
permission: "essentialsc.maintenance.notify"
# 是否在通知中显示玩家 IP 地址；出于隐私考虑默认关闭。
include-address: false
whitelist:
# 这些 UUID 可以在维护模式下进入服务器。
uuids: []
# 这些玩家名可以在维护模式下进入服务器。大小写不敏感。
names: []
motd:
# 维护模式开启时是否替换服务器列表 MOTD。
enabled: true
lines:
- "&c服务器维护中"
- "&7请稍后再试"
kick-message:
- "&c服务器正在维护"
- "&7请稍后再进入"
bossbar:
# 维护模式开启时是否向所有在线玩家显示 BossBar。
enabled: true
title: "&c服务器正在维护"
# 可选值：PINK / BLUE / RED / GREEN / YELLOW / PURPLE / WHITE
color: RED
# 可选值：SOLID / SEGMENTED_6 / SEGMENTED_10 / SEGMENTED_12 / SEGMENTED_20
style: SOLID
# 进度范围：0.0 - 1.0
progress: 1.0
src/main/resources/modules.yml
+1 -4
View File
@@ -1,7 +1,7 @@
# EssentialsC 模块配置
#
# modules.yml 用于控制功能模块是否在运行时加载。
# 各功能的详细设置位于 config.yml、maintenance.yml 与 blocks-menu.yml。
# 各功能的详细设置位于 config.yml 与 blocks-menu.yml。
#
# 修改模块开关后可使用 /essc reload 刷新运行期服务和监听器。
# 直连命令的完整热增删仍建议通过重启服务器完成。
@@ -21,9 +21,6 @@ modules:
mob-drops:
# 末影人掉落控制菜单和监听器；具体掉落状态可在游戏内切换。
enabled: false
maintenance:
# 维护模式。开启维护后可替换 MOTD，并阻止无绕过权限的玩家进入。
enabled: true
skin-bridge:
# 查询外置 Yggdrasil profile，并通过 MineSkin 与 Paper Profile API 同步皮肤。
enabled: false
src/main/resources/paper-plugin.yml
+1 -20
View File
@@ -1,5 +1,5 @@
name: EssentialsC
description: 适用于 Paper 服务端的轻量基础功能插件。
description: 高版本基础工具箱
version: ${version}
main: cn.infstar.essentialsC.EssentialsC
@@ -7,13 +7,6 @@ api-version: '1.21.11'
load: POSTWORLD
folia-supported: false
dependencies:
server:
LuckPerms:
load: BEFORE
required: false
join-classpath: true
authors: [ Coldsmiles_7 ]
website: www.infstar.cn
@@ -126,9 +119,6 @@ permissions:
essentialsc.command.tpsbar.others:
description: 允许为其他玩家切换 /tpsbar
default: op
essentialsc.command.maintenance:
description: 允许管理维护模式
default: op
essentialsc.command.skin:
description: 允许使用 SkinBridge 管理命令
default: op
@@ -145,12 +135,6 @@ permissions:
essentialsc.command.skin.others:
description: 允许查看或刷新其他玩家的皮肤
default: op
essentialsc.maintenance.bypass:
description: 允许在维护模式下进入服务器
default: op
essentialsc.maintenance.notify:
description: 允许接收维护模式拦截通知
default: op
essentialsc.shulkerbox.open:
description: 允许通过 Shift+右键快捷打开潜影盒
default: op
@@ -197,12 +181,9 @@ permissions:
essentialsc.command.reload: true
essentialsc.command.tpsbar: true
essentialsc.command.tpsbar.others: true
essentialsc.command.maintenance: true
essentialsc.command.skin: true
essentialsc.command.skin.status: true
essentialsc.command.skin.refresh: true
essentialsc.command.skin.others: true
essentialsc.maintenance.bypass: true
essentialsc.maintenance.notify: true
essentialsc.shulkerbox.open: true
essentialsc.mobdrops.enderman: true
src/test/java/cn/infstar/essentialsC/ConfigurationResourcesTest.java
+15 -1
View File
@@ -14,6 +14,7 @@ import java.nio.charset.StandardCharsets;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
class ConfigurationResourcesTest {
@@ -22,7 +23,6 @@ class ConfigurationResourcesTest {
@ValueSource(strings = {
"config.yml",
"modules.yml",
"maintenance.yml",
"blocks-menu.yml",
"paper-plugin.yml",
"lang/zh_CN.yml",
@@ -67,6 +67,20 @@ class ConfigurationResourcesTest {
assertFalse(loadResource("lang/en_US.yml").contains("messages.jei-sync-neoforge", true));
}
@Test
void retiredMaintenanceFeatureIsAbsentFromResources() throws Exception {
assertNull(getClass().getClassLoader().getResource("maintenance.yml"));
assertFalse(loadResource("modules.yml").contains("modules.maintenance", true));
assertFalse(loadResource("paper-plugin.yml").contains("dependencies.server.LuckPerms", true));
assertFalse(loadResource("paper-plugin.yml").contains("permissions.essentialsc.command.maintenance", true));
assertFalse(loadResource("paper-plugin.yml").contains("permissions.essentialsc.maintenance.bypass", true));
assertFalse(loadResource("paper-plugin.yml").contains("permissions.essentialsc.maintenance.notify", true));
assertFalse(loadResource("lang/zh_CN.yml").contains("maintenance", true));
assertFalse(loadResource("lang/en_US.yml").contains("maintenance", true));
assertNull(cn.infstar.essentialsC.commands.CommandRegistry.resolveCommandName("maintenance"));
assertNull(cn.infstar.essentialsC.commands.CommandRegistry.resolveCommandName("maint"));
}
@Test
void miniMessageTagNamesAreNormalized() {
assertEquals("<gray>文本</gray>", LangManager.normalizeMiniMessageTags("<GRAY>文本</GRAY>"));