【V3.0】玩家之间TP

========================================

  玩家传送 MOD（TeleportMod）使用说明

========================================

【这个 MOD 是做什么的】

给多人服务器的普通玩家提供一套传送命令：设置家园、传送回家、

死亡/传送返回、玩家互传、队伍召集。所有命令都能在聊天框里直接使用，

玩家不需要服务端控制台权限。

—————————————-

一、安装

—————————————-

1. 把整个「玩家TPMOD」文件夹放到游戏根目录的 Mods 文件夹下：

   …\7 Days To Die\Mods\玩家TPMOD\

   （文件夹里应包含 ModInfo.xml、TeleportMod.dll、tpmod_config.xml）

2. 本 MOD 依赖 Harmony，请确保 Mods 目录下已安装 0_TFP_Harmony

   （游戏自带，一般已存在）。

3. 服务端和单机都装同一份即可。装好后重启服务器 / 游戏生效。

—————————————-

二、怎么用（重要）

—————————————-

所有命令都在【聊天框】里输入，前面加一个斜杠 /。

按 T 或回车打开聊天框，输入命令后回车即可。例如：

   /sethome

   /home

   /tpa 张三

所有操作都统一在聊天栏完成，包括 tpaccept、tpdeny、

rallyaccept、rallydeny 等同意/拒绝命令；F1 控制台不执行本 MOD 的玩家命令。

—————————————-

三、命令一览

—————————————-

● 家园（可设置多个家，默认上限 5 个）

   /sethome [家名]     把当前位置设为家。不填家名就是默认家 home。

                       例：/sethome         → 设置默认家

                           /sethome 矿洞    → 设置名为“矿洞”的家

   /home [家名]        传送到指定的家。不填家名就回默认家 home。

   /delhome <家名>     删除一个家。

   /listhome           列出你所有的家和坐标。

● 返回

   /back               返回上一次死亡位置或传送前位置。

                       新的死亡/传送会覆盖旧记录，成功使用后记录清除。

● 玩家互传（需要对方同意）

   /tpa <玩家名>       向对方发送传送请求，你会被传送到对方身边。

                       支持带空格的完整玩家名；简称匹配到多人时会要求补全。

   /tpaccept           对方收到请求后，输入这个表示同意。

   /tpdeny             对方收到请求后，输入这个表示拒绝。

                       请求 60 秒内有效，超时自动失效。

● 队伍召集（队长把队友传到自己身边）

   /rally              向所有在线队友发出召集，队友会收到邀请。

   /rallyaccept        队友输入这个表示同意，传送到队长位置。

   /rallydeny          队友输入这个表示拒绝。

                       邀请 60 秒内有效，超时自动失效。

                       队友传送后可用 /back 返回原位。

—————————————-

四、tpa / rally 的确认流程

—————————————-

游戏引擎的聊天框不支持“可点击按钮”，所以同意/拒绝是通过输入

命令完成的。收到请求时，聊天框会出现类似提示：

   [传送] 张三 请求传送到你身边

   [传送] 在聊天框输入 /tpaccept 同意，/tpdeny 拒绝（60秒内有效）

按提示输入对应命令即可。60 秒内不处理，请求自动过期。

—————————————-

五、配置文件 tpmod_config.xml

—————————————-

位于 MOD 文件夹内，可用记事本编辑，改完重启服务器生效：

   <MaxHomes>5</MaxHomes>      每个玩家最多可设置的家数量（默认 5）

   <EnableLog>true</EnableLog> 是否输出运行日志到服务器日志（默认 true）

   <EnableHome>true</EnableHome>   家园功能：sethome/home/delhome/listhome

   <EnableBack>true</EnableBack>   返回功能：back

   <EnableTpa>true</EnableTpa>     玩家互传：tpa/tpaccept/tpdeny

   <EnableRally>true</EnableRally> 队伍召集：rally/rallyaccept/rallydeny

将对应开关改为 false 即可关闭整组功能，修改后需要重启服务器 / 游戏。

若文件不存在，MOD 首次启动会自动生成一份默认配置。

—————————————-

六、常见问题

—————————————-

Q: 在聊天框打 /back 没反应？

A: 确认 MOD 已放进 Mods\玩家TPMOD 并重启了服务器；

   同时确认 0_TFP_Harmony 已安装。

Q: /home 提示“尚未设置家园”？

A: 需要先用 /sethome 设置家，才能用 /home 传送。

Q: 家设置不了，提示达到上限？

A: 家数量到达 MaxHomes 上限了，先用 /delhome <家名> 删掉一个，

   或在 tpmod_config.xml 里调大 MaxHomes。

Q: 数据存在哪？

A: 每个玩家的家和返回点保存在存档目录下的 TeleportMod\<玩家ID>.xml，

   以玩家的持久 ID 为准，死亡重生不会丢失。

——————————————————————————————————————-

注意事项

——————————————————————————————————————-

– 所有命令对普通玩家开放，无需管理员权限。

– 家园位置和死亡位置在设置/死亡时立即保存到磁盘，退服/重进后依然有效。

– tpa 请求和 rally 召集超时后自动失效（60 秒）。

– 玩家断线后，其相关的传送请求数据会自动清除。

-需关闭EAC！！！