Fire

# fire_mining 安装文档

一套以挖矿为核心、含合成 / 推车 / 当铺 / 等级 / 反作弊 的 FiveM 资源 (基于 ESX/ox 框架)。

---

## 简介

| 模块 | 说明 |

|------|------|

| 矿区 | 3 块独立矿区, 每块按权重随机刷出不同等级的矿石 (煤/金/翡翠/红/紫/钻) |

| 挖矿 | 走近矿石 → 自动靠近 + 面朝 → 锁人 → 挥镐 + 打铁声 + 碎石粒子 (附近 30m 玩家同步看到) |

| 推车 | 三档推车 (Lv1/Lv50/Lv100), 是玩家权限不是物品; 矿物先入"手中" → 储存到推车 → 走到运输带流式入背包 |

| 运输带 | 流式派件, 每 0.2s 派 1 件矿石模型滚到末端, 前 50 件广播给附近玩家, 之后仅本地显示 |

| 推车遗失 | 部署后离线 / 超范围 → 推车标记 lost, G 键失效, 必须到矿工 NPC 付 $2000 强制回收 |

| 合成台 | 独立 NUI 菜单, 21 种配方 (金/翡翠/红宝石/紫水晶/钻石珠宝 + 重型手枪) |

| 商店 | 矿工 NPC 同时承载商店 (买镐子) + 当铺 (卖矿物/珠宝, 给钱 + XP) |

| 矿石图鉴 | 主菜单"图鉴"自动列出全部矿物的等级 / 耗时 / 经验 / 耐久 / 掉落明细 |

| 等级系统 | 无上限公式 `Base * (Growth^(N-1) - 1) / (Growth - 1)`, 默认 Base=3500 Growth=1.1 |

| 反作弊 | Token 一次性校验 + 速率限制 + 数值边界 + 累计 3 次 ElectronAC ban |

| 排行榜 NPC | 前 3 名玩家在矿区入口生成 ped (自动复制 users.skin 服装), 头顶 3D 文字显示角色名 |

---

## 依赖

必装:

- [oxmysql](https://github.com/overextended/oxmysql/releases)

- [ox_lib](https://github.com/overextended/ox_lib/releases)

- [ox_target](https://github.com/overextended/ox_target/releases) (其它如 qb-target / interact 也支持, 改 `config/shared.lua` setup.interact)

- [ox_inventory](https://github.com/overextended/ox_inventory) (强烈推荐, 物品图标 NUI 路径默认指向它的 `web/images/`)

可选:

- [9am-textui]https://9am.dev/scripts/escrow/3d-text-ui 熔炼台按 E 提示用 (没有也能用, 只是少了那块文字提示)

- [ElectronAC] 反作弊 ban 工具 (没装则踢出玩家, 不影响功能)

- [fiveguard] 反作弊 ban 工具 (没装则踢出玩家, 不影响功能)

---