English Description

Beilin Entry Control is a Fabric server-side mod designed for Beiyue member servers.

This mod validates player access by communicating with the Beiyue API (beiyue.us). Players without permission or with active restrictions will be denied entry.

Features

Unified access control via Beiyue API
Real-time ban and permission updates via WebSocket
No persistent side effects (memory-only operations, no modification to other mods or game files)

Requirements

Beiyue member server access
Fabric server with Fabric API installed
Valid API key provided by Beiyue

This project is primarily intended for Chinese users.

Beilin Entry Control（北约统一入服控制系统）

Beilin Entry Control 配套的 Fabric 服务端模组，面向 北约成员服。本模组通过与 beiyue.us 通信校验玩家权限、验证北约入服权。

功能概览

统一入服控制
玩家进入服务器时，模组会向 beiyue.us 发起权限校验请求。若玩家未获批北约入服权，或存在一项/多项禁令，服务器将拒绝进入。
跨服禁令即时生效
模组通过 WebSocket 持续同步状态。即使玩家已进入服务器，一旦权限变化相关限制也会立即生效。
无持久化副作用
- 所有逻辑仅在内存中运行；
- 仅读取本模组自身的配置文件；
- 不会修改其他模组或 Minecraft 的配置；
- 移除本模组后，服务器将立即恢复为原版逻辑。

前置条件

在安装和使用本模组之前，请确保满足以下条件：

北约成员服务器身份
本模组仅对北约成员服务器开放使用权限，非成员服务器暂不提供支持。
Minecraft 服务端环境
服务器需运行 Fabric 服务端，并已正确安装 Fabric API，以确保模组能够正常加载和运行。
API 凭据获取
该模组需要有效的 API 凭据。请向 Narek 获取专用的 apiKey，并按照配置说明将其添加至服务器配置文件中。

安装步骤

搭建 Fabric 服务端
- 使用官方 Fabric Installer 搭建 Fabric 服务端。
放入模组文件
- 将本模组的 .jar 文件放入服务器根目录下的 mods 文件夹。
首次启动服务器
- 启动一次服务器，使模组完成初始化；
- 此时会在 config 目录下生成配置文件 beilin-entry-control.json。
停止服务器
- 关闭服务器进程，以便编辑配置文件。

配置说明

配置文件路径：config/beilin-entry-control.json

示例内容（仅示例，实际以生成文件为准）：

{ "apiKey": "YOUR_API_KEY_HERE", "baseHost": "beiyue.us", "useHttps": true, "useWss": true }

apiKey（必填）
- 向 Narek 申请获得的 API 密钥；
- 首次生成时为占位值 "YOUR_API_KEY_HERE"，请务必替换；
- 若缺失或为空，本模组会认为配置无效，拒绝正常工作。
baseHost
- 与 API 通信的主机名；
- 默认值为 "beiyue.us"；
- 仅在特殊环境（如内网、测试环境）需要修改。
useHttps
- 是否通过 https:// 访问 HTTP API；
- 仅在特殊环境（如内网、测试环境）需要修改。
useWss
- 是否通过 wss:// 使用 WebSocket；
- 仅在特殊环境（如内网、测试环境）需要修改。

修改完成后，保存配置文件，然后重新启动服务器。

服务器白名单设置

本模组不会修改任何原版或 Fabric 白名单配置，需要服务器管理员手动调整白名单策略：

若希望 仅通过 Beilin Entry Control 控制入服：
- 请在 server.properties 中将 white-list 设为 false；
- 或通过你习惯的方式关闭原版白名单；
- 实际入服权限由 beiyue.us 决定。
若仍需 配合原版白名单一起使用：
- 也可以保留白名单开启状态；
- 此时入服需要同时满足「持有有效的北林入服权」与「在服务器白名单中」两个条件。

升级与移除

升级模组
- 停止服务器；
- 替换 mods 目录中的旧版本 .jar 为新版本；
- 保留原有的 config/beilin-entry-control.json，通常无需更改；
- 重新启动服务器即可。
移除模组
- 停止服务器；
- 从 mods 目录中删除本模组 .jar 文件；
- 重新启动服务器；
- 此时服务器将恢复为 原版入服逻辑，不再访问 beiyue.us API。