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

概述
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 集成,自动从全局标签列表中移除隐身玩家。
- 建议过滤: 动态过滤命令补全建议,使玩家仅能看到他们有权限执行的命令。
安装指南
单服务器设置
- 下载
Serversentials.jar 文件。
- 将 jar 文件放入服务器的
plugins/ 目录中。
- 启动服务器以生成默认配置文件。
代理网络设置 (Velocity + 后端服务器)
- 将
Serversentials.jar 文件放入你的 Velocity 代理 的 plugins/ 文件夹中。
- 将相同的
Serversentials.jar 文件放入所有后端 Paper/Folia 服务器 的 plugins/ 文件夹中。
- 启动代理和后端服务器以生成默认配置文件。
- 在每个后端服务器上,编辑
plugins/Serversentials/config.yml,并将 server-name 键设置为与 Velocity velocity.toml 配置中注册的服务器名称完全匹配(例如 lobby、survival-1)。
- 重启后端服务器以初始化网络同步。
命令与权限参考
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 服务器。
Serversentials
A high-performance, network-compatible, and Folia-ready utility suite designed to replace legacy essentials plugins on modern Minecraft servers and proxy networks.

Overview
Essentials suites often struggle when deployed on multi-threaded Folia environments or synchronized across proxy networks.
Serversentials is built from the ground up to address these platform limitations. It operates as a unified, high-performance hybrid JAR capable of running on backend servers (Paper, Folia) and proxy servers (Velocity) simultaneously.
Architecture Highlights
- Folia Optimization: Asynchronous execution and global/region-specific task scheduling to ensure complete compatibility with Folia's multi-threaded region model.
- Hybrid JAR Architecture: The same plugin file is loaded on both the backend game servers and your Velocity proxy.
- Dual-Dialect Storage: High-performance database operations powered by HikariCP, supporting local SQLite file storage or network-synchronized MySQL databases.
- Automatic Configuration Migrator: Upgrades configuration files seamlessly on plugin updates while preserving custom values, formatting, and inline comments.
Feature Breakdown
Network Teleportation & Movement
- Cross-Server Teleportation: Send request-based
/tpa and /tpahere teleports across different servers on your proxy network. Includes administrative bypass commands (/tpo and /tpohere).
- Session Tracking: Hop back to your previous location or death coordinate across servers using
/back.
- Utility Teleports: Teleport to safe random coordinates within world borders using
/rtp, or jump to the highest block above your coordinates with /top.
- Warps & Homes: Set multi-home profiles (permission-capped) and global warps with support for custom warmups and cooldown timers.
Chat & Messaging
- Cross-Server Whispering: Perform private messaging network-wide using
/msg and /reply with built-in /socialspy for administration.
- Staff Communication: Staff-only channel using
/staffchat to coordinate privately across the network.
- Modern Chat Renderer: Fully custom chat formatting engine with MiniMessage syntax support, integrated with Vault/LuckPerms prefixes, suffixes, and display names.
- Connection Events: Custom join and leave messages featuring PlaceholderAPI support, configurable to be toggled on or off independently.
Extra Inventories (/inv)
- Multi-Profile Inventories: Allows players to unlock and switch between up to 11 individual inventory profiles (1 base profile + 10 extra slots).
- Interactive GUI: Preview profiles in a custom 54-slot chest interface displaying armor, offhand items, and player details.
- Administrative Management: View or clear player inventories on demand using
/inv view and /inv clear.
- Revocation Safety: If a player loses permission for an inventory, it is set to "Locked" status, allowing them to extract their items safely but preventing new item storage.
- Custom NBT Support: Safely serializes complex custom NBT data, making it fully compatible with custom item plugins like Nexo.
Economy
- Network Transactions: Send currency to players on the same server or across the proxy network with
/pay.
- Vault Integration: Fully hooks into Vault to act as a robust server economy provider.
- Leaderboards: Display top currency holder statistics with
/baltop.
Moderation & Administration
- Live Perspective Monitoring: The
/monitor command allows administrators to enter spectator mode to monitor a player's perspective (locally or cross-server) and return safely to their original server, coordinates, and gamemode upon exit.
- Vanish Integration: Hides vanished players from join queries and integrates with TAB/TAB-bridge to automatically remove vanished players from the global tablist.
- Suggestion Sanitization: Dynamically filters command tab-completion suggestions so players only see commands they have permission to execute.
Installation Guide
Single Server Setup
- Download the
Serversentials.jar file.
- Place the jar file inside your server's
plugins/ directory.
- Start the server to generate the default configuration files.
Proxy Network Setup (Velocity + Backend Servers)
- Place the
Serversentials.jar file inside your Velocity proxy's plugins/ folder.
- Place the same
Serversentials.jar file inside the plugins/ folder of all backend Paper/Folia servers.
- Start the proxy and backend servers to generate the default configuration files.
- On each backend server, edit
plugins/Serversentials/config.yml and set the server-name key to match exactly the server's registered name in your Velocity velocity.toml configuration (e.g. lobby, survival-1).
- Restart the backend servers to initialize network synchronization.
Commands & Permissions Reference
1. Teleportation & Movement
| Command & Arguments |
Aliases |
Description |
Permission Node |
/tpa <player> |
- |
Request to teleport to a player |
serversentials.tpa |
/tpahere <player> |
tpah |
Request a player teleport to you |
serversentials.tpahere |
/tpaccept |
tpc |
Accept a pending teleport request |
serversentials.tpaccept |
/tpdeny |
tpd |
Deny a pending teleport request |
serversentials.tpdeny |
/tptoggle |
tpt |
Toggle incoming teleport requests |
serversentials.tptoggle |
/tpo <player> |
- |
Force teleport to a player (admin bypass) |
serversentials.tpo |
/tpohere <player> |
- |
Force teleport a player to you (admin bypass) |
serversentials.tpohere |
/back |
- |
Return to previous position or death point |
serversentials.back |
/rtp |
- |
Teleport to a random safe location |
serversentials.teleport.rtp |
/top |
- |
Teleport to the highest block above you |
serversentials.teleport.top |
2. Messaging & Communication
| Command & Arguments |
Aliases |
Description |
Permission Node |
/msg <player> <message> |
w, tell, pm, message |
Send a private message (cross-server) |
serversentials.msg |
/r <message> |
reply |
Reply to the last received private message |
serversentials.reply |
/socialspy |
- |
Toggle spying on private messages |
serversentials.socialspy |
/sc <message> |
staffchat |
Broadcast a message to the staff channel |
serversentials.staffchat |
3. Extra Inventories
| Command & Arguments |
Aliases |
Description |
Permission Node |
/inv list |
inventory |
Open the extra inventory selection GUI |
serversentials.extrainv |
/inv <1-11> |
inventory |
Quick-switch to a specific inventory slot |
serversentials.extrainv |
/inv view <player> [slot] |
inventory |
View a player's extra inventory (admin) |
serversentials.extrainv.admin |
/inv clear <player> [slot] |
inventory |
Clear a player's extra inventory (admin) |
serversentials.extrainv.admin |
4. Player Customization & Economy
| Command & Arguments |
Aliases |
Description |
Permission Node |
/nick <name> |
- |
Set a custom display name / nickname |
serversentials.nick |
/nick off |
- |
Clear your active nickname |
serversentials.nick |
/whois <nickname> |
- |
Reveal the real username behind a nickname |
serversentials.whois |
/balance [player] |
bal |
Check a player's current account balance |
serversentials.balance |
/pay <player> <amount> |
- |
Transfer funds to another player |
serversentials.pay |
/economy <give|set|deduct> <player> <amount> |
eco |
Modify player balances (admin) |
serversentials.economy |
/baltop [page] |
- |
Display top server balances |
serversentials.baltop |
5. Moderation & Server Administration
| Command & Arguments |
Aliases |
Description |
Permission Node |
/monitor <player> |
mon |
Start spectating a player's perspective |
serversentials.monitor |
/monitor |
mon |
Stop spectating and return to original state |
serversentials.monitor |
/vanish [player] |
v |
Toggle invisibility / vanish status |
serversentials.vanish |
/invsee <player> |
- |
View or modify a player's inventory |
serversentials.invsee |
/heal [player] |
- |
Restore player health |
serversentials.heal |
/feed [player] |
- |
Restore hunger bars |
serversentials.feed |
/god [player] |
- |
Toggle invulnerability state |
serversentials.god |
/ssreload |
- |
Reload configuration files |
serversentials.reload |
6. Homes & Warps
| Command & Arguments |
Aliases |
Description |
Permission Node |
/home [name] |
- |
Teleport to a set home coordinate |
serversentials.home |
/sethome [name] |
- |
Create a home point at your location |
serversentials.sethome |
/delhome <name> |
- |
Delete an existing home point |
serversentials.delhome |
/homes [player] |
- |
List your homes or another player's homes |
serversentials.homes |
/warp <name> |
- |
Teleport to a public warp location |
serversentials.warp |
/setwarp <name> |
- |
Set a public warp location |
serversentials.setwarp |
/delwarp <name> |
- |
Remove a public warp location |
serversentials.delwarp |
/warps |
- |
List all available warp points |
serversentials.warps |
7. Utility GUIs & Item Editors
| Command & Arguments |
Aliases |
Description |
Permission Node |
/craft |
- |
Open a portable crafting bench GUI |
serversentials.craft |
/echest [player] |
ec |
Open a player's virtual ender chest |
serversentials.echest |
/anvil |
- |
Open a portable anvil GUI |
serversentials.anvil |
/loom |
- |
Open a portable loom GUI |
serversentials.loom |
/stonecutter |
scutter |
Open a portable stonecutter GUI |
serversentials.stonecutter |
/smithingtable |
smith |
Open a portable smithing table GUI |
serversentials.smithingtable |
/item <material> [amount] |
i |
Spawn a specified item (admin) |
serversentials.item |
/itemrename <name> |
iname, itemname |
Rename the display name of your held item |
serversentials.itemrename |
/lore <add|set|insert|delete|clear> [index] [text] |
- |
Modify item lore lines |
serversentials.lore |
/enchant <enchantment> [level] [player] |
ench |
Apply custom enchants to the held item |
serversentials.enchant |
8. World & Environment
| Command & Arguments |
Aliases |
Description |
Permission Node |
/day |
- |
Set the local world time to day |
serversentials.worldcommands |
/noon |
- |
Set the local world time to noon |
serversentials.worldcommands |
/night |
- |
Set the local world time to night |
serversentials.worldcommands |
/clear |
sun |
Change local weather to clear |
serversentials.worldcommands |
/rain |
- |
Change local weather to rain |
serversentials.worldcommands |
/storm |
- |
Change local weather to storm |
serversentials.worldcommands |
PlaceholderAPI Integration
Requires PlaceholderAPI. If using Folia, use a Folia-compatible fork.
| Placeholder |
Description |
Example Output |
%serversentials_name% |
The player's vanilla username |
Jolly |
%serversentials_displayname% |
The formatted nickname (falls back to username) resolved to legacy section codes |
&c[Admin] &eJolly |
%serversentials_nickname% |
The active nickname (falls back to username) resolved to legacy section codes |
&eJollyJoe |
%serversentials_nickname_raw% |
The raw MiniMessage nickname string stored in the database |
<gold>JollyJoe |
%serversentials_has_nickname% |
Returns true if the player has an active nickname set, otherwise false |
true |
%serversentials_isflying% |
Returns true if the player is currently flying, otherwise false |
false |
%serversentials_gamemode% |
The player's current game mode |
SURVIVAL |
%serversentials_ping% |
The player's current ping |
24 |
%serversentials_vanished% |
Returns true if the player is vanished, otherwise false |
false |
%serversentials_hidden% |
Returns true if the player is hidden from others, otherwise false |
false |
%serversentials_godmode% |
Returns true if the player is in god mode, otherwise false |
false |
%serversentials_teleport_toggle% |
Returns true if the player accepts teleport requests, otherwise false |
true |
%serversentials_active_inventory_slot% |
The current active inventory slot number (1-11) for the player |
2 |
%serversentials_inventory_max_slots% |
The total number of inventory slots (1-11) the player has permission for |
5 |
%serversentials_fly_speed% |
The player's flight speed multiplier (0-10) |
2.0 |
%serversentials_walk_speed% |
The player's walking speed multiplier (0-10) |
2.0 |
%serversentials_eco_balance% |
The player's raw economy balance |
542.50 |
%serversentials_eco_balance_formatted% |
The player's formatted economy balance |
$542.50 |
Configuration
server-name: "default"
# If using on a velocity network, change this to the configured server name for this server as it is in your velocity.toml file
# If running a single server, no need to change this
# Set this properly if on a proxy network to avoid issues with teleporting!!!
database:
type: sqlite # or "mysql" use sqlite if you haven't set up a mysql server
# SQLite options
file: serversentials.db
# MySQL options (used only if type = mysql)
host: localhost
port: 3306
database: serversentials
username: root
password: ""
useSSL: false
pool-size: 10
modules:
# serversentials.home <- /home and /sethome
# serversentials.sethome.<#> <- Number of homes
# serversentials.home.cooldown.<#> <- Cooldown per /home command
# servesentials.home.countdown.<#> <- Countdown before teleporting
home: true
nick: # serversentials.nick
enabled: true
maxlength: 32 # This includes MiniMessage formatting <red>JollyJoe <- counts 13
#---------TELEPORTS----------
tpa: #serversentials.tpa
enabled: true
expiration: 20 # Seconds before teleport requests expire
tpahere: # serversentials.tpahere
enabled: true
expiration: 20 # Seconds before teleport requests expire
tptoggle: true # serversentials.tptoggle <- Toggles teleport requests on/off
tpo: true # serversentials.tpo <- Tpa override
tpohere: true # serversentials.tpohere <- Tpahere override
# serversentials.warp <- /warp
# serversentials.warp.<warpname> <- /warp <name>
# serversentials.setwarp <- /setwarp
# serversentials.warp.cooldown.<#>
# serversentials.warp.countdown.<#>
warp: true
teleport:
top: true
rtp: true #I recommend using my RTP plugin for more configuration!
back: true
# https://modrinth.com/plugin/rtp-gui (if you DO install this, set rtp: false)
#---------UTILITIES----------
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
#---------EXTRAS----------
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 command
enabled: true
respect-max-stack-size: true # true = don't allow oversized stacks
enchant:
respect-max-levels: true # true = don't allow over-limit enchants
worldcommands: true #/day, /night, /noon, /clear, /rain, /storm
#---------ECONOMY-------
economy:
enabled: true
starting-balance: 100.0
currency-symbol: "$"
formatted: true # true = show commas and decimals, false = plain numbers
decimals: 2 # number of decimal places
cross-server-pay: true # Enable sending money to players on other servers on the network
#---------CHAT FORMATTING---------
chat:
enabled: true
cross-server-chat: false # Enable to relay chat messages across all servers on the network
# Chat format — supports PlaceholderAPI placeholders and built-in: {server}, {player}, {prefix}, {suffix}, {message}
# {player} uses display names (respects /nick)
# Example with 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>"
# Join/Leave messages — supports PlaceholderAPI placeholders and {player}
# Set enabled to false to hide the message entirely
join-message:
enabled: true
format: "<green>+ <yellow>{player} <gray>joined the server"
leave-message:
enabled: true
format: "<red>- <yellow>{player} <gray>left the server"
messages:
no-permission: "<red>You do not have permission to use this command!</red>"
player-not-found: "<red>Player not found!</red>"
starting-balance: "<green>You received your starting balance of {symbol}{amount}!</green>"
balance-display: "<green>{player}'s balance: <yellow>{symbol}{balance}</yellow>"
pay-usage: "<red>Usage: /pay <player> <amount>"
pay-insufficient: "<red>You do not have enough funds!"
pay-sent: "<green>You sent {symbol}{amount} to {player}."
pay-received: "<green>You received {symbol}{amount} from {player}."
economy-usage: "<red>Usage: /economy <give/set/deduct> <player> <amount>"
economy-success: "<green>{action} {symbol}{amount} for {player}."
baltop-header: "<gold>--- Top balances - Page: {page} ----"
baltop-line: "<yellow>{rank}. {player} - {symbol}{balance}"
baltop-empty: "<red>No balances found!"
invalid-number: "<red>Invalid number!"
invalid-recipient: "<red>You cannot send money to yourself!"
Dependencies
- Vault (or any compatible economy/chat provider plugin)
Development & Support
Serversentials is actively maintained by a solo developer. For support, bug reports, and suggestions, please join the official Discord server.
评论 0
登录后参与评分
还没有评论,来抢沙发吧