基于 LSE 的多功能基础插件
一个简洁、实用的基础插件，适用于基岩版服务器。基于 LegacyScriptEngine (LSE) 的插件，并且可以迁移 TMEssential 的部分数据（如 home 和 warp）以及 PMenu 的菜单数据（100%兼容！）导入配置文件/数据教程在文末。
- 名称：YEssential
- 类型：基础插件 / 多功能前置
- 平台：LegacyScriptEngine (LSE)
- 主要功能：提供服务器基础功能（如：Home Tpr Tpa Warp Money 等）
- 支持迁移其他插件数据：如TMEssential 的 home 和 warp 数据可迁移到本插件等
| 功能 | 描述 | 状态 |
|---|---|---|
| Modules | 多模块支持！ | ✅ |
| Economic | 经济核心 | ✅ |
| 菜单 | 菜单功能，兼容PMenu的配置文件！！ | ✅ |
| Hub | 一键回城，可通过指令设置传送点。 | ✅ |
| Rtp | 随机传送，附带动画。 | ✅ |
| Tpa | 传送系统，借鉴了子邪大佬写的 TeleportMaster。 | ✅ |
| Home&Warp | 家系统和公共传送点系统。 | ✅ |
| Fcam | 灵魂出窍（旁观者）。 | ✅ |
| Back&DeathLog | 回死亡点以及记录玩家死亡点。 | ✅ |
| DMotd | 动态 Motd 功能。 | ✅ |
| WeiHu | 维护服务器功能，禁止其他非管理成员进入服务器。 | ✅ |
| Clean | 自动清理掉落物和实体，掉落物过多时 & 定时自动清理，支持白名单。 | ✅ |
| Suicide | 玩家紫砂（kill myself）。 | ✅ |
| BStopMsg | 自定义关服提示。 | ✅ |
| MoreLangSupport | 多语言支持。 | ✅ |
| Notice | 自定义公告，支持颜色符号，\n换行，支持游戏内在线编辑！ | ✅ |
| FixExpLag | 防止经验球卡服。 | ✅ |
| Crash | 崩溃玩家客户端（慎用！）。 | ✅ |
| RedPacket | 玩家可以自行发红包。 | ✅ |
| ServersTP | 一键传送到其他服务器。 | ✅ |
| PVP PVP 功能， | 防止玩家恶意攻击。 | ✅ |
| Keepinventory | 开服自动开启死亡不掉落。 | ✅ |
| AutoUpdate | 自动更新插件本体并重载。 | ✅ |
| Gui修改插件配置 | 网页编辑器。 | ✅ |
| Plugin for Endstone | Endstone 版本的 YEssential。 | 🚧 开发中 |
| SideBar | 支持自定义侧边栏以及支持 PAPI 变量。 | 📅 计划中 |
| 变量名 | 描述 |
|---|---|
| %player_money% | 显示玩家的计分板经济 |
| %player_llmoney% | 显示玩家的LLMoney经济 |
点击这里展开/折叠
- v2.7.1 -- v2.7.2
- 重写经济系统
- 优化日志输出
- 删除无用代码及其优化
- 修复一些潜在的问题及Bug
- 重写大量代码（经济类，RTP类）
- 将RTP和自动更新功能写成模块
- 修复RTP动画的相关问题
- 修复开服时可能存在的问题
- 添加了更多的语言文件导出
- 初步支持离线转账
- v2.7.0 -- v2.6.6
- 优化代码
- 完全重写Clean功能。独立为模块，有单独的配置文件，可以当作一个独立的清理插件看。支持清理实体，支持白名单，支持i18n，支持错误分析。
- 优化插件加载时的提示
- 将配置管理器拆分成模块
- 重写模块加载器
- 优化开服时的Log提示
插件已持续迭代更新以适应不同 LSE 与 LeviLamina 版本。示例更新版本：
| 版本 | 更新内容 | 日期 |
|---|---|---|
| 1.0.6 | 适配最新 LSE 和 LeviLamina | 2025/01/26 |
| 2.6.6 | 多项功能更新 | 2025/12/20 |
| 2.6.8 | 模块拆分更新 | 2025/12/22 |
| 3.0.0 | GitHub 下载新版 | 未注明 |
- 需要 LegacyScriptEngine 平台支持
- 兼容并能够导入部分 TMEssential 的数据
把 服务端目录\plugins\Timiya\data内的homelist.json和warplist.json
移动到服务端目录\plugins\YEssential\data内并且分别重命名为homedata.json和warpdata.json然后保存
适合基岩版 Minecraft 服务器使用，特别是：
- 想从 TMEssential 迁移到新基础插件
- 需要还在维护的Menu插件
YEssential 在版本 1.0.0 起已开始兼容 LeviLamina 平台，与 LSE 平台配合可以用于更强的服务器模组环境支持。
LeviLamina 是一个轻量、模块化的 Minecraft Bedrock Edition 模组加载器，为插件/模组提供基础 API 和事件系统支持。
- ./Config/config.json 主配置文件
{
"AutoUpdate": 1, //自动更新，默认为开启
"PVP": {
"EnabledModule": true, //PVP模块，默认为开启
"DangerousBlocks": [ //自定义拦截玩家放置的爆炸实体
"minecraft:tnt",
"minecraft:respawn_anchor",
"minecraft:bed",
"minecraft:undyed_shulker_box"
]
},
"DebugMode": 0, //Debug模式，默认为关闭
"CrashModuleEnabled": 0, //崩端功能开关，默认为关闭
"NoticeEnabled":0, //Notice 功能开关，默认为关闭
"TRServersEnabled": 0, // 跨服传送开关，默认为关闭
"RedPacket": {
"EnabledModule": false, //红包模块开关，默认为关闭
"expireTime": 300,
"maxAmount": 10000,
"maxCount": 50,
"minAmount": 1
},
"RTP": { //随机传送模块
"EnabledModule": false, //随机传送模块开关，默认为关闭
"minRadius": 100, // 最小传送半径
"maxRadius": 5000, // 最大传送半径
"cooldown": 300, // 冷却时间（秒）
"cost": 50, // 传送费用
"allowDimensions": [
0,
1,
2
], // 允许的维度
"safeCheck": true, //传送前安全性检查
"maxAttempts": 50, // 最大尝试次数
"Animation": 0, //随机传送动画（0为关闭，1为GTA5样式）
"enableParticle": true, //传送成功粒子
"enableSound": true, //传送成功音效
"logToFile": true // 记录日志
},
"Hub": { //Hub坐标配置
"EnabledModule": false, //Hub功能开关，默认为关闭
"x": 58776.7, //x轴
"y": 68.6, //y轴
"z": 59617.9, //z轴
"dimid": 0, //维度坐标
"isSet": false //是否已经设置
},
"tpa": { //传送系统配置
"EnabledModule": false, //TPA功能开关，默认为关闭
"isDelayEnabled": true, //是否开启延迟传送
"maxDelay": 20, //传送最大延迟
"cost" : 1, //tpa传送花费
"requestTimeout": 60, //传送请求过期时间
"promptType": "form" //传送请求类型
},
"Home": {
"add": 0, //添加家花费
"del": 0, //删除家花费
"tp": 0, //传送家花费
"MaxHome": 10 //最大家数量
},
"Fcam": { //灵魂出窍的配置
"EnableModule": false, //是否开启该功能 true或1为开启，0或false关闭
"CostMoney": 0, //使用该功能花费的金钱
"TimeOut": 0 //灵魂出窍使用时间限制
},
"wh": { //维护功能的配置
"EnableModule": true, //是否开启该功能 true或1为开启，0或false关闭
"status": 0 //维护状态1为维护中，0为未维护
},
"Motd": [ //动态Motd
"Bedrock_Server",
"Geyser"
],
"LLMoney": 0, //切换经济系统（0为记分板，1为LLmoney模式）
"Scoreboard": "money", //计分板名称
"PayTaxRate": 0, //转账税率（%）
"Back": 0 , //返回死亡点花费的金钱
"Warp": 0 , //前往公共传送点花费的金钱
"BackTipAfterDeath": 0, //重生后是否自动弹窗（1开启，0关闭）
"KeepInventory": 1, //开服是否自动执行开启死亡不掉落指令
"suicide": 0, //自杀所花费的金钱
"OptimizeXporb": 1, //经验球拾取优化，防止堆积卡服
"join_notice": 0, //进服是否自动弹出公告（默认为关闭，1开启）
"RankingModel": 1, //金币排行榜GUI样式 1为新版，2为旧版
"lastServerShutdown": 1742694883508, //勿动
"forceNotice": 0 , //勿动
"Version": 265 //版本标识符，勿动！
}懒怎么办？？ 试试网页配置编辑器吧！
- ./Config/cleanmgr/config.json 清理器配置文件
{
"cleanmgr": {
"enable": true, //是否开启清理模块
"interval": 600, //定时清理（单位： 秒）
"debug": false, //debug模式
"whitelist": [ //清理白名单
"^minecraft:netherite_",
"^minecraft:ancient_debris$",
"^minecraft:dragon_egg$",
"^minecraft:nether_star$",
"^minecraft:elytra$",
"^minecraft:emerald$",
"^minecraft:beacon$",
"^minecraft:ender_eye$",
"^minecraft:shulker_box$",
"^minecraft:sea_lantern$",
"^minecraft:enchanted_book$",
"^minecraft:diamond",
"^minecraft:totem_of_undying$",
"^minecraft:ender_pearl$",
"^minecraft:villager_v2$",
"^minecraft:ender_crystal$",
"^minecraft:ender_dragon$",
"^minecraft:parrot$",
"^minecraft:chest_minecart$",
"^minecraft:minecart$",
"^minecraft:hopper_minecart$",
"^minecraft:armor_stand$",
"^minecraft:boat$",
"^minecraft:sheep$",
"^minecraft:cow$",
"^minecraft:pig$",
"^minecraft:painting$"
],
"notice": { //倒计时提示
"notice1": 30,
"notice2": 10
},
"LowTpsClean": { //低tps自动清理
"enable": true, //是否启用该功能
"minimum": 15, //最小tps清理限制
"maxConsecutiveCleans": 2, // 最大连续无效清理次数
"longCooldown": 450 // 长冷却时间（秒），默认7.5分钟 (5-10分钟中间值)
},
"clean_Cmd": "clean", //清理命令自定义
"playerCooldown": 300 //玩家执行清理冷却时长（单位/秒）
}
}- ./data/TrSeverData/server.json 跨服传送配置文件
{
"servers": [
{"server_name":"下北泽服务器","server_ip":"1.14.5.14","server_port":19181}
],
"servers1": [
{"server_name":"下北泽服务器","server_ip":"1.14.5.14","server_port":11451}
]
}- ./modules/modulelist.json 模块列表
{
"modules": [
{
"path": "Cleanmgr.js",
"name": "CleanMgr"
},
{
"path": "ConfigManager.js",
"name": "ConfigManager"
},
{
"path": "AsyncUpdateChecker.js",
"name": "AsyncUpdateChecker"
},
{
"path": "RadomTeleportSystem.js",
"name": "RadomTeleportSystem"
},
{
"path": "Cd.js",
"name": "Cd"
},
{
"path": "XXX.js",
"name": "XXX" //可以添加你想要加载的模块以便服务器使用
}
]
}- ./Config/Cd/Config.json 菜单的配置文件
{
"money": 0, //经济模式 0为计分板 1为LLMoney
"score": "money", //计分板名称
"item": "minecraft:clock", //菜单触发物品
"main": "main", //主菜单文件名
"shield": [] //屏蔽方块列表
}
以下是部分常用指令示例（视插件版本可能会有所变动）：
/cd 菜单
/menu {set} 菜单{配置}
/home #家系统菜单(设置、传送到家)
/tpa #玩家互传系统(发送传送请求)
/tpayes #同意传送请求
/tpano #拒绝传送请求
/tpasettings #拒绝或者同意所有传送请求
/rtp #随机传送(在不同维度安全随机传送)
/PVP #开关个人PVP功能
/warp #公共传送点菜单
/servers #跨服传送菜单
/back #死亡点传送(返回死亡位置)
/deathlog #查询以往的死亡记录
/moneygui #打开GUI经济系统
/moneys add & del & set get 玩家（非get时加上“金额”） #经济操作 ：添加/减少/增加玩家的金额
/notice #查看公告
/noticeset #更改公告
/wh #打开或关闭维护状态
/clean {air} status & cancel & tps &help #清理掉落物 & 清理状态 & 取消清理 & 查询tps & 帮助
/suicide #自杀
/fcam #开关灵魂出窍功能
/rtpreset #重置冷却时间（Only 管理员）
/hub #一键回到指定地点（所有人可用）
/sethub #设置/hub传送的地点
/crash #打开崩溃玩家客户端菜单
/redpacket history && list && open && send #红包功能（长指令版）
/rp history && list && open && send #红包功能（短指令版）
/redpackethelp #红包功能详解（GUI界面）-
迁移TMET基础插件配置文件教程： 把 服务端目录\plugins\Timiya\data内的homelist.json和warplist.json 移动到服务端目录\plugins\YEssential\data内并且分别重命名为homedata.json和warpdata.json然后保存即可
-
迁移PMenu菜单插件配置文件教程： 把 服务端目录\plugins\Planet\PMENU\packs内的所有东西 移动 到 服务端目录\plugins\YEssential\data\menus内即可
本项目的诞生离不开PHEyeji等人的帮助与支持！
如果您也想为YEssential做贡献欢迎提交 Issue 和 Pull Request，共同完善 YEssential。