Agency-Minerjob：工作脚本应有的真正运作方式

为什么工作通常感觉平淡

大多数 FiveM 工作脚本是重复循环：去 X 点，按 E，等待，在 Y 点出售。玩家做一次赚钱，之后不再作为 RP 参与。Agency-Minerjob 设计让单个工作通过进阶、社交深度和可变产出值得玩家数十小时投入。

有意义的技能进阶

矿工从新手到大师大约需要30小时游戏时间。每个等级解锁新的采矿地点、更好的工具、更稀有的矿石类型和更快的采集速度。进度不仅是收入的倍增，还在每个阶段解锁真正不同的玩法。

环境机制

采矿产出取决于地点质量、时间、天气和工具状况。夜晚晴朗天气下维护良好的镐采金矿的产出与雨天使用磨损工具采煤层的产出不同。这些变量对新玩家不明显，但有经验的矿工会学会优化，这正是让工作长期保持趣味性的涌现式精通。

社交深度

采矿支持2-6人队伍，拥有共享经验池和奖励倍增。队伍越大收益越多，但也更容易成为劫持目标。这创造了真实的社交玩法，协调变得重要，玩家间信任成为游戏内货币。

经济挂钩

原矿是服务器经济其余部分依赖的精炼链的原料。武器制造者需要金属，建筑者需要建筑材料。Agency-Minerjob不是孤立的刷怪循环，而是更广泛经济系统中的供应者角色。这才使得一个职业对服务器真正重要。

安装与设置

Agency-Minerjob requires oxmysql for player progression data and ore yield tracking. Import minerjob.sql，将资源文件夹拖入，并添加 ensure agency-minerjob 到 server.cfg. 采矿位置坐标、矿石类型定义和精炼链物品均定义在 config.lua，默认配置包含 GTA V 默认地图上的八个采矿点。

矿石物品和精炼材料物品需存在于您的框架物品注册表中。配置包含QBCore和ESX的完整物品定义。独立设置通过配置钩子处理物品的给予和移除。

配置选项

该 config.lua 提供对职业机制的深度控制：

• 位置质量，每个矿区有基础产量修正。高质量矿区每次操作产量更高，但可能需要更高技能等级访问。
• 技能等级阈值，定义每个等级所需的XP及每级解锁内容（地点、工具、矿石类型）。
• 环境修饰符，启用/禁用天气和昼夜产出效果并设置乘数范围。
• 工具耐久度，工具在需要维修前可执行的采矿次数。禁用以简化玩法。
• 派对奖金，每增加一名队友的经验和产出倍率，以及最大队伍人数上限。
• 劫持系统，启用可配置队伍规模阈值的敌对NPC或玩家伏击事件。
• 精炼链，定义哪些原矿以何种比例和时间成本精炼成何种材料。

框架兼容性

完整的 QBCore 和 ESX 适配器包含在包内。对于独立部署，实现五个配置函数：物品给予/移除、金钱添加、职业检查（用于矿区访问）和经验值存储。技能进阶引擎、队伍系统、环境机制和精炼链均与框架无关。

为什么这对角色扮演很重要

纯粹作为赚钱手段的职业总感觉空洞。Agency-Minerjob将采矿职业视为有深度的专业，挖矿30小时的角色真正积累了东西：地点知识、工具技能、队友网络、与精炼商和买家的关系。这种积累的角色资本使职业RP可持续。

组队系统特别创造了大多数工作脚本完全缺失的社交RP。两名玩家一起挖矿不仅是产出翻倍，他们还在交谈、建立信任、决定是否邀请尚不完全了解的第三人。更大组队规模的劫持风险促使信任评估：如果这个陌生人让我们成为更大目标，是否值得带上？

供应链集成是将Agency-Minerjob从“采矿脚本”提升为“服务器经济层”的功能。当武器制造商、建筑商和修理包制造商都需要采矿材料时，矿工职业具有永久相关性。矿工不是单独刷，而是供应其他玩家，并与买家建立关系。

常见问题

我可以在DLC或MLO的自定义地图位置添加采矿吗？

是的。采矿地点在config.lua中定义为坐标+半径。添加带室内标志的MLO室内坐标，Agency-Minerjob自动处理室内入口检测。自定义矿石类型和自定义地点同样简单。

技能进度如何在重启后保存？

技能数据存储于 oxmysql，键为玩家标识符。进度在重启、框架更换和角色切换（多角色系统）间持续。唯一重置进度的情况是手动执行清除 SQL 或玩家标识符变更。

我可以禁用环境机制以简化服务器吗？

是的。设置 Config.UseEnvironmentalModifiers = false 在config.lua中。产出仅依赖于技能等级、工具质量和地点质量，这是一个更简单但仍分级的系统。您可以稍后重新启用环境机制；现有玩家进度无缝继承。

Agency-Minerjob在作为主要收入来源与众多工作之一的服务器上是否平衡？

基础配置假设采矿是多个工作选项之一。如果它是您的主要收入来源，请将产量率整体提高40-60%，这里有一个 Config.GlobalYieldMultiplier 专为此目的设计。不要调整单个位置的费率来补偿；使用全局乘数以保持相对平衡不变。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Minerjob 许可证的 cfx.re 账户
• 可选：Agency-Repairkit（制作集成）
• 可选：Agency-Blackmarket（矿石销售经济连接）

作为企业运营采矿公司

Agency-Minerjob's party system and progression tracking make it possible to run actual mining companies as server businesses rather than just individual grinding. Here's what a mining company operation looks like in practice:

公司老板角色招募工人（其他玩家），根据技能等级分配他们到采矿地点，并安排精炼材料的大宗销售给武器制造商、建筑商或黑市。协调多名矿工、管理工具供应（确保每人都有好工具）以及保护大宗矿石运输免遭劫持，形成真正的组织复杂性。

组队奖励倍数创造了协调的经济激励，这不是人为设计的，而是从机制中自然产生。五名协调的矿工每小时收入显著高于五名单独矿工，这意味着协调劳动有可衡量的经济回报。这是使商业组织可持续的设计条件：组织形式必须在经济上优于单打独斗，否则玩家不会为协调的额外成本买单。