server.cfg
描述
server.cfg是一个服务器配置文件，允许你更改你的 SA-MP 服务器的各种设置。- 这个文件是每个服务器必需的，必须位于服务器目录中，放在服务器应用程序（samp-server.exe）旁边。
控制台
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| echo | 字符串 | Executing Server Config... | ✅ | ❌ | samp-server.exe 在执行 server.cfg 时会在服务器控制台中打印内容。你无需对此进行任何更改，因为只有你能看到控制台. |
| rcon_password | 字符串 | changeme | ❌ | ❌ | 用于管理服务器和使用远程控制台（rcon）的密码。你必须确保将其更改为难以破解的密码，以防止他人控制你的服务器。如果RCON密码仍然是“changeme”，你的服务器将无法启动! |
| rcon | 布尔 | 1 | ❌ | ❌ | 切换是否启用远程控制台功能。设置为1启用，设置为0禁用. |
脚本
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| gamemode(n) (N) (t) | 字符串 | gamemode0 grandlarc 1 | ❌ | ❌ | 位于gamemodes文件夹中的.amx文件，服务器应使用该文件作为游戏模式运行。(n) 是游戏模式编号，(N) 是不带.amx扩展名的游戏模式名称，(t) 是在切换到下一个游戏模式之前应运行该游戏模式的次数。 |
| filterscripts (N) | 字符串 | ✅ | ❌ | 位于filterscripts文件夹中的.amx文件，服务器应使用该文件作为过滤脚本运行。(N) 是不带.amx扩展名的过滤脚本名称。过滤脚本是在游戏模式的后台运行的脚本，用于为服务器添加额外功能，而无需编辑游戏模式。如果您希望在多个游戏模式之间携带特定属性，这非常有用。如果您想加载多个过滤脚本，请将它们依次放在一行，用空格分隔，例如：filterscripts script1 script2。 | |
| plugins (N) | 字符串 | ✅ | ❌ | 位于plugins文件夹中的.dll或.so文件，服务器应使用该文件作为插件运行。在Windows上，(N) 是不带.dll扩展名的插件名称；然而，在Linux上需要使用.so扩展名！插件是用于增强游戏模式和过滤脚本的脚本。如果您想加载多个插件，请将它们依次放在一行，用空格分隔，例如：plugins plugin1 plugin2. |
服务器浏览器
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| announce | 布尔 | 1 | ❌ | ❌ | 切换服务器是否应该在SA-MP主列表中公告。设置为1以启用，设置为0以禁用。 |
| query | 布尔 | 1 | ❌ | ❌ | 切换服务器信息是否应显示在服务器浏览器中。设置为1以启用，设置为0以禁用。即使禁用了查询，玩家仍然可以加入服务器，但服务器浏览器将不会显示任何信息。 |
| hostname | 字符串 | SA-MP Server | ❌ | ❌ | 在服务器浏览器中以及玩家连接到服务器时显示的名称。 |
| language | 字符串 | ❌ | ❌ | 在服务器浏览器中显示的语言。玩家可以使用此选项在服务器浏览器中按语言过滤服务器。 注意: 此服务器变量在0.3.7中添加，在之前的版本中将不起作用。 | |
| mapname | 字符串 | San Andreas | ❌ | ✅ | 在服务器浏览器中显示的地图名称。此项可以是任何内容，例如：My Stunt Map。 |
| gamemodetext | 字符串 | Unknown | ❌ | ❌ | 在服务器浏览器中显示的模式。使用 SetGameModeText 具有相同效果，并覆盖server.cfg中使用的值。如果您有多个需要不同游戏模式文本的游戏模式，请使用该函数。 |
| weather | 字符串* | 10 | ❌ | ✅ | 服务器使用的全球天气，将显示在服务器浏览器中。在server.cfg文件中使用此设置会导致服务器应用程序在启动时崩溃。请改用 SetWeather 更改此设置。 |
| worldtime | 字符串* | 12:00 | ❌ | ✅ | 服务器使用的全球时间，将显示在服务器浏览器中。在server.cfg文件中使用此设置无效。请改用 SetWorldTime 更改此设置。 |
| gravity | 字符串* | 0.008 | ❌ | ❌ | 服务器使用的全球重力。在server.cfg文件中使用此设置会导致服务器应用程序在启动时崩溃。请改用 SetGravity 更改此设置。 |
| weburl | 字符串 | www.open.mp | ❌ | ✅ | 访问该网站可以获取有关服务器的更多信息。 |
| version | 字符串 | ✅ | ✅ | 服务器使用的SA-MP版本，将显示在服务器浏览器中。在server.cfg文件中使用此设置无效。 | |
| maxplayers | 整数 | 50 | ✅ | ❌ | 服务器可以容纳的最大玩家数量。通过更改此数字，您可以调整可以进入服务器的玩家数量。最大值为1000，最小值为1。 |
| password | 字符串 | ❌ | ❌ | 用于锁定服务器的密码。使用此密码时，只有知道此密码的玩家才能加入服务器。 |
[*] 有些设置与你想象的不一样.
网络
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| sleep | 整数 | 5 | ❌ | ❌ | 主SA-MP和Raknet网络线程在每个同步周期内“闲置”休眠的时间（以毫秒为单位）。较高的值会减少服务器处理，但降低同步质量；较低的值会增加服务器处理，但改善同步质量。除非玩家数量非常多且存在服务器帧率稳定性问题，否则不建议更改此值。 |
| lanmode | 布尔 | 0 | ❌ | ❌ | 已弃用的变量，已无效。 |
| bind | 字符串 | ✅ | ❌ | 服务器应使用的IP地址。服务器将被强制使用此IP地址，而不是自动选择一个空闲的IP地址。此IP地址必须与服务器上分配给网络卡的地址匹配。这对于在同一设备上运行多个服务器使用相同端口非常有用。 | |
| port | 整数 | 8192 (7777 is also commonly used) | ✅ | ❌ | 服务器应使用的端口。您需要端口转发以便玩家能够从局域网外加入您的服务器。 |
| conncookies | 整数* | 1 | ❌ | ❌ | 切换0.3.7连接cookie系统。设置为1以启用，设置为0以禁用。 注意: 此服务器变量在0.3.7 R2中添加，在之前的版本中将不起作用。 |
| cookielogging | 整数* | 0 | ❌ | ❌ | 切换记录新连接玩家请求的连接cookie。设置为1以启用，设置为0以禁用。 注意: 此服务器变量在0.3.7 R2中添加，在之前的版本中将不起作用。 |
| connseedtime | 整数 | 300000 | ❌ | ❌ | 连接cookie种子值更新的时间（以毫秒为单位）。 注意: 此服务器变量在0.3.7中添加，在之前的版本中将不起作用。 |
| minconnectiontime | 整数 | 0 | ❌ | ❌ | 服务器在接受另一个传入连接前等待的时间（以毫秒为单位）。除非您的服务器遭受连接洪水攻击，否则不建议使用此变量。 |
| messageslimit | 整数 | 500 | ❌ | ❌ | 用户每秒最多可以发送的消息数量。 |
| messageholelimit | 整数 | 3000 | ❌ | ❌ | 一个用于处理DoS攻击的网络级设置。 |
| ackslimit | 整数 | 3000 | ❌ | ❌ | 网络层设置，用于限制每秒发送的ACK数据包的数量。 |
| playertimeout | 整数 | 10000 | ❌ | ❌ | 玩家在未向服务器发送任何数据后超时的时间（以毫秒为单位）。 |
| mtu | 整数 | 576 | ✅ | ❌ | 参见此处。 注意: 此服务器变量在0.3.8中添加，在之前的版本中将不起作用。 |
[*] 有些设置与你想象的不一样.
日志记录
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| output | 布尔 | 0 | ❌ | ❌ | 控制是否在服务器控制台中重复日志消息（例如脚本中的print/printf或插件中的logprintf）。设置为1启用，0禁用。此选项仅对Linux服务器有效. |
| timestamp | 布尔 | 1 | ❌ | ❌ | 控制是否在每条控制台消息中打印时间戳。设置为1启用，0禁用. |
| logtimeformat | 字符串 | [%H:%M:%S] | ✅ | ❌ | 应使用的时间戳格式。格式基于C/C++中的strftime格式。以下是一些示例： [%H:%M:%S] 仅显示时间，这是所有以前SA-MP服务器版本的默认格式。 [%d/%m/%Y %H:%M:%S] 将显示日期为dd/mm/yyyy格式，后跟[小时:分钟:秒]格式. |
| logqueries | 布尔 | 0 | ❌ | ❌ | 控制是否记录玩家发送到服务器的所有查询。设置为1启用，0禁用。在DDoS攻击期间非常有用. |
| chatlogging | 整数* | 1 | ❌ | ❌ | 控制是否在服务器控制台中显示玩家聊天。用于防止日志变得膨胀，或如果你有其他脚本聊天记录解决方案。设置为1启用，0禁用. |
| db_logging | 整数* | 0 | ❌ | ❌ | 在服务器控制台中记录sqlite db_*函数错误。 注意： 此服务器变量在0.3.7 R2版本中添加，之前的版本无效. |
| db_log_queries | 整数* | 0 | ❌ | ❌ | 记录所有sqlite db_query调用，包括查询字符串。 注意： 此服务器变量在0.3.7 R2版本中添加，之前的版本无效. |
[*] 有些设置与你想象的不一样.
客户端
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| onfoot_rate* | 整数 | 30 | ✅ | ❌ | 客户端在步行时每隔多少毫秒向服务器更新新数据. |
| incar_rate | 整数 | 30 | ✅ | ❌ | 客户端在车辆中每隔多少毫秒向服务器更新新数据. |
| weapon_rate | 整数 | 30 | ✅ | ❌ | 客户端在开火时每隔多少毫秒向服务器更新新数据. |
| stream_distance* | float | 200.0 | ❌ | ❌ | 玩家在X,Y平面上会流式传输的服务器实体的距离。最大值为 400.0，最小值为 50.0。更高的值会让玩家在更远的距离看到服务器实体，但需要更多的客户端处理和可能更多的带宽. |
| stream_rate* | 整数 | 1000 | ❌ | ❌ | 每个玩家重新测试服务器实体流式传输的时间（以毫秒为单位）。最大值为 5000，最小值为 500。较低的值增加服务器处理，因为它必须更频繁地重新检查每个玩家的流式传输条件. |
[*] 较低的 onfoot_rate、incar_rate 和 weapon_rate 值提高同步性能，但使用更多带宽.
NPCs
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| maxnpc | 整数 | 0 | ❌ | ❌ | 服务器可以容纳的最大NPC数量。通过更改此数字，可以调整有多少玩家插槽可以由NPC使用. |
延迟补偿
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| lagcompmode | 整数 | 1 | ✅ | ❌ | 0: 完全禁用延迟补偿。 1: 完全启用延迟补偿。 2: 启用仅位置延迟补偿。这意味着玩家的旋转不会进行延迟补偿. |
| lagcomp | 字符串 | On | ✅ | ✅ | 根据 lagcompmode 设置自动设置为 On 或 Off. |
自定义模型
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| useartwork | 布尔 | 0 | ✅ | ❌ | 控制服务器是否使用来自模型文件夹的自定义模型。设置为1启用，0禁用。 注意： 此服务器变量在0.3.8版本中添加，之前的版本无效。 |
| artwork | 字符串 | ❌ | ✅ | ✅ | 根据 useartwork 设置自动设置为 No 或 Yes。 注意： 此服务器变量在0.3.8版本中添加，之前的版本无效。 |
| artpath | 字符串 | models | ✅ | ❌ | 自定义模型所在的路径。 注意： 此服务器变量在0.3.8版本中添加，之前的版本无效。 |
其他
| 设置 | 类型 | 默认值 | 只读 | 规则 | 效果 |
|---|---|---|---|---|---|
| myriad | 布尔 | 0 | ❌ | ❌ | 未使用. 它可能启用了与早期的GTA San Andreas模组“Myriad Islands”的兼容性，大约在2008年之前. |
| ❌sign | 字符串 | ✅ | ❌ | 未使用. |
提示
- 标记为“只读”的值（如
/rcon varlist所示）不能在运行时更改。所有其他值可以通过传递给 SendRconCommand 来临时更改。 - 标记为“规则”的值（如
/rcon varlist所示）会在服务器浏览器的规则部分中显示。 - 脚本不是必需要放在 gamemodes 或 filterscripts 文件夹中。server.cfg 中的信息是路径，因此可以使用 ".."。