- 版权类型
- 原创
- 语言支持
- 中文(简体)
- 前置组件
- LeviLamina: https://github.com/LiteLDev/LeviLamina
LegacyScriptEngine的Quickjs:https://github.com/LiteLDev/LegacyScriptEngine
- 适配版本(基岩)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
YEssential --- 一个高性能,模块化设计,更新快,功能高度可定制化的插件,家园系统,传送系统,经济系统一应俱全的多功能基础插件!一个插件就能解决你的所有需求!
[申明]
- 反馈问题前请排查依赖是否正确加载!
- 反馈请在Github反馈或QQ群:1045392458
- 您无需经过授权就可以整合本插件到您的整合包内!(不允许整合到付费整合包内)
- 禁止二次修改闭源分发或使用AI修改!(必须遵守AGPL——3.0协议分发/修改/二次开发!)
- 如果您使用的是低于1.21.80的版本的服务端请使用小于等于2.10.2的旧版本插件!
[兼容列表]
- 支持导入TMEssential的home数据和warp数据!
- 支持导入PMenu的菜单配置文件!!
- 支持导入PSign的数据和配置文件!教程在文末
[安装方法]
- 方法1(推荐):使用lip安装,指令:lip install github.com/Nico6719/YEssential
- 方法2:下载本插件解压到Plugins目录内即可
[功能特性]
功能 | 描述 | 状态 |
|---|---|---|
Economic | 经济核心 | |
| Menu | GUI菜单功能!兼容PMenu的配置文件,可以无损迁移到本插件! | |
Hub | 一键回城,可通过指令设置传送点 | |
Rtp | 随机传送,附带动画 | |
Tpa | 传送系统,借鉴了子邪大佬写的TeleportMaster | |
Home&Warp | 家系统和公共传送点系统 | |
| Fcam | 灵魂出窍(旁观者) | |
Back&DeathLog | 回死亡点以及记录玩家死亡点 | |
DMotd | 动态Motd功能 | |
WeiHu | 维护服务器功能,禁止其他非管理成员进入服务器 | |
Cleanmgr | 自动清理掉落物和实体,掉落物过多时&定时自动清理,支持白名单!! | |
Suicide | 玩家紫砂(kill myself) | |
BStopMsg | 自定义关服提示 | |
MoreLangSupport | 多语言支持 | |
Notice | 自定义公告,支持颜色符号,\n换行,支持游戏内在线编辑! | |
FixExpLag | 防止经验球卡服 | |
Crash | 崩溃玩家客户端 | |
RedPacket | 玩家可以自行发红包 | |
ServersTP | 一键传送到其他服务器 | |
PVP | PVP功能,防止玩家恶意攻击, 可拦截投掷物,箭矢,可自定义拦截爆炸实体 | |
Keepinventory | 开服自动开启开启死亡不掉落 | |
| Sign | 每日签到 | |
AutoUpdate | 自动更新插件本体并重载 | |
| Bstats统计 | 统计BDS信息和在线人数(可在Config内关闭) 开启统计可以帮助开发者了解插件运行状况,优化插件性能! | |
Gui修改插件配置 | ||
Plugin for Endstone | Endstone版本的YEssential | 开发中 |
| SideBar | 支持自定义侧边栏以及支持PAPI变量 | 计划中 |
[指令一览]
| 指令 | 功能描述 |
| /cd {set} && /menu {set} | NEW!菜单功能 {菜单设置} |
| /getclock | NEW!获取钟 |
| /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 &toast | 清理掉落物 & 清理状态 & 取消清理 & 查询tps & 帮助 |
| /suicide | 自杀 |
| /fcam | 开关灵魂出窍功能 |
| /rtpreset | 重置冷却时间(Only 管理员) |
| /hub | 一键回到指定地点(所有人可用) |
| /sethub | 设置/hub传送的地点 |
| /crash | 打开崩溃玩家客户端菜单 |
| /redpacket history && list && open && send | 红包功能(长指令版) |
| /rp history && list && open && send | 红包功能(短指令版) |
| /redpackethelp | 红包功能详解(GUI界面) |
| /sign | 签到 |
| /signset | 管理员签到设置 |
[GUI界面]
Home菜单主界面
添加家
家设置
公告功能
(公告编辑器)
(公告配置文件文件在 ./plugins/YEssential/notice.txt)
金币菜单 (OP)
(玩家)
Back死亡点传送功能:
添加家
家设置
公告功能
(公告编辑器)
(公告配置文件文件在 ./plugins/YEssential/notice.txt)
金币菜单 (OP)
(玩家)
Back死亡点传送功能:
[配置文件注释]
看的配置头疼?懒得改配置?不妨来试试这个:
YEssential ALL in one配置器
YEssential ALL in one配置器
Config.json(未说明即0[false]为关闭,1[true]为开启):
JSON:
{
"PVP": { //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": { //数据统计模块
"EnableModule": true, //模块总开关
"logSentData": false //是否在控制台显示发送的数据内容
},
"Hub": { //一键回城模块
"EnabledModule": false, //Hub功能开关,默认为关闭
"x": 58776.7, //X轴坐标
"y": 68.6, //Y轴坐标
"z": 59617.9, //Z轴坐标
"dimid": 0, //维度ID(0主世界,1下界,2末地)
"isSet": false //是否已经设置
},
"tpa": { //玩家互传模块
"EnabledModule": false, //TPA功能开关,默认为关闭
"isDelayEnabled": true, //是否开启延迟传送
"maxDelay": 20, //传送最大延迟
"cost": 1, //传送花费
"requestTimeout": 60, //传送请求过期时间
"promptType": "form" //传送请求类型
},
"Home": { //家系统模块
"add": 0, //添加家花费
"del": 0, //删除家花费
"tp": 0, //传送家花费
"MaxHome": 10 //最大家数量
},
"Fcam": { //灵魂出窍模块
"EnableModule": false, //是否开启该功能(true/1开启,false/0关闭)
"CostMoney": 0, //使用该功能花费的金钱
"TimeOut": 0 //灵魂出窍使用时间限制
},
"wh": { //服务器维护模块
"EnableModule": true, //是否开启该功能(true/1开启,false/0关闭)
"status": 0, //维护状态(1维护中,0未维护)
"whmotdmsg": "服务器维护中,请勿进入!", //维护时MOTD提示,支持彩色
"whgamemsg": "服务器正在维护中,请您稍后再来!" //维护时进服拦截提示,支持彩色
},
"Motd": { //动态MOTD模块
"EnabledModule": true, //是否启用修改MOTD功能,默认开启
"message": [ "Bedrock_Server", "Geyser" ] //动态MOTD轮播内容
},
"Notice": { //公告模块
"EnableModule": false, //是否开启公告功能
"Join_ShowNotice": false, //是否在加入服务器时弹出
"IsUpdate": false //公告是否更新过,为true时下次所有玩家都会弹出
},
"Crash": { //崩端模块
"EnabledModule": true, //崩端功能开关
"LogCrashInfo": true //是否打印操作日志
},
"Economy": { //经济模块
"mode": "scoreboard", //经济模式(llmoney或scoreboard)
"PayTaxRate": [ //阶梯税收
{ "min": 0, "max": 1000, "rate": 0 },
{ "min": 1000, "max": 10000, "rate": 2 },
{ "min": 10000, "max": 100000, "rate": 5 },
{ "min": 100000, "max": -1, "rate": 10 }
],
"RankingModel": "New", //金币排行榜样式(New或Old)
"Scoreboard": "money", //计分板项名称,不可填中文!
"CoinName": "金币" //货币名称
},
"Suicide": { //自杀模块
"EnabledModule": true, //自杀功能总开关
"cost": 0, //自杀所花费的金钱
"cooldown": 0 //冷却时间(秒),0为不限制
},
"Back": { //死亡点传送模块
"EnabledModule": true, //死亡点传送总开关
"cost": 0, //返回死亡点花费的金钱
"cooldown": 0, //冷却时间(秒),0为不限制,仅传送成功后计入
"tipAfterDeath": false //重生后是否自动弹出返回GUI
},
"SimpleLogOutPut": false, //简洁的日志输出,默认为关闭
"Warp": 0, //前往公共传送点花费的金钱
"KeepInventory": 1, //开服是否自动开启死亡不掉落
"Version": 295 //版本标识符,勿动!
}
./Config/UpdateConfig.json (插件更新的配置文件)
JSON:
"Update": { //自动更新配置项
"EnableModule": true, //是否开启自动更新功能
"CheckInterval": 120, //定时检查新版本(单位分钟,0关闭,最小值120)
"versionUrl": "https://plugin.tobecraft.xyz/file/manifest.json", //区别版本号的网址
"baseUrl": "https://plugin.tobecraft.xyz/file/", //下载文件的网址
"files": [ //需要更新的模块/本体
{
"url": "YEssential.js",
"path": "YEssential.js"
},
{
"url": "modules/I18n.js",
"path": "./modules/I18n.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"
},
{
"url": "modules/PVP.js",
"path": "./modules/PVP.js"
},
{
"url": "modules/Redpacket.js",
"path": "./modules/Redpacket.js"
},
{
"url": "modules/Fcam.js",
"path": "./modules/Fcam.js"
},
{
"url": "modules/Notice.js",
"path": "./modules/Notice.js"
},
{
"url": "modules/Sign.js",
"path": "./modules/Sign.js"
},
{
"url": "modules/Crash.js",
"path": "./modules/Crash.js"
},
{
"url": "modules/Warp.js",
"path": "./modules/Warp.js"
},
{
"url": "modules/PluginInfo.js",
"path": "./modules/PluginInfo.js"
},
{
"url": "modules/Home.js",
"path": "./modules/Home.js"
},
{
"url": "modules/CachePool.js",
"path": "./modules/CachePool.js"
},
{
"url": "modules/WriteBackStore.js",
"path": "./modules/WriteBackStore.js"
}
],
"reloadDelay": 1000, //自动重载延迟
"timeout": 30000, //检查更新超时时间
"checkMissingFilesOnStart": true //是否在开服时检查有无缺失文件
},
./Config/Cleanmgr/Config.json(未说明即0[false]为关闭,1[true]为开启):
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$",
"^minecraft:copper_golem$"
],
"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 //玩家执行清理冷却时长(单位/秒)
}
}
./Config/Cd/Config.json (菜单的配置文件)
格式如下:
JSON:
{
"money": 0, //经济模式 0为计分板 1为LLMoney
"itemsTriggerMode": 0, //触发方式(保留字段,当前右键方块与右键空气均可触发)
"score": "money", //计分板名称
"items": [ //菜单触发物品列表,可配置多个
"minecraft:clock"
],
"main": "main", //主菜单文件名
"shield": [], //屏蔽方块列表
"UseDogeUI": 0 //是否启用DogeUI兼容
}
./Config/Sign/Config.json (签到的配置文件)
格式如下:
JSON:
{
"version": "1.0.0", //签到模块版本号
"sign": {
"switch": true, //是否开启
"gui_arrange": 3 //每列签到显示的物品数量
},
"random_money": { //随机金币范围
"min_money": 1000,
"max_money": 10000
},
"random_exp": { //随机经验范围
"min_exp": 100,
"max_exp": 1000
},
"reward": [ //签到战利品
"item_1",
"item_2",
"money_1000",
"money_1000",
"random_money",
"item_1",
"money_1000"
],
"addition": { //连续签到战利品
"3": "item_1",
"5": "money_500",
"7": "item_2",
"15": "item_2",
"30": "money_2000"
}
}
[部分数据文件位置一览]
- config.json (插件总配置)
2.2.9之后在.\plugins\YEssential\Config\目录下
- server.json (跨服传送配置)
2.2.9之后在.\plugins\YEssential\data\TrSeverData目录下
- zh_cn.json (语言文件,原lang.json)
2.2.9之后在.\plugins\YEssential\lang\目录下
- tpaAutoRejectConfig.json
2.2.9之后在.\plugins\YEssential\TpaSettingsData\目录下
玩家可以使用/tpa设置
- RTPData.json
2.2.9之后在.\plugins\YEssential\RTPData\目录下
玩家可以使用/rtp随机传送,/rtpreset 重置时间(Only OP)
- pvp_data.json
玩家可以使用/pvp指令切换PVP功能
- notice.json
2.2.9之后在.\plugins\YEssential\NoticeSettingsData\目录下
/notice内的不再提示的开关数据文件
- notice.txt
2.2.9之后在.\plugins\YEssential\NoticeSettingsData\目录下
这是输入/notice打开的GUI显示的东西
- MoneyHistory.json
2.2.9之后在.\plugins\YEssential\MoneyHistory\目录下
2.4.0之后在.\plugins\YEssential\Money\目录下
这是所有玩家的转账历史记录
[食用方法]
丢入/服务端目录/plugins/即可
迁移TMET基础插件配置文件教程:
- 把 服务端目录\plugins\Timiya\data内的homelist.json和warplist.json
- 移动到服务端目录\plugins\YEssential\data内并且分别重命名为homedata.json和warpdata.json然后保存即可
迁移PMenu菜单插件配置文件教程:
- 把 服务端目录\plugins\Planet\PMENU\packs内的所有东西
- 移动 到 服务端目录\plugins\YEssential\data\menus内即可
贡献:
- 欢迎提交 Issue 和 Pull Request到Github上,共同完善 YEssential。