Donut Essentials

插件

· 作者 NAIZO

惩罚、IP锁定、维护模式,以及更多功能……

0 本站下载 0 关注 更新于 3 周前

最新 3.0.0 · 26.3 · Folia / Paper

一键开服(送7天)

Donut Essentials 3.0: The All-in-One Update

你的服务器所需的一切基础插件,全部免费

Donut Essentials 是一款面向 Paper、Folia 和 Purpur(兼容 Minecraft 1.20.1 至 26.3)的免费开源基础插件,所有功能集成在一个 jar 包中。

包含家园、传送点、出生点和随机传送。支持带有可点击 [接受] [拒绝]按钮的传送请求。完美保留物品细节的套装。内置 Vault 经济系统。聊天格式、私聊、离线邮件以及 AFK 状态。还有 Donut Essentials 闻名的管理套件,现已新增历史记录、小号检测、冻结玩家和举报功能。所有功能均提供菜单界面,全部支持 Folia,且除非你主动要求,否则不会接管原版命令。

3.0 "The All-in-One Update" 将管理工具集转变为一个完整的基础插件:

  • 传送:带按钮的 TPA、/back、移动或受到伤害即取消的标题倒计时、等级分层和战斗标记;
  • 家园、传送点和出生点均配备菜单,并支持安全的随机传送;
  • 基于你的背包创建套装,提供套装菜单、预览、冷却时间、一次性套装和费用设置;
  • 经济系统支持 /pay、/baltop(一个菜单)以及向离线玩家展示支付记录;
  • 聊天格式支持 LuckPerms 前缀、提及、[item]、/msg、/mail、/ignore 和 AFK;
  • 管理历史记录、警告升级、小号警报、冻结、举报、员工聊天和 Discord 日志;
  • 新玩家接受的规则屏幕(1.21.7+ 上的原生对话框)、服务器链接和一个玩家中心;
  • /donutessentials import essentials:一键从 EssentialsX 切换过来。

每次发布版本都会在 16 个运行着 1.20.1 至 26.3 版本的 Paper 和 Folia 服务器上由机器人进行测试,包括从 2.0.0 升级、从 EssentialsX 切换以及 MySQL 存储迁移。

A home teleport: the countdown, then there

divider

The Player Hub

Everything in one menu

/menu 打开一个玩家中心:包含家园、传送点、套装、出生点、随机传送、金钱、邮件和设置,头顶显示玩家的余额、家园数量和游戏时长。关闭的命令对应的按钮会自动消失。

  • 每个菜单都在 menus.yml 中配置:包括标题、大小、槽位、物品、名称和描述,长列表支持分页。
  • /settings 为每位玩家提供个人开关:传送请求、自动接受、私聊、提及提醒、支付和加入消息。

Teleports

Teleports done right

  • /tpa 和 /tpahere 带有 [接受] [拒绝] 按钮,发送者可使用 [取消]。/tptoggle 拒绝请求,/tpauto 接受所有请求。
  • 统一的传送引擎用于处理家园、传送点、出生点、请求、/back 和随机传送:采用标题倒计时,移动或受到伤害即取消,每种类型都有独立的冷却时间和费用。
  • 等级分层 (donutessentials.tier.vip):更短的预热时间、冷却时间和费用,更多的家园数量。
  • /back 返回到你传送前的位置,或者死亡的位置。
  • 战斗标记:被玩家攻击或攻击玩家时,双方都会被标记 15 秒,动作栏显示计时器。被标记的玩家无法传送或使用你列出的命令,且在战斗中登出会直接杀死该玩家。

Homes

Homes

  • /sethome、/home、/delhome 以及一个家园菜单:点击前往,Shift + 右键删除,还有一个按钮在你站立的位置设置家园。每个图标都显示所在的维度。
  • 数量限制基于默认值、等级分层和 donutessentials.homes.<n>;某些世界可以禁用家园。
  • 工作人员可以访问任何人的家园:使用 /home Kiri:base、/homes Kiri。

Warps & Spawn

Warps and spawn

  • /setwarp shop 使用你手中的物品作为图标。/warps 列出每个传送点及其位置和访问次数;可选的单个传送点权限。
  • /spawn 和 /setspawn,以及用于设定新玩家初始位置的 /setspawn first。首次加入时、每次加入时(可选)以及在重生点没有床时重生到出生点。
  • /rtp:在出生点周围的环形区域内选择一个安全的随机地点(无水源、岩浆或仙人掌;禁止的生物群系),按世界区分。后台加载区块。如果安装了 Donut RTP,它将让路。

Kits

Kits that keep everything

  • /createkit warrior 1d 基于你的背包创建一个套装**,手中物品为其图标。/editkit 打开它以进行修改。
  • 保留每件物品的所有细节:附魔、属性、名称、描述、自定义模型数据、书籍和药水,存储在 Paper 的版本化物品格式中,使套装能够经受住 Minecraft 更新。
  • 套装菜单以就绪、冷却中、已领取或锁定状态显示每个套装;右键预览物品。
  • 冷却时间、一次性套装、费用、每个套装的权限、首次加入套装,以及供工作人员使用的 /kit warrior Kiri。

Economy

内置经济系统

  • 通过 Vault 注册的内置经济系统,商店和职业插件均可使用。如果安装了其他经济插件,它将优先生效,Donut Essentials 会转而使用该插件。
  • /balance、/pay Kiri 2.5k、/paytoggle 以及最富玩家菜单(/baltop)。
  • 离线期间的交易记录在玩家上线时会列出。
  • /eco give|take|set|reset 支持对离线玩家及控制台操作。提供每日经济日志。
  • 初始余额、余额上限、最小支付金额及货币格式均由您自定义设置。

聊天与消息

聊天和消息

  • 聊天格式支持来自权限插件(通过 Vault 的 LuckPerms)和 PlaceholderAPI 的前缀与后缀,且可为每个用户组设置独立格式。
  • [item] 显示你手中物品的完整工具提示。提及(Mentions) 功能可高亮并提醒被提及的玩家。
  • 基于权限的颜色、反垃圾信息、词过滤器、链接屏蔽、/chat clear|lock|slow、带标题的 /broadcast 以及自动公告。
  • /msg、/r、/ignore、/msgtoggle 和社会间谍功能。邮件(/mail send)在接收者离线时等待发送,并通过 [Read] 按钮进行通知。
  • AFK(闲置):/afk [reason],空闲指定分钟后自动标记,标签页列表显示 [AFK],且 AFK 玩家不会阻碍跳过夜晚。
  • /nick 支持基于权限的颜色(禁止复制其他玩家的名字)和 /realname。

管理功能

内置管理功能

  • 封禁、临时封禁、静音、警告、备注、踢出和 IP 封禁,支持 ID、静默模式(-s)、理由布局(@cheating)和时间布局(#1st-offence)。
  • 历史记录:为每位玩家提供(/history、/check、/banlist),支持 /change-reason 和记录删除。
  • 警告升级机制:例如第三次警告将导致一小时静音。
  • 小号检测:/alts 列出在同一地址登录的账号,当有人从被封禁账号的地址登录时,工作人员会收到警报。
  • 冻结玩家(禁止移动、建造或使用命令);登出行为可被记录或直接封禁。
  • 举报:/report Rook flying;工作人员可获得 [Teleport] [Claim] 按钮和 /reports 菜单。
  • 工作人员聊天(/sc)、指令监视,以及通过频道 Webhook 发送到 Discord 的处罚和举报日志,无需机器人。

工作人员工具

工作人员工具

  • 隐身(Vanish) 让你在所有地方隐形:加入和离开消息、标签页列表、物品拾取、生物和在线人数均不可见。重新加入服务器后隐身状态依然保持。
  • /invsee(实时查看,按权限编辑)、/endersee、/whois、/seen、/offlinetp 和 /playerlist。
  • 维护模式:支持白名单、定时器和独立的服务器列表消息,以及针对工作人员账号的 IP 锁定(支持地址、通配符 1.2.3.* 和范围 1.2.3.0/24)。
  • /fly、/god、/heal、/feed、/speed、/gm、/hat、/repair、/top、/near、/day、/night 等更多功能。

规则与服务器链接

规则和服务器链接

  • 启用 rules.require-accept 后,新玩家会在聊天、建造或使用命令前看到一个必须接受的 规则界面:1.21.7+ 版本使用 原生对话框,之前版本则为可点击按钮。修改规则并提升版本号后,所有玩家需重新接受。
  • 暂停菜单中的服务器链接(Minecraft 1.21+):Discord、网站、商店等。
  • 加入时的每日公告(/motd)和带有玩家编号的 首次加入消息。

个性化定制

你的服务器,由你定义

  • 每个模块均可在 config.yml 中关闭:其命令、监听器和任务将被移除。
  • commands.yml:可关闭或重命名任何命令并添加别名。原版命令(/gamemode、/give、/tp...)默认不会被接管,除非你手动列出;我们的命令仍可通过 /donutessentials:<name> 访问。
  • 命令规则:为任何命令设置冷却时间或费用,包括其他插件的命令。
  • messages.yml 中的所有消息均使用 MiniMessage(或 & 代码),menus.yml 中定义所有菜单,config.yml 中配置所有声音。每次更新都会新增设置项,而不会影响你现有的配置。
  • 单一数据库:支持 SQLite,或带表前缀的 MySQL/MariaDB。

从 EssentialsX 切换

一键切换

  1. 在 EssentialsX 旁安装 Donut Essentials 并启动服务器。
  2. 运行 /donutessentials import essentials 进行 试运行:预览将导入的内容,此时不会发生任何更改。
  3. 运行 /donutessentials import essentials confirm。余额、家园、昵称、忽略列表、传送点、出生点、套装和封禁记录 将迁移过来。Donut Essentials 已存在的名称将予以保留。
  4. 移除 EssentialsX。

从 2.x 版本升级

就地升级

替换 jar 文件并重启。Donut Essentials(或 Fssentials)2.x 在首次启动时进行升级:

  • 惩罚、IP 锁定和维护白名单 移至数据库(旧文件重命名为 .imported)。
  • config.yml 保留您的配置值(旧文件保存为 config-2.x.yml);messages.yml 替换为 3.0 版本的消息文件(您的原文件保存为 messages-2.x.yml)。
  • 2.x 版本的命令、惩罚语法和权限节点(fssentials.*、donutessentials.punish.*)继续有效。
  • 所有新功能默认启用。您可以在 modules: 下关闭不需要的功能。

Integrations

Integrations

以下均为可选集成:

插件 Donut Essentials 的功能
Vault (或 VaultUnlocked) 注册其经济系统;读取聊天所需的前缀、后缀和组别信息
LuckPerms (或任何支持 Vault 的权限插件) 聊天前缀和组格式、等级阶层
PlaceholderAPI 30+ 个占位符(余额、baltop、家园、AFK、战斗、游戏时长...),以及聊天格式、MOTD 和公告中的占位符
MariaDB 或 MySQL 替代 SQLite 存储,支持表前缀
Discord 通过频道 Webhook 发送管理日志和举报日志
Donut RTP 安装后接管 /rtp 命令

对于开发者:提供 DonutEssentials.getApi()(包含玩家、家园、传送点、礼包、余额、惩罚、AFK、隐身、战斗等功能)以及九个事件,从 EssentialsTeleportEvent 和 KitClaimEvent 到 PaymentEvent 和 PunishmentCreateEvent。

Compatibility

Tested from 1.20 to 26.3

服务器端 Minecraft 版本 Java 版本
Paper, Purpur 及其他 Paper 分支 1.20.1 – 1.20.4 17
Paper, Purpur 及其他 Paper 分支 1.20.5 – 1.21.11 21
Paper, Purpur 及其他 Paper 分支 26.1 – 26.3 25
Folia 1.20.1 – 26.3 17 – 25

一个 jar 包适用于以上所有服务端。原生对话框需要 1.21.7 或更高版本,服务器链接需要 1.21;旧版服务器将使用聊天按钮。不支持 Spigot 和 Bukkit(因为它们缺少 Paper 的 API):插件会提示并停止加载。

每个版本都会在 Paper 1.20.1、1.20.4、1.20.6、1.21.1、1.21.4、1.21.8、1.21.11、26.1.2、26.2 和 26.3 以及 Folia 1.20.4、1.21.4、1.21.11 和 26.3 上进行测试,分别使用 SQLite 和 MySQL,以及有 Vault、VaultUnlocked 和无 Vault 的情况:每次测试约包含 40 项检查,从首次加入直到重启,包括从 2.0.0 版本升级以及从 EssentialsX 迁移的过程。控制台必须保持无错误状态。

Commands & Permissions

区域 玩家 工作人员
传送 /tpa, /tpahere, /tpaccept, /tpdeny, /tpacancel, /tptoggle, /tpauto, /back, /rtp /tphere, /tpo
家园 /sethome, /home, /delhome, /homes /home <player>:<home>, /homes <player>
传送点和出生点 /warp, /warps, /spawn /setwarp, /delwarp, /setspawn [first]
礼包 /kit [kit], /kits /createkit, /editkit, /delkit, /kit <kit> <player>
经济 /balance, /pay, /paytoggle, /baltop /eco give|take|set|reset
聊天和消息 /msg, /r, /ignore, /msgtoggle, /mail, /afk, /realname /chat, /broadcast, /nick, /socialspy
管理 /report /ban, /tempban, /mute, /tempmute, /warn, /kick, /note, /banip, /unban... /history, /check, /alts, /freeze, /reports, /sc, /commandspy
工作人员专用 /vanish, /invsee, /endersee, /whois, /offlinetp, /maintenance, /iplock
其他所有功能 /menu, /settings, /rules, /motd, /seen, /playtime, /ping, /trash /fly, /god, /heal, /feed, /speed, /gm, /craft, /enderchest, /hat, /repair, /top, /near, /day, /night
管理员 /donutessentials info|reload|import essentials (/dess)

每个命令都拥有权限 donutessentials.command.<name>:玩家命令默认对所有用户开放,工作人员命令默认对操作员开放。此外还有以下权限:

权限 默认拥有者 说明
donutessentials.tier.<name> 无 等级阶层:更快速、更便宜的传送以及更多家园数量
donutessentials.homes.<n> 无 家园数量限制
donutessentials.bypass.warmup, .cooldown, .cost op 绕过传送规则
donutessentials.kit.<name> 无 特定礼包访问权限(当该功能开启时)
donutessentials.chat.color, .item op, everyone 聊天颜色、[item] 标签
donutessentials.vanish.see, donutessentials.invsee.edit op 工作人员相关
donutessentials.* op 除豁免和绕过节点外的所有功能

Questions

它可以替代 EssentialsX 吗? 对于大多数服务器来说可以:它涵盖了传送、家园、传送点、出生点、礼包、经济、聊天、消息、邮件、AFK、管理以及日常实用工具。使用 /donutessentials import essentials 可以将您的数据迁移过来。监狱、传送门、全息图和告示牌商店则留给更专业的插件处理。

它能在 Folia 上运行吗? 是的,所有功能均支持,涵盖从 1.20.1 到 26.3 的所有 Folia 版本。

它会破坏 /gamemode 或 /tp 等原版命令吗? 不会。除非您将它们添加到 commands.take-over-vanilla 中,否则原版命令将保持原版行为。

我只想要管理工具。 请在 config.yml 的 modules: 下关闭其他模块。已关闭的模块不会加载任何内容。

它需要 Vault 吗? 不需要。仅当其他插件需要查看其经济系统,或者需要从您的权限插件获取聊天前缀时,才需要 Vault(或 VaultUnlocked)。

多个服务器? 目前每个服务器使用一个独立的数据库;跨网络共享处罚功能已在开发计划中。

我的 2.x 版本处罚数据会保留吗? 会的。首次启动时它们会被迁移至数据库中;无论如何,请先备份 plugins/DonutEssentials/ 目录。

画廊

玩家中心

各世界中的家

套件物品,细节俱全

规则界面

带前缀、提及和 [物品] 的聊天

管理功能

服务器链接

分割线

Discord: discord.gg/TJc3CxR4jK · 源码: GitHub (Apache 2.0 协议) · 支持本项目: nightbeam.dev/support

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源