Serversentials

插件

· 作者 JollyJoe

Essentials 的现代替代品,支持 Folia 和 Velocity 网络!

0 本站下载 0 关注 更新于 5 个月前

最新 2.2 · 1.21.11 · Folia / Paper

一键开服(送7天)

Serversentials

一套高性能、网络兼容且支持 Folia 的工具套件,旨在替代现代 Minecraft 服务器和代理网络上的传统 Essentials 插件。


Servesentials Banner

概述

Essentials 类套件在部署到多线程的 Folia 环境或跨代理网络同步时往往表现不佳。

Serversentials 从底层构建以解决这些平台限制。它作为一个统一的、高性能的混合 JAR 运行,能够同时在后端服务器(Paper、Folia)和代理服务器(Velocity)上加载运行。

架构亮点

  • Folia 优化: 异步执行以及全局/区域特定的任务调度,确保与 Folia 的多线程区域模型完全兼容。
  • 混合 JAR 架构: 同一个插件文件同时加载在后端游戏服务器和你的 Velocity 代理上。
  • 双方言存储: 由 HikariCP 驱动的高性能数据库操作,支持本地 SQLite 文件存储或网络同步的 MySQL 数据库。
  • 自动配置迁移器: 在插件更新时无缝升级配置文件,同时保留自定义值、格式和内联注释。

功能详解

网络传送与移动

  • 跨服务器传送: 在你的代理网络上通过基于请求的 /tpa 和 /tpahere 命令在不同服务器之间进行传送。包含管理员绕过命令 (/tpo 和 /tpohere)。
  • 会话追踪: 使用 /back 命令跳回你在其他服务器上的上一个位置或死亡坐标。
  • 实用传送: 使用 /rtp 传送到世界边界内的随机安全坐标,或使用 /top 跳转到你坐标上方的最高方块处。
  • 传送点与家园: 设置多家园档案(受权限上限控制)和全局传送点,支持自定义预热时间和冷却计时器。

聊天与消息

  • 跨服务器私聊: 使用 /msg 和 /reply 在整个网络中进行私密消息传递,并内置用于管理目的的 /socialspy。
  • 工作人员通信: 使用 /staffchat 专用频道在网络上私下协调工作。
  • 现代聊天渲染器: 完全自定义的聊天格式化引擎,支持 MiniMessage 语法,并与 Vault/LuckPerms 的前缀、后缀及显示名称集成。
  • 连接事件: 自定义加入和离开消息,支持 PlaceholderAPI,可独立配置开启或关闭。

额外物品栏 (/inv)

  • 多档案物品栏: 允许玩家解锁并在最多 11 个独立的物品栏档案之间切换(1 个基础档案 + 10 个额外槽位)。
  • 交互式 GUI: 在自定义的 54 格箱子界面中预览档案,展示盔甲、副手物品和玩家详情。
  • 管理功能: 按需使用 /inv view 和 /inv clear 查看或清空玩家物品栏。
  • 撤销保护: 如果玩家失去某个物品栏的权限,该物品栏将设置为“锁定”状态,允许他们安全地取出物品,但防止存入新物品。
  • 自定义 NBT 支持: 安全地序列化复杂的自定义 NBT 数据,使其完全兼容如 Nexo 等自定义物品插件。

经济系统

  • 网络交易: 使用 /pay 向同一服务器或跨代理网络的玩家发送货币。
  • Vault 集成: 完全钩入 Vault,作为强大的服务器经济提供商。
  • 排行榜: 使用 /baltop 显示顶级货币持有者统计数据。

Moderation & Administration (管理与行政)

  • 实时视角监控: /monitor 命令允许管理员进入旁观者模式以监控玩家的视角(本地或跨服务器),退出后可安全返回其原始服务器、坐标和游戏模式。
  • 隐身集成: 在加入查询中隐藏隐身玩家,并与 TAB/TAB-bridge 集成,自动从全局标签列表中移除隐身玩家。
  • 建议过滤: 动态过滤命令补全建议,使玩家仅能看到他们有权限执行的命令。

安装指南

单服务器设置

  1. 下载 Serversentials.jar 文件。
  2. 将 jar 文件放入服务器的 plugins/ 目录中。
  3. 启动服务器以生成默认配置文件。

代理网络设置 (Velocity + 后端服务器)

  1. 将 Serversentials.jar 文件放入你的 Velocity 代理 的 plugins/ 文件夹中。
  2. 将相同的 Serversentials.jar 文件放入所有后端 Paper/Folia 服务器 的 plugins/ 文件夹中。
  3. 启动代理和后端服务器以生成默认配置文件。
  4. 在每个后端服务器上,编辑 plugins/Serversentials/config.yml,并将 server-name 键设置为与 Velocity velocity.toml 配置中注册的服务器名称完全匹配(例如 lobby、survival-1)。
  5. 重启后端服务器以初始化网络同步。

命令与权限参考

1. 传送与移动

命令与参数 别名 描述 权限节点
/tpa <player> - 请求传送至某玩家 serversentials.tpa
/tpahere <player> tpah 请求某玩家传送至你处 serversentials.tpahere
/tpaccept tpc 接受待处理的传送请求 serversentials.tpaccept
/tpdeny tpd 拒绝待处理的传送请求 serversentials.tpdeny
/tptoggle tpt 切换接收传送请求的状态 serversentials.tptoggle
/tpo <player> - 强制传送至某玩家(管理员绕过) serversentials.tpo
/tpohere <player> - 强制将某玩家传送至你处(管理员绕过) serversentials.tpohere
/back - 返回上一个位置或死亡地点 serversentials.back
/rtp - 传送至随机的安全位置 serversentials.teleport.rtp
/top - 传送至你上方最高的方块处 serversentials.teleport.top

2. 消息与通信

命令与参数 别名 描述 权限节点
/msg <player> <message> w, tell, pm, message 发送私人消息(跨服务器) serversentials.msg
/r <message> reply 回复最后收到的私人消息 serversentials.reply
/socialspy - 切换监听私人消息的功能 serversentials.socialspy
/sc <message> staffchat 向工作人员频道广播消息 serversentials.staffchat

3. 额外物品栏

命令与参数 别名 描述 权限节点
/inv list inventory 打开额外物品栏选择界面 serversentials.extrainv
/inv <1-11> inventory 快速切换至特定的物品栏槽位 serversentials.extrainv
/inv view <player> [slot] inventory 查看玩家的额外物品栏(管理员) serversentials.extrainv.admin
/inv clear <player> [slot] inventory 清空玩家的额外物品栏(管理员) serversentials.extrainv.admin

4. 玩家自定义与经济系统

命令与参数 别名 描述 权限节点
/nick <name> - 设置自定义显示名称/昵称 serversentials.nick
/nick off - 清除当前激活的昵称 serversentials.nick
/whois <nickname> - 揭示昵称背后的真实用户名 serversentials.whois
/balance [player] bal 检查玩家的当前账户余额 serversentials.balance
/pay <player> <amount> - 向其他玩家转账 serversentials.pay
/economy <give|set|deduct> <player> <amount> eco 修改玩家余额(管理员) serversentials.economy
/baltop [page] - 显示服务器余额排行榜 serversentials.baltop

5. 管理功能与服务端管理

命令与参数 别名 描述 权限节点
/monitor <player> mon 开始以旁观者视角观察某玩家 serversentials.monitor
/monitor mon 停止旁观并恢复原始状态 serversentials.monitor
/vanish [player] v 切换隐身/消失状态 serversentials.vanish
/invsee <player> - 查看或修改某玩家的物品栏 serversentials.invsee
/heal [player] - 恢复玩家生命值 serversentials.heal
/feed [player] - 恢复饥饿值条 serversentials.feed
/god [player] - 切换无敌状态 serversentials.god
/ssreload - 重新加载配置文件 serversentials.reload

6. 家与传送点

命令与参数 别名 描述 权限节点
/home [name] - 传送至已设置的家坐标 serversentials.home
/sethome [name] - 在你当前位置创建家园点 serversentials.sethome
/delhome <name> - 删除现有的家园点 serversentials.delhome
/homes [player] - 列出你的家园或其他玩家的家园 serversentials.homes
/warp <name> - 传送至公共传送点 serversentials.warp
/setwarp <name> - 设置一个公共传送点 serversentials.setwarp
/delwarp <name> - 移除一个公共传送点 serversentials.delwarp
/warps - 列出所有可用的传送点 serversentials.warps

7. 实用 GUI 与物品编辑器

命令与参数 别名 描述 权限节点
/craft - 打开便携式工作台 GUI serversentials.craft
/echest [player] ec 打开某玩家的虚拟末影箱 serversentials.echest
/anvil - 打开便携式铁砧 GUI serversentials.anvil
/loom - 打开便携式织布机 GUI serversentials.loom
/stonecutter scutter 打开便携式切石机 GUI serversentials.stonecutter
/smithingtable smith 打开便携式锻造台 GUI serversentials.smithingtable
/item <material> [amount] i 生成指定数量的物品(管理员) serversentials.item
/itemrename <name> iname, itemname 重命名手中物品的显示名称 serversentials.itemrename
/lore <add|set|insert|delete|clear> [index] [text] - 修改物品背景文本行 serversentials.lore
/enchant <enchantment> [level] [player] ench 对手中物品施加自定义附魔 serversentials.enchant

8. 世界与环境

命令与参数 别名 描述 权限节点
/day - 将本地世界时间设置为白天 serversentials.worldcommands
/noon - 将本地世界时间设置为正午 serversentials.worldcommands
/night - 将本地世界时间设置为夜晚 serversentials.worldcommands
/clear sun 将本地天气设置为晴天 serversentials.worldcommands
/rain - 将本地天气设置为下雨 serversentials.worldcommands
/storm - 将本地天气设置为暴风雨 serversentials.worldcommands

PlaceholderAPI 集成

需要 PlaceholderAPI。如果使用 Folia,请使用兼容 Folia 的分叉版本。

占位符 描述 示例输出
%serversentials_name% 玩家的原始用户名 Jolly
%serversentials_displayname% 格式化后的昵称(回退到用户名),解析为传统节码格式 &c[Admin] &eJolly
%serversentials_nickname% 当前生效的昵称(回退到用户名),解析为传统节码格式 &eJollyJoe
%serversentials_nickname_raw% 存储在数据库中的原始 MiniMessage 格式昵称字符串 <gold>JollyJoe
%serversentials_has_nickname% 如果玩家设置了当前生效的昵称则返回 true,否则返回 false true
%serversentials_isflying% 如果玩家当前正在飞行则返回 true,否则返回 false false
%serversentials_gamemode% 玩家当前的游戏模式 SURVIVAL
%serversentials_ping% 玩家当前的延迟 24
%serversentials_vanished% 如果玩家已隐身则返回 true,否则返回 false false
%serversentials_hidden% 如果玩家对其他玩家隐藏则返回 true,否则返回 false false
%serversentials_godmode% 如果玩家处于创造/无敌模式则返回 true,否则返回 false false
%serversentials_teleport_toggle% 如果玩家接受传送请求则返回 true,否则返回 false true
%serversentials_active_inventory_slot% 玩家当前激活的物品栏槽位编号(1-11) 2
%serversentials_inventory_max_slots% 玩家拥有权限的物品栏总槽位数(1-11) 5
%serversentials_fly_speed% 玩家的飞行速度倍率(0-10) 2.0
%serversentials_walk_speed% 玩家的行走速度倍率(0-10) 2.0
%serversentials_eco_balance% 玩家的原始经济余额 542.50
%serversentials_eco_balance_formatted% 格式化后的玩家经济余额 $542.50

配置

server-name: "default"
# 如果在 Velocity 网络中使用,请将其更改为此服务器在 velocity.toml 文件中配置的服务器名称
# 如果是单机运行,无需更改此项
# 如果在代理网络中运行,请正确设置此项以避免传送问题!!!

database:
  type: sqlite # 或 "mysql";如果你尚未设置 MySQL 服务器,请使用 sqlite
  # SQLite 选项
  file: serversentials.db
  # MySQL 选项(仅在 type = mysql 时使用)
  host: localhost
  port: 3306
  database: serversentials
  username: root
  password: ""
  useSSL: false
  pool-size: 10

modules:
  # serversentials.home <- /home 和 /sethome
  # serversentials.sethome.<#> <- 家园数量
  # serversentials.home.cooldown.<#> <- /home 命令的冷却时间
  # servesentials.home.countdown.<#> <- 传送前的倒计时
  home: true
  nick: # serversentials.nick
    enabled: true
    maxlength: 32 # 这包括 MiniMessage 格式 <red>JollyJoe <- 计为 13 个字符
  #---------TELEPORTS----------
  tpa: #serversentials.tpa
    enabled: true
    expiration: 20 # 传送请求过期前的秒数
  tpahere: # serversentials.tpahere
    enabled: true
    expiration: 20 # 传送请求过期前的秒数
  tptoggle: true # serversentials.tptoggle <- 切换传送请求的开启/关闭
  tpo: true # serversentials.tpo <- Tpa 覆盖
  tpohere: true # serversentials.tpohere <- Tpahere 覆盖

# serversentials.warp <- /warp
  # serversentials.warp.<warpname> <- /warp <name>
  # serversentials.setwarp <- /setwarp
  # serversentials.warp.cooldown.<#>
  # serversentials.warp.countdown.<#>
  warp: true
  teleport:
    top: true
    rtp: true #推荐使用我的 RTP 插件以获得更多配置选项!
    back: true
    # https://modrinth.com/plugin/rtp-gui (如果你安装了该插件,请将 rtp 设置为 false)
  #---------实用工具----------
  craft: true # serversentials.craft
  anvil: true # serversentials.anvil
  loom: true # serversentials.loom
  echest: true # serversentials.echest
  stonecutter: true # serversentials.stonecutter
  smithingtable: true # serversentials.smithingtable
  #--------- Moderation(管理功能)-----------
  invsee: true # serversentials.invsee
  vanish: true # serversentials.vanish || serversentials.vanish.see || serversentials.vanish.others
  gamemode: true # serversentials.gms/gmc/gmsp || serversentials.gms/gmc/gmsp.others
  fly: true # serversentials.fly || serversentials.fly.others
  flyspeed: true # serversentials.flyspeed || serversentials.flyspeed.others
  walkspeed: true # serversentials.walkspeed || serversentials.walkspeed.others
  monitor: true # serversentials.monitor
  extra-inventories: true # serversentials.extrainv || serversentials.extrainv.amount.<1-10> || serversentials.extrainv.admin
  #---------额外功能----------
  heal: true # serversentials.heal || serversentials.heal.others
  feed: true # serversentials.feed || serversentials.feed.others
  god: true # serversentials.god || serversentials.god.others
  item: # serversentials.item || serversentials.item.others <- /item 命令
    enabled: true
    respect-max-stack-size: true # true = 不允许超出最大堆叠数量的物品堆
  enchant:
    respect-max-levels: true # true = 不允许超过上限的附魔等级
  worldcommands: true #/day, /night, /noon, /clear, /rain, /storm
  #---------经济系统-------
  economy:
    enabled: true
    starting-balance: 100.0
    currency-symbol: "$"
    formatted: true # true = 显示千位分隔符和小数位,false = 纯数字
    decimals: 2 # 小数位数

cross-server-pay: true # 启用跨服务器转账功能,允许在网络中的其他服务器上向玩家发送货币
  #---------聊天格式化---------
  chat:
    enabled: true
    cross-server-chat: false # 启用此选项以在网络中的所有服务器之间中继聊天消息
    # 聊天格式 —— 支持 PlaceholderAPI 占位符及内置占位符:{server}、{player}、{prefix}、{suffix}、{message}
    # {player} 使用显示名称(尊重 /nick 命令)
    # LuckPerms 示例:"%luckperms_prefix%{player} <dark_gray>»</dark_gray> {message}"
    chat-format: "<dark_gray>[<aqua>{server}</aqua>]</dark_gray> <gray>{prefix}</gray><white>{player}</white><gray> » {message}</gray>"
    # 加入/离开消息 —— 支持 PlaceholderAPI 占位符和 {player}
    # 将 enabled 设置为 false 可完全隐藏该消息
    join-message:
      enabled: true
      format: "<green>+ <yellow>{player} <gray>加入了服务器"
    leave-message:
      enabled: true
      format: "<red>- <yellow>{player} <gray>离开了服务器"

messages:
  no-permission: "<red>你没有权限使用此命令!</red>"
  player-not-found: "<red>未找到玩家!</red>"
  starting-balance: "<green>你获得了初始余额 {symbol}{amount}!</green>"
  balance-display: "<green>{player} 的余额:<yellow>{symbol}{balance}</yellow></green>"
  pay-usage: "<red>用法:/pay <玩家> <金额>"

pay-insufficient: "<red>你的资金不足!"
  pay-sent: "<green>你向 {player} 发送了 {symbol}{amount}。"
  pay-received: "<green>你从 {player} 处收到了 {symbol}{amount}。"

economy-usage: "<red>用法:/economy <give/set/deduct> <玩家> <数量>"
  economy-success: "<green>{action} {symbol}{amount} 给 {player}。"
  baltop-header: "<gold>--- 余额排行榜 - 页码:{page} ----"
  baltop-line: "<yellow>{rank}. {player} - {symbol}{balance}"
  baltop-empty: "<red>未找到任何余额!"
  invalid-number: "<red>无效的数字!"

invalid-recipient: "<red>你不能给自己转账!"

---

## 依赖项
* **Vault**(或任何兼容的经济/聊天插件)

---

## 开发与支持
Serversentials 由一位独立开发者积极维护。如需支持、提交错误报告和建议,请加入官方 Discord 服务器。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源