## 功能简介

– 玩家可以使用“姓名更改卡”道具修改游戏内的名字。

– 名字必须包含名和姓（名在前，姓在后）。

– 玩家每 30 秒只能更改一次名字，防止频繁更改。

– 每次成功修改名字后，“姓名更改卡”道具将从玩家的物品栏中移除。

– 每次更改名字的详细信息（旧名、新名、修改时间）都会记录在服务器的日志文件中。

## 安装要求

**重要提示**：由于脚本具有日志记录功能，**必须将本插件放在 `resources` 文件夹的根目录**，不能放置在 `[XXX0]` 或其他带有中括号的子文件夹内，否则日志功能将无法正常工作。

## 安装步骤

1. **上传脚本文件：**

   – 将您下载的脚本文件上传到服务器的 `resources` 根目录下，确保脚本未放置在任何带有中括号的文件夹中，例如 `[scripts]`、`[addons]` 等子文件夹。

   – 请确保资源文件命名为合适的名称，例如 `shouzijun_nccard`，以便服务器正常识别。

2. **添加启动命令：**

   – 在您的服务器配置文件 `server.cfg` 中，添加以下行以确保脚本启动：

     “`plaintext

     ensure shouzijun_nccard

     “`

3. **配置文件：**

   – 打开 `config.lua` 文件并根据需要进行自定义配置。

   – 默认的道具代码为 `ncid`，您可以在 `Config.NameChangeItem` 中自定义您使用的姓名更改卡的代码。

4. **添加改名卡物品到 `qb-core`：**

   – 在 `qb-core/shared/items.lua` 文件中，粘贴以下代码，将“改名卡”道具添加到核心资源库中：

     “`lua

     ncid = {name = “ncid”, label = “改名卡”, weight = 500, type = “item”, image = “np_idcard.png”, unique = false, useable = true, shouldClose = true, combinable = nil, description = “改名卡”},

     “`

   – 这一步非常重要，确保游戏能够正确识别并使用改名卡道具。

   

5. **添加物品图片：**

   – 将 `imgs` 文件夹中的物品图片 `np_idcard.png` 上传到 `qb-inventory/html/images` 目录下。

   – 确保文件名和路径正确，以便物品图标能够在游戏物品栏中正常显示。

## 使用说明

1. **姓名更改卡道具：**

   – 玩家需要持有配置文件中定义的姓名更改卡道具（默认代码为 `ncid`）才能更改名字。

   – 在游戏中，玩家可以通过物品栏使用该道具，之后将弹出一个输入框，提示玩家输入新名字（必须包含名和姓，中间用空格分隔）。

2. **频率限制：**

   – 每位玩家在 30 秒内只能更改一次名字。如果玩家尝试在冷却时间内再次更改名字，系统会提示冷却时间尚未结束。

3. **日志记录：**

   – 所有的名字更改操作都会被记录在服务器的日志文件中，日志文件路径为 `/log.txt`。

   – 每次更改记录包括玩家的服务器 ID、旧名字、新名字和修改时间。

## 常见问题

1. **插件放置位置问题：**

   – **务必将脚本文件放置在 `resources` 文件夹的根目录下**，不能放在带有中括号的子文件夹内（如 `[scripts]`、`[addons]`），否则日志记录功能将会失效。

2. **如何修改姓名更改卡的代码？**

   – 在 `config.lua` 文件中找到 `Config.NameChangeItem`，将其值从 `’ncid’` 更改为您想要的物品代码即可。

3. **玩家没有姓名更改卡，无法使用该功能？**

   – 请确保玩家拥有 `Config.NameChangeItem` 定义的物品。如果您不确定物品代码，可以联系服务器管理员检查配置是否正确。

4. **物品图片不显示？**

   – 请确保 `np_idcard.png` 已正确上传到 `qb-inventory/html/images` 目录，并且文件名与物品配置中的图片名称一致。

## 技术支持

如果您在使用过程中遇到任何问题，欢迎通过购买渠道联系我们的支持团队。我们将竭诚为您提供帮助。

再次感谢您的购买！

—

### 注意

– **脚本必须放置在 `resources` 文件夹的根目录**，放置在 `[XXX0]` 等带有中括号的子文件夹将导致日志功能失效。

– 在 `qb-core/shared/items.lua` 中正确添加道具信息，并将物品图片上传到 `qb-inventory/html/images` 目录下，确保物品能够正常使用和显示。

– 客户端和服务端的代码均已加密，请勿尝试修改加密文件，以免造成不可预知的错误。

– 请根据您的服务器需求合理配置脚本，确保每个玩家都有正确的权限和物品使用权。