LSE UEssential | 高性能基础插件，拥有TPA、TPR、Ban、TPS、Home、Warp、数据库、玩家管理、自定义命令等功能，为您提供高效管理的一站式解决方案 v1.2.8

UEssential - 高性能基础插件​

温馨提示：本插件永久免费。若您为下载插件文件或为了解锁其内部功能而付费，说明您已被骗，请立即举报。
-----------------------------------------------------------------------

UEssential的开发理念：

1.性能始终是第一优先级：
我们采取了多项优化来确保UEssential是高效的，如：
①玩家数据库采用KVDB格式，高效读写数据。
②云端黑名单检查使用 network.httpGet 异步请求。
③TPS 历史记录采用固定长度循环数组。
④懒加载与按需初始化：90%的功能都是可以在配置文件内开启或关闭的。
......
我们始终贯彻高性能插件的设计理念，为您的服务器的流畅性保驾护航

2.安全性：
我们采取了多重手段保障UEssential是安全的，如：
①内核安全：所有 costFormula 等动态公式字符串在加载时都会经过 safeFormula 函数过滤，避免恶意软件篡改配置文件执行越权功能。
②权限安全：只有 superAdmins 列表中配置的 XUID 玩家才能执行部分高敏感操作，防止普通管理员越权。
③内容安全：玩家创建家园、转账备注等文本输入会检查违禁词，拒绝包含屏蔽词汇的操作。

3.功能与特色：
作为拥有LeviLamina服务器的运营经验的团队，我们深入学习和掌握Minecraft基岩版服务器的游戏玩法、经济系统，开发了多种功能来完善UEssential。
①.常规功能：Warp、TPA、TPR、Home...
这是基础插件最基础的功能，UEssential都进行了高性能的实现
②.管理功能：Ban、PlayerManage、PlayerDatabase、TPS、MOTD...
作为一款为腐竹提供一站式解决方案的基础插件，以上都被集成到了UEssential内部，为您的服务器运营提供高性能、高可用性的后台管理平台。
③.经济系统增强：我们为经济系统的良性循环提供了一套高安全性的自定义计费模式，有别于传统插件的固定计费，我们的自定义公式允许您对不同使用程度的玩家进行不同的收费，更有效的确保新玩家与老玩家的体验平衡。


部分功能图片速览：

---

核心特性 / Features​

• 深度经济系统整合: 支持 LLMoney 或 计分板(Scoreboard)，所有功能均可使用内置的 安全数学公式 进行阶梯式收费（如：用得越多，收费越贵）。内置带税率的玩家转账 GUI。
• 双云端反作弊黑名单: 内置本地封禁（支持 XUID、名字、IP、设备ID），并无缝接入 BlackBE 与 UniteBan 双云端黑名单，把开挂的玩家拒之门外。
• 智能随机传送 (TPR): 多维度独立配置，内置智能安全落脚点检测（避开岩浆、虚空、墙体），传送附带加载保护与视角失明过渡效果。
• 完善的家园与地标 (Home & Warp):
  • 玩家家园支持 公开发布 (Home Publish) 赚取流量，可设置公开天数上限与全局容量。
  • 管理员支持带维度的地标设置。
• 服务器状态监控 (TPS): 内置高效 TPS 统计仪，管理员可查看最近 10 分钟的 动态 TPS 波动折线图。
• 自定义指令系统 (CusCmd): 在游戏内直接创建虚拟指令映射！支持变量传递（如 %name%），支持绑定控制台执行（内置超级管理员鉴权，防止越权）。
• 动态 MOTD 与 入服公告: 支持服务器列表动态展示当前在线人数与 TPS；支持强制阅读的新手入服公告。
• 多语言支持: 完善的 i18n 国际化支持，玩家可自由切换各自的显示语言。
• 玩家数据库: 现代化玩家数据库管理体系，一键查看玩家的详细信息与日活情况。
• 玩家管理: 一键管理您服务器的在线玩家，查看玩家状态，支持一键封禁、踢出、崩溃玩家客户端，一键查询玩家背包、IP、在线时长等信息，一键为玩家执行命令、以玩家身份说话。
• 深度性能优化: 采用环形缓冲区 (Circular Buffer) 存储 TPS 数据，避免长周期运行下的内存溢出；日志系统采用异步队列批量写入 (Batch I/O)，大幅降低磁盘 I/O 带来的瞬时卡顿

---

指令列表 / Commands​

玩家指令 (所有玩家均可使用)​

管理员指令 (仅限 OP/控制台 使用)​

---

配置文件说明 (config.json)​

首次运行后，插件会在 plugins/UEssential/config.json 生成配置文件。若配置出现致命语法错误，插件会自动备份并重置，防止服务器崩溃。

1. 经济与阶梯收费公式说明​

本插件最大的特色是基于沙盒运行的数学公式进行动态计费。
您可以使用的变量：

• count: 玩家今天使用该功能的次数（每日 0 点重置）。
• index: (仅/back可用) 死亡记录的序号，越旧的记录越贵。
• days: (仅家园发布可用) 发布的时长。

公式编写示例：

• 每次固定 100 金币："100"
• 第一次免费，后面每次 50："count == 0 ? 0 : 50"
• 随着次数指数级增加："10 * Math.pow(1.05, count)" (基础10金币，每次涨价5%)

2. 云端黑名单设置 (ban 模块)​

"ban": {
"enabled": true,
"cloudBlackBE": true, // 是否开启 BlackBE 云端拦截
"cloudUniteBan": false, // 是否开启 UniteBan 联合封禁拦截
"cloudRecordToLocal": false // 是否将云端拦截记录同步写入本地黑名单
}

3. TPA 防骚扰与门槛设置 (tpa 模块)​

"conditions": {
"enableLimits": true, // 是否启用余额门槛
"senderMinMoney": 20000, // 发起者必须有至少2万金币才能发起TPA
"targetMinMoney": 10000, // 目标玩家必须有至少1万金币才能接收TPA
"sbName": "" // 若留空则使用全局经济，填写计分板项则判断该计分板
}

4. 自定义高危指令鉴权 (customCommands 模块)​

如果您要在游戏内使用 /cuscmd 创建一条以控制台身份运行的虚拟指令，您的 XUID 必须在以下列表中，否则将被拦截：
"customCommands": {
"enabled": true,
"superAdmins": ["9999999999999999", "写你自己的XUID"]
}

---

数据存储与日志提取​

所有数据存储于 plugins/UEssential/ 目录下：

• data.json: 玩家计次数据（每日重置）、TPA开关状态、语言偏好。
• homes.json / pubhomes.json: 家园与公开家园数据。
• warps.json: 地标数据。
• bans.json: 本地封禁黑名单。
• DeathPort.json: 死亡坐标记录。
• cuscmds.json: 虚拟自定义指令映射表。

CSV 行为日志
插件会在 logs/UEssential/ 目录下每天生成一份按日期命名的 CSV 日志文件 (如 2024-05-20.csv)。
记录包括：TPS查询、传送、TPA请求、转账、封禁/解封、自定义指令变更等，方便服主使用 Excel 进行回溯与对账。

---

常见问题 (FAQ)​

Q: 玩家发家园名称时使用了脏话怎么办？
A: 配置文件中的 wordFilter 模块提供了敏感词过滤机制，开启后如果家园名称的公开名称包含 words 数组中的词汇，将被拒绝创建。
Q: TPR 随机传送加载太慢，玩家掉进虚空怎么办？
A: tpr 配置中的 loadDelayMs 控制着传送后的加载保护时间（默认 1500 毫秒）。如果您的服务器硬盘、CPU较慢，请调大该数值以及最大重试次数。传送期间玩家具有缓降效果确保安全着陆。
Q: 怎么把转账系统从 LLMoney 切换到计分板？
A: 打开 config.json，在 economy 模块下，把 type 改为 "scoreboard"，并修改 sbName 为您服务器对应的计分板名称（如 "money"）。

---

开发者与反馈​

• 开发辅助: 本项目使用了AI进行辅助开发，模型包括：Gemini 3.1 Pro / Gemini 2.5 Pro
• 作者QQ：1376479666
• BUG反馈与交流群 (QQ): 1097933637