Vonix 服务器工具

Vonix 服务器实用工具 (VSU)

一个面向 Minecraft 服务器的完整服务端基础功能模组。

Vonix 服务器实用工具将家、传送点、传送、礼包、社交命令、管理工具、审核功能以及可选的 Venary 集成整合到一个可配置的服务端模组中。

玩家无需在客户端安装 VSU。

功能特性

类别	包含功能
家与传送点	个人家、服务器传送点、可配置的家数量上限以及持久化的位置存储
传送	传送请求、出生点传送、/back 以及独立的 /backdeath 支持
礼包与实用工具	礼包、修复、物品栏工具、工作台、铁砧、AFK、延迟、游戏时间和玩家信息
社交工具	私信、回复、忽略、公告、昵称、附近玩家查询和玩家列表
管理	隐身、上帝模式、飞行、治疗、喂食、游戏模式控制、传送、物品栏查看和世界控制
审核	临时封禁、永久封禁、临时禁言、禁言、踢出、警告、警告历史和封禁列表管理
权限	兼容 LuckPerms 的 vsu.* 权限节点，并带有原版管理员等级回退方案
可选集成	通过 Venary 进行 Minecraft 账号绑定、玩家同步和捐赠等级同步
配置	运行时功能开关、冷却时间、限制、审核设置和集成控制
存储	基于 SQLite 的持久化数据，用于存储家、传送点、传送历史和审核记录

命令参考

家与传送

命令	描述
/sethome <name>	保存一个个人家
/home <name>	传送到个人家
/delhome <name>	删除一个个人家
/homes	列出你可用的家
/setwarp <name>	创建一个服务器传送点
/warp <name>	传送到服务器传送点
/delwarp <name>	删除一个服务器传送点
/warps	列出可用的服务器传送点
/setspawn	设置服务器出生点位置
/spawn	传送到服务器出生点
/back	返回你上一个传送位置
/backdeath	返回你记录的死亡位置
/tpa <player>	请求传送到另一名玩家
/tpahere <player>	请求另一名玩家传送到你这里
/tpaccept	接受一个传送请求
/tpdeny	拒绝一个传送请求

/back 和 /backdeath 是独立的系统。常规传送历史与记录的死亡位置是分开保存的。

社交命令

命令	描述
/msg <player> <message>	发送一条私信
/tell <player> <message>	发送一条私信
/r <message>	回复最近的私信
/reply <message>	回复最近的私信
/ignore <player>	忽略来自某名玩家的消息
/broadcast <message>	广播一条服务器消息
/bc <message>	广播一条服务器消息
/me <message>	发送一条动作消息
/nick <name>	设置或更改昵称
/near	列出附近玩家
/list	列出在线玩家

礼包与实用工具

命令	描述
/kit <name>	领取一个已配置的礼包
/kits	列出可用的礼包
/hat	将手持物品作为帽子戴上
/more	在允许的情况下补满手持物品堆叠
/repair	修复手持物品
/clear	清空物品栏内容
/enderchest	打开末影箱
/workbench	打开合成界面
/anvil	打开铁砧界面
/afk	切换 AFK 状态
/ping	显示连接延迟
/playtime	查看游戏时间信息
/whois <player>	查看玩家信息
/suicide	安全地消除你的角色

管理

命令	描述
/vanish	切换管理员隐身状态
/god	切换伤害保护
/fly	切换飞行
/heal	恢复生命值
/feed	恢复饥饿值
/gm <mode>	更改游戏模式
/tp <player>	传送到一名玩家
/tphere <player>	将一名玩家传送到你这里
/tpall	传送所有在线玩家
/tppos <x> <y> <z>	传送到指定坐标
/invsee <player>	查看并管理玩家的物品栏
/backsee <player>	查看玩家的传送历史
/accsee <player>	查看受支持的饰品存储
/lag	查看服务器性能信息
/smite <player>	用闪电击中一名玩家

审核

命令	描述
/tempban <player> <duration> [reason]	执行临时封禁
/ban <player> [reason]	执行永久封禁
/unban <player>	解除封禁
/banlist	查看当前封禁列表
/tempmute <player> <duration> [reason]	执行临时禁言
/mute <player> [reason]	执行永久禁言
/unmute <player>	解除禁言
/kick <player> [reason]	将玩家从服务器移除
/warn <player> [reason]	发出警告
/warnings <player>	查看玩家的警告记录
/clearwarnings <player>	清除玩家的警告记录

处罚记录会持久化保存，并支持诸如 30m、7d 和 2w 等时长格式。

世界控制

命令	描述
/weather <type>	更改天气
/sun	设置为晴天
/rain	设置为雨天
/storm	设置为雷雨天
/time <value>	设置世界时间
/day	设置为白天
/night	设置为夜晚

功能管理

命令	描述
/feature list	列出可用的功能组
/feature status	查看功能状态
/feature enable <key>	启用一个功能组
/feature disable <key>	禁用一个功能组
/feature reload	重新加载功能配置

兼容性

Minecraft 版本	Fabric	Forge	NeoForge	Java
1.18.2	是	是	—	17
1.19.2	是	是	—	17
1.20.1	是	是	—	17
1.21.1	是	—	是	21
26.1.2	—	—	是	25

请下载与你的 Minecraft 版本和加载器相匹配的文件。

安装

1. 为你的 Minecraft 版本和加载器下载 VSU 的 JAR 文件。
2. 将 JAR 文件放入服务器的 mods/ 文件夹中。
3. 启动服务器一次以生成配置文件和数据库。
4. 配置权限、限制、冷却时间和可选集成。
5. 重启服务器或重新加载支持的功能。

VSU 仅限服务端使用。玩家无需在客户端安装该模组。

配置

VSU 会生成：

config/vonix_server_utilities.properties

常见设置包括：

设置项	默认值	描述
max_homes	5	每位玩家的最大个人家数量
tpa_timeout_seconds	120	传送请求过期前的等待时间
death_back_delay_seconds	0	可返回死亡位置前的可选延迟时间

功能组可以在不卸载模组的情况下启用或禁用。

权限

VSU 提供兼容 LuckPerms 的 vsu.* 权限节点，用于命令级别的控制。

如果未安装 LuckPerms，VSU 将回退到原版管理员权限等级。

存储

VSU 使用 SQLite 存储服务器数据，包括：

• 家
• 传送点
• 传送历史
• 死亡位置历史
• 礼包
• 审核记录
• 玩家相关的实用数据

V2 通用重写

2.0.0 重写将共享的 VSU 行为集中管理，同时为 Fabric、Forge 和 NeoForge 提供专门的版本和加载器集成。

项目： Vonix Network
版本： 2.0.0
许可证： 保留所有权利