设置服务器

设置FXServer的分步指南。

运行FXServer

FXServer是当前CitizenFX服务器版本的名称。此页面显示了如何运行它。

运行服务端时遇到问题?请访问疑难问题解答,使用 Discord #fxserver-support 频道或在论坛的 Server Discussion 子类别中创建主题。

Windows

先决条件

  1. Visual C++ Redistributable 2019 或最新版
  2. 确保正确安装Git环境。

安装

  1. 创建一个新目录(比如 D:\FXServer\server),这将用于存放服务端文件。

  2. 构建服务器下载适用于Windows的最新master分支版本。

  3. 将构建解文件解压到先前创建的目录中。
    3.1 使用任何压缩文件工具(例如WinRAR或7-Zip)。

  4. cfx-server-data 克隆到服务端文件夹之外的新文件夹中。例如 D:\FXServer\server-data
    4.1 git clone https://github.com/citizenfx/cfx-server-data.git server-data

  5. server-data 文件夹中创建一个 server.cfg 文件(将下面的示例 server.cfg 文件复制到该文件中)。

  6. https://keymaster.fivem.net 上生成许可证密钥。

  7. 在server.cfg中设置许可证密钥至 sv_licenseKey "licenseKeyGoesHere"

  8. server-data 文件夹中运行服务。在纯Windows命令提示符(cmd.exe)窗口中输入如下命令:

    cd /d D:\FXServer\server-data
    D:\FXServer\server\FXServer.exe +exec server.cfg
    

    (仅在将目录更改为其他驱动器上的某个位置时才需要使用 /d 命令)


Linux

  1. 创建一个新目录(比如 mkdir /home/username/FXServer/server),这将用于存放服务端文件。
  2. 构建服务器下载适用于Linux的最新master分支版本。(复制最新服务器版本的URL并使用 wget <url> 进行下载)。
  3. 将构建解文件压缩到先前创建的目录中,使用 cd /home/username/FXServer/server && tar xf fx.tar.xz 解压缩(你需要 xz 解压缩软件,在Debian / Ubuntu上,这在 xz-utils 软件包中)。
  4. cfx-server-data 克隆到服务端文件夹之外的新文件夹中。
    4.1 例如 git clone https://github.com/citizenfx/cfx-server-data.git /home/username/FXServer/server-data
  5. server-data 文件夹中创建一个 server.cfg 文件(将下面的示例 server.cfg 文件复制到该文件中)。
  6. https://keymaster.fivem.net 上生成许可证密钥。
  7. 在server.cfg中设置许可证密钥至 sv_licenseKey "licenseKeyGoesHere"
  8. server-data 文件夹中运行服务。
    8.1 bash /home/username/FXServer/server/run.sh +exec server.cfg

常见问题

  • 如果提示 resources found,并且提示 Failed to start resource,则你没有 cd 至正确的目录。
  • 如果没有资源开始启动,并且你无法成功连接,那是因为你在启动时没有加 +exec 命令。
  • 如果提示 no license key was specified,总有上面某个情况适用。

server.cfg

下面是一个示例 server.cfg 文件。

# 只有在使用具有多个网络接口的服务器时才更改IP,否则只更改端口。
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# 默认情况下,这些资源将启动。
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure fivem
ensure hardcap
ensure rconlog
ensure scoreboard

# 这允许玩家使用基于scripthook的插件,比如传统的Lambda菜单。
# 将此设置为1以允许scripthook。请注意,这并不能保证玩家不能使用外部插件。
sv_scriptHookAllowed 0

# 取消注释并设置密码以启用RCON。请确保更改密码 - 它应该看起来像 rcon_password "YOURPASSWORD"
#rcon_password ""

# 服务器的标签使用逗号分隔列表。
# 例如:
# - sets tags "drifting, cars, racing"
# 或者:
# - sets tags "roleplay, military, tanks"
sets tags "default"

# 服务器主语言的有效区域设置标识符。
# 比如 "en-US", "fr-CA", "nl-NL", "de-DE", "en-GB", "pt-BR", "zh-CN", "zh-HK"
sets locale "root-AQ" 
# :)请用真实的语言替换上面的 root-AQ :)

# 设置可选的服务器信息和连接横幅图像url。
# 大小无关紧要,任何横幅大小的图像都可以。
#sets banner_detail "https://url.to/image.png"
#sets banner_connecting "https://url.to/image.png"

# 设置服务器的主机名
sv_hostname "FXServer, but unconfigured"

# 嵌套配置
#exec server_internal.cfg

# 加载服务器图标(96x96 PNG文件)
#load_server_icon myLogo.png

# 可用于脚本的转换器
set temp_convar "hey world!"

# 如果不希望服务器在服务器浏览器中列出,请取消注释此行。
# 如果你想公开你的服务器,不要编辑它。
#sv_master1 ""

# 添加系统管理员
add_ace group.admin command allow # allow all commands
add_ace group.admin command.quit deny # but don't allow quit
add_principal identifier.fivem:1 group.admin # add the admin to the group

# 在外部日志输出中隐藏玩家端点。
sv_endpointprivacy true

# 使用默认配置启用OneSync(服务器端状态感知需要)
onesync_enabled true

# 服务器播放机插槽限制(必须介于1和32之间,除非使用OneSync)
sv_maxclients 32

# Steam Web API密钥,如果要使用Steam身份验证 (https://steamcommunity.com/dev/apikey)
# -> replace "" with the key
set steam_webApiKey ""

# 服务器的许可证密钥 (https://keymaster.fivem.net)
sv_licenseKey changeme

之后开始做什么?