Vintage Story · 指南

Vintage Story 服务器命令

更新于 October 9, 2026 2 分钟阅读

本页内容
  1. 成为管理员并分配角色
  2. Whitelist:谁可以加入
  3. 按用途分类的命令列表
  4. 立即生效、重启后生效,还是仅限新世界
  5. 在 HytHost 服务器上执行命令
  6. 常见问题

运营一台 Vintage Story 服务器,总有几条命令会反复用到:把自己设为管理员、给朋友分配合适的角色、对陌生人关闭服务器、安装模组,以及在暴风雨连下三天时把天气调回来。

这就是那份清单,已对照 Vintage Story 1.22 核对——核对的是服务器本身,而不只是 wiki,因为 wiki 里有些命令仍是好几个版本之前的用法。所有命令都可以在聊天框或服务器控制台中输入,并以斜杠开头。

成为管理员并分配角色

第一个管理员需要在服务器控制台中设置,控制台始终拥有全部权限:

/op YourName

/op 是授予某人 admin 角色的快捷方式。Vintage Story 通过角色管理权限:每位玩家只有一个角色,新玩家默认获得 suplayer。要分配角色,或查看某人当前的角色:

/player FriendName role sumod
/player FriendName role

无论玩家是否在线都有效,也无需重启。没有 /deop:要撤销管理员,给该玩家换一个角色即可,例如 /player FriendName role suplayer。

角色用途
suvisitor / crvisitor只能聊天的访客,分别对应生存和创造模式
suplayer默认角色:建造、使用、圈地、战斗、聊天
crplayer与普通玩家相同,但处于创造模式,可自由移动
sumod管理员助手:踢人、封禁、发布公告、在任意位置建造
crmod创造模式管理员助手,还能对其他玩家执行命令
admin拥有全部权限

/list roles 会列出服务器上的角色。也可以在角色之外单独授予某项权限:/player FriendName privilege grant gamemode。

需要一台服务器来试试这些命令?HytHost 的 Vintage Story 服务器支持从 1.18.15 到最新的任意版本,€2.58/月起。

查看 Vintage Story 套餐

Whitelist:谁可以加入

开启 whitelist 后,只有你添加过的玩家才能加入。标准的 Vintage Story 专用服务器默认开启此功能;而 HytHost 上的新服务器默认关闭,因此任何知道地址的人——如果设置了密码,还需要密码——都能加入。

/serverconfig whitelistmode on
/player FriendName whitelist on
/whitelist add FriendName
/whitelist remove FriendName

whitelistmode 可设为 on、off 或 default(专用服务器上即为开启)。添加和移除玩家会立即生效,无论对方是否在线;/player FriendName whitelist on 与 /whitelist add FriendName 作用相同。

在 HytHost 服务器上,请在 Startup 选项卡中开启 whitelist 本身,而不要用 /serverconfig whitelistmode:服务器名称、密码、玩家上限和 whitelist 设置每次启动时都会从 Startup 选项卡重新应用,所以在控制台里的修改只会保持到下次重启。向名单中添加玩家不受影响。

按用途分类的命令列表

管理

命令作用示例
/kick <player> [reason]踢出一名在线玩家/kick Steve spamming
/ban <player> <amount> <unit> <reason>限时封禁;时长和理由都必须填写,单位使用单数形式:minute、hour、day、week 或 year/ban Steve 3 day griefing
/hardban <player>永久封禁/hardban Steve
/unban <player>解除封禁/unban Steve
/list banned列出被封禁的玩家/list banned

管理员助手无法踢出或封禁角色等级相同或更高的玩家。Vintage Story 中没有禁言命令。

时间、天气与世界

命令作用示例
/time set <time>设置一天中的时间,可用名称或小时数/time set sunrise
/time calendarspeedmul <value>让白天变长或变短——推荐用这个,而不是 /time speed/time calendarspeedmul 0.5
/weather seti <pattern>立即切换天气,例如 clearsky、overcast、cumulonimbus/weather seti clearsky
/weather stoprain停止下雨/weather stoprain
/worldconfig <key> [value]查看或修改世界设置;需重启生效/worldconfig deathPunishment keep
/serverconfig setspawnhere把世界出生点设在你所站的位置/serverconfig setspawnhere

玩家

命令作用示例
/gm [player] <mode>切换游戏模式:survival、creative、spectator 或 guest/gm Steve creative
/tp <player> [target]传送你自己,或把一名玩家传送到另一名玩家处;也支持坐标/tp Steve Alex
/giveitem <code> [amount] [player]给予物品;/giveblock 用于方块/giveitem ingot-copper 10 Steve
/list clients显示在线玩家/list clients

模组

命令作用示例
/moddb install <modid>从官方 ModDB 下载模组到服务器的 Mods 文件夹;加上 @version 可指定版本/moddb install carryon
/moddb list列出已安装的模组/moddb list
/moddb remove <modid>移除模组/moddb remove carryon

安装或移除模组后请重启服务器。玩家加入时会收到下载服务器模组的提示。

服务器

命令作用示例
/autosavenow立即保存世界/autosavenow
/db backup [file]写入一份世界备份/db backup before-update
/announce <message>向所有人发送消息/announce Restart in 5 minutes
/serverconfig <key> <value>修改服务器设置,例如 allowpvp、maxclients、password/serverconfig allowpvp false
/stats显示服务器统计信息/stats
/stop保存并关闭服务器/stop
/help [command]列出命令,或解释某条命令/help ban

立即生效、重启后生效,还是仅限新世界

更改生效时间
角色、权限、whitelist 条目、踢出和封禁立即
时间和天气立即
/worldconfig 设置,如死亡惩罚、生物敌对性、食物腐坏重启后
安装或移除的模组重启后
修改 serverconfig.json先停止服务器,编辑后再启动
世界类型、大小、气候、地形、种子仅在创建新世界时

世界一旦生成,世界生成设置就固定了——服务器根本不允许修改世界大小。想用不同的设置游玩,就得新建世界;通常的做法是先在单人模式中设置好,再把这个世界放到服务器上,具体步骤见我们的世界上传指南。

在 HytHost 服务器上执行命令

GamePanel 中的 Console 选项卡就是服务器控制台。每条命令都以斜杠开头,与聊天中完全一样;控制台拥有全部权限,所以第一条 /op 就在这里输入。

  • 部分设置由 Startup 选项卡管理。服务器名称、密码、玩家上限和 whitelist 开关每次启动时都会从 Startup 选项卡应用,因此请在那里修改。游戏风格和种子也在那里设置,需在世界创建之前完成。
  • 两种安装模组的方式。在 Startup 选项卡的 MODDB_MODS 中列出 ModDB id 并重新安装——服务器会自动选择适配你游戏版本的发行版——或者使用 /moddb install 后重启。
  • 任意版本。游戏版本在下单时选择,范围从 1.18.15 到最新稳定版,之后也可在 Startup 选项卡中更改。升级到新版本会保留你的世界;降级到旧版本则会开始一个新世界,并把当前世界保存在单独的文件夹中。
  • 备份与重启。包含自动备份,计划重启可以定时执行 /announce 和保存。

Vintage Story 是一款 PC 游戏,支持 Windows、macOS 和 Linux,每位玩家都需要在 vintagestory.at 拥有自己的账号。Vintage Story 服务器托管提供全部套餐,以及最高 16 GB 的 Custom 服务器。

下单时选择游戏版本,在 Startup 选项卡中安装 ModDB 模组,并保留自动备份——Vintage Story 服务器托管 €2.58/月起。

查看 Vintage Story 套餐
常见问题

常见问题

在服务器控制台中输入 /op YourName。这会给你的玩家授予 admin 角色,拥有全部权限。其他角色用 /player Name role rolename 分配,例如 sumod 表示管理员助手。

用 /serverconfig whitelistmode on 开启 whitelist,然后用 /player Name whitelist on 或 /whitelist add Name 添加玩家。在 HytHost 服务器上,请改为在 Startup 选项卡中开启 whitelist,因为该设置会在每次启动时应用。

使用 /moddb install 加上官方 ModDB 中的模组 id,例如 /moddb install carryon,然后重启服务器。/moddb list 显示已安装的模组,/moddb remove 可将模组移除。

使用 /time set 加上时间,例如 sunrise 或某个小时数;使用 /weather seti 加上天气模式,例如 clearsky。若想让白天更长,推荐使用 /time calendarspeedmul,而不是 /time speed。

用 /worldconfig 修改的世界设置、安装或移除的模组,以及对 serverconfig.json 的编辑都需要重启。角色、whitelist 条目、封禁、时间和天气会立即生效。世界类型、大小、气候和种子只对新世界有效。

你不在线时,世界照常运行

HytHost 的 Vintage Story 服务器托管提供实时控制台、1.18.15 起的任意游戏版本、ModDB 模组和自动备份——€2.58/月起。

Live chat 8 AM – 11 PM (Chișinău time) · tickets answered during business hours

这篇指南对你有帮助吗?