逃走中MOD 技术文档

Appearance

快速开始 ​

面向对象：服务器管理员 | 前置条件：Minecraft 1.21.1 + NeoForge 服务端

概述 ​

本文档涵盖逃走中MOD（chenxi_rfm）的服务器部署、模组安装和基础配置，帮助你在最短时间内启动一个可用的逃走中游戏服务器。

一、模组安装 ​

1.1 所需模组清单 ​

模组必要性说明
NeoForge 21.1.x必需MOD 加载器
chenxi_rfm必需逃走中核心模组
Simple Voice Chat推荐手机语音通话功能依赖此模组
chenxi_rfm_addition可选扩展模组（广播板/充能方块/小游戏）
RFM_Tools可选工具模组（UUID修复/屏障渲染）

1.2 安装步骤 ​

  1. 安装 NeoForge 21.1.x 服务端
  2. 将 chenxi_rfm-<version>.jar 放入 mods/ 目录
  3. （可选）将 chenxi_rfm_addition-<version>.jar 放入 mods/ 目录
  4. （可选）将 RFM_Tools-<version>.jar 放入 mods/ 目录
  5. 如需语音通话，将 simple-voice-chat-<version>.jar 放入 mods/ 目录
  6. 启动服务器

首次启动后，配置文件将自动生成。

二、配置文件一览 ​

配置文件路径用途
Clientconfig/nfa_rfm/client.toml手机UI位置/缩放（仅客户端）
Commonconfig/nfa_rfm/common.toml日志过滤器
Server<world>/serverconfig/nfa_rfm/server.toml游戏参数（金币率/侦测范围/数据库等）

三、权限设置（必须） ​

3.1 设置首个主控管理员 ​

服务器启动后处于引导期（无主控状态），任意 OP 玩家可执行：

/nfa permission set <玩家名> master_admin

示例 — 将玩家 Steve 设为首任主控：

/nfa permission set Steve master_admin

注意：主控是唯一且互斥的。设新主控时旧主控自动降级为 GAME_ADMIN。

3.2 设置游戏管理员 ​

主控可设置其他玩家为游戏管理员：

/nfa permission set <玩家名> game_admin

GAME_ADMIN 可管理大部分游戏流程（开始/暂停/猎人箱等），但不能修改他人权限或执行最高级命令。

四、基础配置 ​

4.1 设置金币产出率 ​

/nfa rfm coin rate <50|100|200|500>

默认值 100/秒，仅支持这四个档位。

4.2 设置侦测基础范围 ​

/nfa rfm detect range <1-512>

默认值 50 格。

4.3 设置监狱点 ​

/nfa rfm prison

在当前站立位置设置监狱点，淘汰/弃权玩家将被传送到此位置。

4.4 设置手机UI缩放 ​

/nfa phone rate <百分比>     # 范围 40-100

4.5 配置通话/消息限制 ​

编辑 server.toml：

toml
[phone]
message_cooldown_seconds = 5   # 消息冷却（范围 0-120）
call_wait_seconds = 30         # 响铃等待（范围 10-120）
max_call_seconds = 60          # 最大通话（范围 30-120）

执行 /nfa reload 热重载配置。

五、验证安装 ​

依次执行以下指令，确认模组正常工作：

/nfa reload                           # 应显示"配置已重新加载"
/nfa permission set Steve game_admin  # 应显示权限变更消息
/nfa rfm coin rate 100                # 应显示金币率变更消息

如果以上指令均正常输出 [NFA] 前缀的绿色提示消息，则模组安装成功。

六、下一步 ​

文档内容
游戏准备流程完整准备 checklist
游戏执行流程开始/暂停/终止游戏
手机使用指南玩家手机操作说明
中控面板指南图形化管理面板操作

常见问题 ​

Q: 执行指令时报"权限不足"？

A: 检查是否已执行 /nfa permission set <你的名字> master_admin。引导期内需要你是 OP（/op <名字>）。

Q: 语音通话没有声音？

A: 检查 Simple Voice Chat 模组是否正确安装。通话功能依赖此模组的群组语音桥接。

Q: 如何重置所有数据？

A: 删除 <world>/data/nfa_rfm/ 目录。配置文件位于 config/nfa_rfm/ 下，不影响存档数据。

相关文档 ​