UltraWhitelist

插件

· 作者 LOLYAY

支持命名列表的多列表白名单、热替换与导入功能

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.2 · 26.2 · Folia / Paper

一键开服(送7天)

UltraWhitelist

UltraWhitelist 是一款支持 Paper/Folia 的白名单插件,具备多命名列表、JSON 导入以及 Folia 安全执行等功能。

功能

  • 多白名单支持:设计用于同时管理多个列表
  • 列表热切换:可通过单一命令切换列表
  • 轻松导入:/wl import whitelist.json xxx 可导入你现有的服务器 whitelist.json
  • 强制执行:踢出所有不在列表中的玩家
  • 丰富的列表管理:提供大量创建/删除/合并/管理列表的命令
  • 对开发者友好的 API:易于插件集成

命令

命令 用途
/wl on 启用白名单。
/wl off 禁用白名单。
/wl info 显示当前状态。
/wl list 显示所有白名单。
/wl listplayers <list> [page] 显示列表中玩家名称。
/wl find <player> 显示包含该玩家的每个列表。
/wl create <name> 创建列表。
/wl delete <list> 删除列表
/wl add <list|all> <player> 将玩家添加到列表 / 所有列表。
/wl remove <list|all> <player> 从列表 / 所有列表中移除玩家。
/wl use <list> 更改当前生效的列表。
/wl enforce [list] 踢出被列表不允许的在线玩家。
/wl merge <a> <b> <new> 将两个列表合并为一个新的列表。
/wl addfromlist <source> <destination> 在列表之间复制新条目。
/wl import <file.json> <list> 导入白名单风格的 JSON 文件。
/wl reload 重载插件。
/wl help 显示命令帮助。

权限

权限 用途 默认值
ultrawhitelist.admin 使用白名单管理命令。 管理员 (Operators)
ultrawhitelist.bypass 避免被 /wl enforce 踢出。 管理员 (Operators)

开发者 API

1. 添加依赖项:

Maven

<repositories>
    <repository>
        <id>lolyay-releases</id>
        <url>https://maven.lolyay.dev/releases</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>io.lolyay.mc</groupId>
        <artifactId>WhitelistPlugin</artifactId>
        <version>1.0.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Gradle (Kotlin DSL)

repositories {
    maven("https://maven.lolyay.dev/releases")
}
dependencies {
    compileOnly("io.lolyay.mc:WhitelistPlugin:1.0.0")
}

2. 声明依赖:

depend: [UltraWhitelist]

3. 获取服务

所有内容都通过 WhitelistService 进行交互,可从插件实例中访问:

import io.lolyay.mc.whitelistPlugin.WhitelistPlugin;
import io.lolyay.mc.whitelistPlugin.core.WhitelistService;

WhitelistPlugin wl = (WhitelistPlugin) Bukkit.getPluginManager().getPlugin("UltraWhitelist");
if (wl == null || wl.service() == null) return;   // 未安装 / 尚未启用
WhitelistService service = wl.service();

3. WhitelistService API

全局状态

方法 描述
boolean isEnabled() 是否全局启用了白名单?
boolean setEnabled(boolean) 开启/关闭白名单;如果状态未改变则返回 false。
String activeListName() 活动(登录强制执行)列表的名称,或 null。
WhitelistList activeList() 活动列表对象,或 null。
boolean setActiveList(String name) 设置活动列表(null 清除它);如果状态未改变则返回 false。

成员资格

方法 描述
boolean isWhitelisted(UUID id, String name) 登录时使用的确切检查。如果白名单已关闭、无活动列表或身份在活动列表中(通过 UUID 或 名称),则返回 true。
boolean allowed = service.isWhitelisted(event.getUniqueId(), event.getName());

列表

方法 描述
WhitelistList getList(String name) 不区分大小写的查找,若不存在则返回 null。
Collection<WhitelistList> lists() 所有列表。
List<String> findLists(UUID id, String name) 匹配列表的排序名称列表。
boolean createList(String name) 如果列表已存在则返回 false。
boolean deleteList(String name) 如果不存在该列表则返回 false。

条目

方法 描述
boolean addUuid(String list, UUID id) 添加条目;如果未改变或列表缺失则返回 false。
boolean addName(String list, String name) 添加名称条目;如果未改变或列表缺失则返回 false。
boolean removeUuid(String list, UUID id) 移除条目;如果未改变或列表缺失则返回 false。
boolean removeName(String list, String name) 移除条目;如果未改变或列表缺失则返回 false。
List<String> addUuidToAll(UUID) / addNameToAll(String) 添加到所有列表并返回更改过的列表名称。
List<String> removeUuidFromAll(UUID) / removeNameFromAll(String) 从所有列表中移除并返回更改过的列表名称。
MergeResult merge(String a, String b, String newName) 将两个列表合并为一个新的列表。
int addFromList(String src, String dest) 复制条目并返回添加的数量(如果缺失则返回 -1)。

名称缓存 (UUID <-> 名称)

条目以 UUID 优先 方式存储;持久化缓存将 UUID 映射到最后已知的名称 (由登录、导入和 playerdb.co 查询提供数据)。

方法 描述
void cacheName(UUID id, String name) 记录/持久化 UUID -> 名称的映射。
String nameFor(UUID id) UUID 的最后已知名称,或 null。
UUID uuidForName(String name) 名称的缓存 UUID(不区分大小写),或 null。

WhitelistList

方法 描述
String name() 显示名称。
boolean contains(UUID id, String name) 按 UUID 或名称进行匹配。
Set<UUID> uuids() 实时 UUID 条目。
Map<String,String> names() 小写名称 -> 显示名称。
int size() 总条目数。

MergeResult: { OK, MISSING_A, MISSING_B, TARGET_EXISTS }。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源