1 (中文)命令行参数
肝帝熙恩 edited this page 2025-06-11 15:57:35 +08:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

可通过添加以下参数修改服务器初始化方式。命令行选项优先级高于配置文件中的对应设置适用于个人使用或游戏服务器提供商GSP环境简化部署流程

  • -ip - 启动时绑定指定的 IPv4 地址。例如:-ip 0.0.0.0 会绑定所有网络接口,而 -ip 127.0.0.1 仅绑定本地回环地址。若接口分配了其他 IP 地址,也可绑定该地址。
  • -port - 启动时绑定指定端口。例如:-port 7777 使用 Terraria 默认端口,-port 25565 使用 Minecraft 默认端口。多数系统中1000 以下端口需管理员root权限绑定且需在防火墙中放行并设置端口转发。
  • -maxplayers-players - 设置最大玩家数。例如:-maxplayers 5 将最大玩家数设为 5理论最大值为 255可通过 -maxplayers 255 设置)。
  • -world - 启动时立即加载指定世界文件(需绝对路径)(但是我测试了相对路径也可以)。例如:-world C:\Terraria\MyWorld.wld-world /root/MyWorld.wld
  • -worldselectpath - 修改世界文件搜索路径。例如:-worldselectpath /root-worldselectpath C:\Terraria,服务器将从该路径加载世界。
  • -worldname - 从 worldselectpath 中指定世界名称加载。例如:若 MyWorld.wld 位于 C:\Terraria\ 且设置 -worldselectpath C:\Terraria\,则 -worldname MyWorld 可加载该世界。
  • -autocreate - 若未找到世界文件自动创建指定大小的新世界1-31 为小型)。例如:-autocreate 3 创建大型世界。
  • -config - 使用指定配置文件启动。例如:-config C:\Terraria\config.json
  • -ignoreversion - 忽略插件的 API 版本检查,允许运行旧版插件。
  • -forceupdate - 强制服务器持续运行无玩家时不进入休眠时间流逝、草生长、CPU 持续占用)。
  • -pass-password - 设置服务器密码。例如:-pass mypassword 将密码设为 mypassword
  • -motd - 设置游戏基础服务器消息MOTD。例如-motd "Welcome to my server!" 将 MOTD 设为 Welcome to my server!
  • -autoshutdown - 启用游戏基础的“自动关机”功能。
  • -secure - 启用游戏基础的“反垃圾信息”功能。
  • -configpath - 指定 TShock 解析配置文件、日志和 SQLite 数据库的路径。例如:-configpath C:\Terraria\ 将配置路径设为该目录。
  • -logpath - 覆盖默认日志路径。例如:-logpath C:\Terraria\ 将日志保存至该目录。
  • -logformat - 修改日志文件名格式(遵循 C# 日期格式规范)。例如:-logformat "yyyy-MM-dd" 按天生成日志,默认格式为 yyyy-MM-dd_HH-mm-ss
  • -logclear - 若旧日志存在则覆盖(适用于 Docker 环境)。例如:-logclear
  • -dump - 导出权限和配置文件说明(用于文档生成)。
  • -worldevil - 设置世界邪恶类型(random/腐化/猩红,仅影响新生成世界)。例如:-worldevil random 随机生成邪恶类型。
  • -heaptile - 使用 HeapTile 地图读写接口(实验性,可能导致问题,比默认方案更省内存)。例如:-heaptile
  • -constileation-c - 使用 Constileation 地图读写接口(实验性,省内存但可能有问题)。例如:-constileation
  • -difficulty - 设置世界难度(0=普通,1=专家,2=大师,3=旅程,仅影响新世界)。
  • -loadlib - 指示游戏加载指定路径的库文件。例如:-loadlib C:\Terraria\MyLibrary.dll 加载该路径下的库。
  • -crashdir - 指示游戏将崩溃信息转储保存至指定路径。例如:-crashdir C:\Terraria\CrashDumps
  • -additionalplugins - 除 ServerPlugins 文件夹外,额外从指定目录加载插件。例如:-additionalplugins C:\Terraria\MyPlugins(适用于多服务器共享插件场景)。

以上命令行参数为 Terraria 服务器原生参数的扩展(例如 -lang 仍为原生参数,可正常使用)。

TShock 自动启动配置

若需通过脚本自动启动 TShock 并跳过启动提示,需指定 -world 路径和 -autocreate 参数。
示例:TShock.Server.exe -world C:\Terraria\worlds\MyWorld.wld -autocreate 1