Skip to content

Home

Jump to bottom
Lemon-miaow edited this page Jun 26, 2025 · 20 revisions

简体中文 | English

安装&配置

查看此Wiki右侧的目录可以快速跳转到你想看的部分

省流版

  1. 前往MCDReforged服务端配置文件目录config进入MeowtiWhitelist文件夹

  2. 打开example文件夹，选一个你需要的模板然后编辑模板中的id的值作为编号（必须是正整数N*）以启用它

    可选：你也可以修改name的名字来作为该服务在命令中使用的名字，修改apiRoot的url来自定义验证服务的api接口，id和name必须唯一

  3. 把修改好的模板放入service文件夹里然后重载插件!!MCDR plugin reload meowtiwhitelist

  4. !!whitelist就能🤺了

没看懂？那就看超长版的（bushi：

依赖

MCDReforged>=2.12.0

requests>=2.31.0

PyYAML>=6.0.2

安装

  1. 从 GitHub Releases中下载最新版本的MultiWhitelist
  2. 将下载的插件放入plugins目录中（如下所示）
    your_mcdr_server/
    ├─ config/
    ├─ logs/
    ├─ plugins/
    │   ├─ ...
++  │   └─ MultiWhitelist-v{x.y.z}.mcdr
    ├─ server/
    ├─ config.yml
    └─ permission.yml
  1. 安装所需的依赖
  2. 通过MCDReforged启动服务器

配置

找到服务配置文件

第一次使用需要前往 config/meowtiwhitelist/services 目录下配置 Service

为了方便使用，我们已经提前内置好了主要验证方式的模板。

在首次运行之后，插件将会释放配置文件，并存放在config目录之中，服务配置模板将位于example文件夹中，如下所示。

    your_mcdr_server/config
    ├── mcdreforged
    │   └── ...
++  └── MeowtiWhitelist
        ├── config.json
        ├── example
        │   ├── littleskin.yml
        │   └── mojang.yml
        └── service
  • littleskin.yml 是 LittleSkin 验证服务的模板
  • mojang.yml 是 Mojang 官方正版验证服务的模板

配置验证服务

目前配置支持两种：一种基于BlessingSkin的模板（例如LittleSkin），一种基于Mojang的模板

此处使用 LittleSkin 的配置文件模板 littleskin.yml 为例。

littleskin.yml

# Please edit before use.
id: 0

name: 'LittleSkin'
# Don't change it unless you really want to.
serviceType: BLESSING_SKIN
yggdrasilAuth:
  blessingSkin:
    apiRoot: 'https://littleskin.cn/api/yggdrasil'
  • id 是验证服务使用的序号，从1开始。
  • name 是在命令中使用服务的名称，比如你改成Genshimpart你就可以在执行指令的时候使用它作为选项
  • apiRoot 是BlessingSkin所使用的通用api接口，路径一般为https://example.com/api/yggdrasil

当您将配置文件修改完毕后，请将 littleskin.yml 移动或复制到service文件夹中给插件读取。

TIPS: 可以使用!!MCDR plguin reload meowtiwhitelist进行热重载配置文件

    your_mcdr_server/config
    ├── mcdreforged
    │   └── ...
++  └── MultiWhitelist
        ├── config.json
        ├── example
        │   ├── littleskin.yml
        │   └── mojang.yml
        └── service
            ├── littleskin.yml

插件行为配置

插件的配置为config/MeowtiWhitelist中的config.json

  • server_dirname 可用于配置服务端所在的文件夹位置 默认值为server
  • permission 可用于更改执行命令的最低权限等级，参见：权限 默认值为3
  • disable_backup 可用于关闭修改白名单时的自动备份功能↓

【高危操作警告】：这玩意儿就跟拆了汽车的安全气囊一样，虽然给了你自由，但出了事可没得救。关掉它之前，请摸着良心问问自己：是不是非关不可？会不会手动备份？搞砸了有没有本事自己恢复？如果答案都是“是”，那请便。否则，数据丢了可别哭着来找我们（bushi）。

命令

!!whitelist 显示插件帮助，同时列出当前可用的api列表

!!whitelist help 显示插件帮助，同时列出当前可用的api列表

!!whitelist add <player_name> <api> 添加玩家白名单，api的参数必须是服务配置完成后插件帮助中所识别显示的名称或者是编号，名称不区分大小写

!!whitelist remove <player_name> 移除玩家白名单

!!whitelist list [page] 列出当前白名单whitelist.json中的玩家。page(可选): 指定要查看的页码。如果不填写，默认为第一页。

白名单文件操作备份

插件会在每次执行写入操作（例如增加或移除白名单）时在服务端与whitelist.json文件同级目录下的whitelist_backup文件夹中创建一次操作前文件的备份以防止因为某种玄学问题炸没整个白名单文件的问题 这或许是必要的强碱用户硬盘？

备份最多留有五个，每次创建备份都会删除最旧的一次备份

API

概述

本 API 提供 Minecraft 白名单管理核心功能，支持通过不同服务进行 UUID 查询和白名单操作。

API可从meowtiwhitelist.api中调用，调用时请确保插件已被正确在MCDR中载入

服务说明

可用服务由MeowtiWhitelist管理，服务配置请参考配置

📝 注意： 所有 src 参数由您的命令框架提供（如命令方块/控制台/玩家执行者）

get_player_uuid(player_name: str, service_id: str)

通过指定服务获取玩家的 UUID

参数

  • player_name (str): 玩家游戏名称
  • service_id (str): 配置的服务名称name（如 "mojang"）

返回值

  • str: 玩家的 UUID 字符串

示例

uuid = get_player_uuid("Steve", "mojang")

add_whitelist_direct(src, player_name: str, uuid: str)

直接添加玩家到白名单（手动指定 UUID）⚠️ 不验证输入有效性

参数

  • src: 命令来源（控制台/玩家对象）
  • player_name (str): 要添加的玩家名称
  • uuid (str): 有效的 Minecraft UUID 字符串

示例

add_whitelist_direct(src, "Notch", "069a79f4-44e9-4726-a5be-fca90e38aaf5")

add_whitelist(src, player_name: str, service_id: str)

通过服务自动查询并添加玩家到白名单

参数

  • src: 命令来源（控制台/玩家对象）
  • player_name (str): 要添加的玩家名称
  • service_id (str): 配置的服务名称name（如 "littleskin"）

示例

add_whitelist(src, "Notch", "mojang")

remove_whitelist(src, player_name: str)

从白名单中移除玩家

参数

  • src: 命令来源（控制台/玩家对象）
  • player_name (str): 要移除的玩家名称

示例

remove_whitelist(src, "Notch")
Clone this wiki locally