Unturned 乞讨插件 (BeggingPlugin) – 完整指南

插件概述

这是一个基于 RocketMod 平台的 Unturned 插件，允许玩家向面前的其他玩家乞讨经验值（游戏内货币）。目标玩家可以选择接受或拒绝请求，接受后可以自由决定给予多少经验值给乞讨者。

最新版本: v1.1.0 (添加了化简式指令支持)

功能列表

核心功能

• 乞讨请求系统：

• 玩家使用 /beg 向面前的玩家发送乞讨请求

• 目标玩家会收到通知并选择接受或拒绝

• 接受后可以自由输入给予的经验值数量

指令系统

配置选项

<BeggingConfiguration>
  <DetectionRange>5</DetectionRange>       <!-- 乞讨检测范围（米） -->
  <DetectionAngle>45</DetectionAngle>       <!-- 乞讨检测角度（度） -->
  <RequestExpireSeconds>30</RequestExpireSeconds> <!-- 请求过期时间（秒） --></BeggingConfiguration>

多语言支持

插件内置完整中文提示系统，支持自定义翻译文本：

• 请求发送成功提示

• 经验值不足提示

• 请求超时通知

• 接受/拒绝操作反馈

安装方法

1. 编译插件：

• 使用 Visual Studio 编译项目生成 BeggingPlugin.dll

• 重要：将项目目标平台设置为 x64

2. 安装到服务器：

• 将 BeggingPlugin.dll 放入服务器目录：

  text

  /Rocket/Plugins/

3. 配置文件：

• 首次启动时自动生成配置文件：

  text

  /Rocket/Plugins/BeggingPlugin/config.xml

• 可根据需要修改配置参数

使用教程

基本流程

1. 玩家A（乞丐）面对玩家B输入：/beg

2. 玩家B收到通知：”[玩家A] 向你乞讨! 输入 /begaccept [金额] 或 /bega [金额] 接受，/begdeny 或 /begd 拒绝”

3. 玩家B选择：

• 接受：/bega 100（给予100点经验值）

• 拒绝：/begd

4. 双方收到操作结果通知

配置调整

编辑 config.xml：

<?xml version="1.0" encoding="utf-8"?><BeggingConfiguration>
  <!-- 最大检测距离（米） -->
  <DetectionRange>8</DetectionRange>
  
  <!-- 检测角度（0-180度） -->
  <DetectionAngle>60</DetectionAngle>
  
  <!-- 请求超时时间（秒） -->
  <RequestExpireSeconds>45</RequestExpireSeconds></BeggingConfiguration>

权限管理

插件使用以下权限节点：

• begging.beg – 允许使用 /beg 命令

• begging.accept – 允许使用 /begaccept 和 /bega 命令

• begging.deny – 允许使用 /begdeny 和 /begd 命令

技术说明

检测机制

插件使用精确的物理检测系统：

1. 距离检测：只检测配置范围内的玩家

2. 角度检测：只检测玩家视野锥形区域内的目标

3. 实时更新：每5秒检查并清除过期请求

安全特性

• 经验值转移前验证余额

• 自动处理离线玩家请求

• 防止自我乞讨

• 请求超时自动取消

常见问题解决

1. 编译警告 MSB3270：

• 解决方案：项目属性 → 生成 → 平台目标 → 选择 x64

2. 插件无法加载：

• 确保已安装 RocketMod 4.9.3.0 或更高版本

• 检查 Unturned 服务器版本是否兼容

3. 命令不工作：

• 检查权限设置：/rocket permissions list

• 验证插件是否加载：/rocket plugins list

更新日志

v1.1.0

• 添加接受/拒绝命令的化简形式：/bega 和 /begd

• 优化提示信息，显示可用化简命令

• 修复配置文件加载问题

v1.0.1

• 修复命令注销问题

• 优化请求超时处理

• 增强玩家在线状态检测

v1.0.0

• 初始发布版本

• 完整乞讨系统实现

• 多语言支持

• 可配置检测参数

开发者信息

开发平台：

• RocketMod 4.9.3.0

• .NET Framework 4.8

• Unturned 3.x

开源协议：MIT License
支持：如有问题请在插件发布页面留言

提示：合理设置乞讨范围和角度，可以创造更有趣的游戏互动体验！