一个简洁、实用的基础插件，适用于基岩版服务器。基于 LegacyScriptEngine (LSE) 的插件，并且可以迁移 TMEssential 的部分数据（如 home 和 warp 的数据）以及 PMenu 的菜单数据（100%兼容！）导入配置文件/数据教程在文末。
如果您使用的是YEssential可以把data拖到NEssential插件目录下覆盖使用!
- 名称：NEssential
- 类型：基础插件 / 多功能模块化插件
- 平台：LegacyScriptEngine (LSE)
- 主要功能：提供服务器基础功能（如：Home Tpr Tpa Warp Money 等）
- 支持迁移其他插件数据：如 TMEssential 的 home 和 warp 数据可迁移到本插件等
- 方法1：使用lip安装，指令：lip install github.com/Nico6719/NEssential
- 方法2：下载本插件解压到Plugins目录内即可
| 功能 | 描述 | 状态 |
|---|---|---|
| Modules | 多模块支持！ | ✅ |
| Economic | 经济核心 | ✅ |
| 菜单 | 菜单功能，兼容PMenu的配置文件！！ | ✅ |
| Hub | 一键回城，可通过指令设置传送点。 | ✅ |
| Rtp | 随机传送，附带动画。 | ✅ |
| Tpa | 传送系统，借鉴了子邪大佬写的 TeleportMaster。 | ✅ |
| Home&Warp | 家系统和公共传送点系统。 | ✅ |
| Fcam | 灵魂出窍（旁观者）。 | ✅ |
| Back&DeathLog | 回死亡点以及记录玩家死亡点。 | ✅ |
| DMotd | 动态 Motd 功能。 | ✅ |
| WeiHu | 维护服务器功能，禁止其他非管理成员进入服务器。 | ✅ |
| Clean | 自动清理掉落物和实体，掉落物过多时 & 定时自动清理，支持白名单。 | ✅ |
| Suicide | 玩家紫砂（kill myself）。 | ✅ |
| BetterStopMsg | 自定义关服提示。 | ✅ |
| MoreLangSupport | 多语言支持。 | ✅ |
| Notice | 自定义公告，支持颜色符号，\n换行，支持游戏内在线编辑！ | ✅ |
| FixExpLag | 防止经验球卡服。 | ✅ |
| Crash | 崩溃玩家客户端（慎用！）。 | ✅ |
| RedPacket | 玩家可以自行发红包。 | ✅ |
| ServersTP | 一键传送到其他服务器。 | ✅ |
| PVP PVP 功能， | 防止玩家恶意攻击。 | ✅ |
| Keepinventory | 开服自动开启死亡不掉落。 | ✅ |
| AutoUpdate | 自动更新插件本体并重载。 | ✅ |
| Bstats统计 | 统计BDS信息和在线人数（可在Config内关闭） | ✅ |
| Gui修改插件配置 | 网页编辑器。 | ✅ |
| Plugin for Endstone | Endstone 版本的 YEssential。 | 🚧 开发中 |
| SideBar | 支持自定义侧边栏以及支持 PAPI 变量。 | 📅 计划中 |
注意！这些变量已从2.8.7版本起废弃。
| 变量名 | 描述 |
|---|---|
| %player_money% | 显示玩家的计分板经济 |
| %player_llmoney% | 显示玩家的LLMoney经济 |
点击这里展开/折叠
插件已持续迭代更新以适应不同 LSE 与 LeviLamina 版本。示例更新版本：
| 版本 | 更新内容 | 日期 |
|---|---|---|
| 1.0.6 | 适配最新 LSE 和 LeviLamina | 2025/01/26 |
| 2.6.6 | 多项功能更新 | 2025/12/20 |
| 2.6.8 | 模块拆分更新 | 2025/12/22 |
| 2.8.0 | 模块优化更新 | 2025/1/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 主配置文件
{
"Update": { //自动更新配置项
"EnableModule": true, //是否开启自动更新功能
"CheckInterval": 120, //定时检查新版本（单位分钟，0关闭，最小值120）
"versionUrl": "https://dl.mcmcc.cc/file/Version.json", //区别版本号的网址
"baseUrl": "https://dl.mcmcc.cc/file/", //下载文件的网址
"files": [ //需要更新的模块/本体
{
"url": "YEssential.js",
"path": "YEssential.js"
},
{
"url": "modules/Cleanmgr.js",
"path": "./modules/Cleanmgr.js"
},
{
"url": "modules/ConfigManager.js",
"path": "./modules/ConfigManager.js"
},
{
"url": "modules/AsyncUpdateChecker.js",
"path": "./modules/AsyncUpdateChecker.js"
},
{
"url": "modules/RadomTeleportSystem.js",
"path": "./modules/RadomTeleportSystem.js"
},
{
"url": "modules/Bstats.js",
"path": "./modules/Bstats.js"
},
{
"url": "modules/Cd.js",
"path": "./modules/Cd.js"
}
],
"reloadDelay": 1000, //自动重载延迟
"timeout": 30000, //检查更新超时时间
"checkMissingFilesOnStart": true //是否在开服时检查有无缺失文件
},
"PVP": {
"EnabledModule": true, //PVP模块，默认为开启
"DangerousBlocks": [ //自定义拦截玩家放置的爆炸实体
"minecraft:tnt",
"minecraft:respawn_anchor",
"minecraft:bed",
"minecraft:undyed_shulker_box"
]
},
"RedPacket": {
"EnabledModule": false, //红包模块开关，默认为关闭
"expireTime": 300,
"maxAmount": 10000,
"maxCount": 50,
"minAmount": 1
},
"CrossServerTransfer": { //跨服传送配置项
"EnabledModule": false, //是否开启该功能
"servers": [ //配置详情
{ "server_name": "生存服", "server_ip": "127.0.0.1", "server_port": 19132 }
],
"servers1": [
{"server_name":"下北泽服务器","server_ip":"1.14.5.14","server_port": 11451 }
]
},
"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 // 记录日志
},
"Bstats": { //Bstats开关
"EnableModule": true, // 模块总开关
"serverUUID": "", // 服务器唯一标识，留空会自动生成
"logSentData": false // 是否在控制台显示发送的数据内容
},
"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为未维护
"whmotdmsg": "服务器维护中，请勿进入！", //维护时MOTD的提示，支持彩色
"whgamemsg": "服务器正在维护中，请您稍后再来!" //维护时玩家进服拦截时的提示，支持彩色
},
"Motd": {
"EnabledModule": true, //是否启用修改MOTD功能，默认开启
"message" : ["Bedrock_Server", "Geyser"], //动态Motd的配置
},
"Notice":{
"EnableModule": false, //是否开启Notice公告功能
"Join_ShowNotice": false, ///是否在加入服务器时弹出
"IsUpdate":false, //公告是否有在游戏内更新过，当true时下次所有玩家都会弹出公告
},
"SimpleLogOutPut": false, //简洁的日志输出，默认为关闭
"CrashModuleEnabled": 0, //崩端功能开关，默认为关闭
"Economy": { //经济模块设置
"mode": "scoreboard", //经济模式 填llmoney为llmoney模式，填scoreboard为计分板模式
"PayTaxRate": 0, //转账税率（%）
"RankingModel" : "New", //金币排行版的样式 （可填New或Old）
"Scoreboard": "money", //计分板项使用的名字，不可填中文！
"CoinName": "金币" //金币名字
},
"Back": 0 , //返回死亡点花费的金钱
"Warp": 0 , //前往公共传送点花费的金钱
"BackTipAfterDeath": 0, //重生后是否自动弹窗（1开启，0关闭）
"KeepInventory": 1, //开服是否自动执行开启死亡不掉落指令
"suicide": 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 //玩家执行清理冷却时长（单位/秒）
}
}- ./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 &toast &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\NEssential\data内并且分别重命名为homedata.json和warpdata.json然后保存即可
-
迁移PMenu菜单插件配置文件教程： 把 服务端目录\plugins\Planet\PMENU\packs内的所有东西 移动 到 服务端目录\plugins\NEssential\data\menus内即可
如果您也想为NEssential做贡献欢迎提交 Issue，共同完善 YEssential。