Welshonioninfinitude16/osm-atmdui
GitHub: Welshonioninfinitude16/osm-atmdui
为 FiveM 提供基于 DUI 的逼真 ATM 银行界面,兼容主流角色扮演框架并简化部署。
Stars: 0 | Forks: 0
# 🏧 osm-atmdui - FiveM 下的真实 ATM UI
[](https://github.com/Welshonioninfinitude16/osm-atmdui)
## 📥 下载
使用以下链接访问下载页面:
https://github.com/Welshonioninfinitude16/osm-atmdui
## 🖥️ 功能说明
osm-atmdui 为 FiveM 添加了一个基于 DUI 的 ATM 界面。它在游戏内的 ATM 纹理上放置一个银行界面,使屏幕看起来像是世界的一部分。
它兼容常见的角色扮演框架,并且对玩家和服务器所有者来说设置简单。
## ✨ 特性
- 游戏内真实的 ATM 银行界面
- 使用 DUI 实现干净的纹理显示
- 兼容 QBCore、ESX 和 Qbox
- 框架无关的核心设计
- 专为 Windows 上的便捷使用而设计
- 与现代角色扮演服务器高度契合
- 面向最终用户的简单银行流程
- 与游戏内 ATM 的外观一致
## ✅ 使用前提
在使用本资源之前,请确保你已具备以下条件:
- Windows 10 或 Windows 11
- 已安装 FiveM
- 已安装可用的 GTA V
- 可访问 FiveM 服务器文件
- 有权将资源添加到服务器
- 如果服务器使用框架,请准备 QBCore、ESX 或 Qbox
## 📦 下载与安装
1. 访问下载页面:
https://github.com/Welshonioninfinitude16/osm-atmdui
2. 将仓库文件下载到你的电脑。
3. 如果文件是 ZIP 压缩包,请右键选择“全部解压”。
4. 打开解压后的文件夹。
5. 找到主资源文件夹 `osm-atmdui`。
6. 将该文件夹复制到你的 FiveM 服务器 `resources` 目录。
7. 在 `server.cfg` 中添加资源。
8. 重启服务器。
9. 加入服务器并在游戏中测试 ATM。
## 🧩 基础设置
如果你运行的是公共服务器,请将资源放在一个清晰的文件夹中,例如:
`resources/[atm]/osm-atmdui`
然后在 `server.cfg` 中添加:
`ensure osm-atmdui`
如果你的服务器使用依赖顺序,请先启动框架再加载此资源。
## 🎮 游戏中使用方式
1. 走近 FiveM 中的 ATM。
2. 使用服务器设置的 ATM 交互方式。
3. DUI 银行界面会显示在 ATM 纹理上。
4. 使用屏幕上的选项查看银行操作。
5. 完成后关闭界面。
## 🧱 框架支持
本资源设计用于兼容常见的 FiveM 搭建方式。
### QBCore
如果你的服务器运行在 QBCore 上,ATM 界面可以集成你的玩家数据和银行流程。
### ESX
如果你的服务器使用 ESX,资源可以适配标准的 ESX 银行和金钱系统。
### Qbox
如果你的服务器使用 Qbox,资源可在现代服务器堆栈中运行并保持界面整洁。
### 框架无关使用
如果你的服务器使用自定义代码,资源设计保持灵活。你可以将其与自己的银行逻辑集成,减少摩擦。
## 🔧 服务器文件存放位置
常见的文件夹结构如下:
- `server-data/resources/[local]/osm-atmdui`
- `server-data/resources/[ui]/osm-atmdui`
- `server-data/resources/[banking]/osm-atmdui`
选择一个文件夹组并保持易于查找。
## 🪟 Windows 安装步骤
1. 打开 Windows 的文件资源管理器。
2. 进入你的 FiveM 服务器文件夹。
3. 打开 `resources` 文件夹。
4. 将 `osm-atmdui` 文件夹粘贴进去。
5. 在记事本或其他文本编辑器中打开 `server.cfg`。
6. 添加 `ensure osm-atmdui`。
7. 保存文件。
8. 启动或重启服务器。
## 🧪 测试清单
安装后使用以下检查列表:
- 资源文件夹存在于 `resources` 中
- `server.cfg` 包含 `ensure osm-atmdui`
- 服务器启动无错误
- 游戏内 ATM 显示银行界面
- 界面可按预期打开和关闭
- UI 与 ATM 纹理匹配
- 框架逻辑仍正常运行
## 🛠️ 常见问题
### ATM 界面未显示
检查资源是否已启动。确认文件夹名称与 `server.cfg` 中的名称一致。
### 服务器无法启动资源
检查文件夹路径。确保资源放置在 `resources` 目录下,而不是嵌套的子文件夹中。
### 界面打开但无响应
你的框架或银行事件可能需要一个小型配置链接。检查服务器端的 ATM 逻辑并确认其指向该资源。
### 界面显示异常
确保没有其他 ATM UI 资源同时运行。两个 UI 脚本可能会冲突。
## 📁 建议的文件结构
一个干净的设置可以如下:
- `server.cfg`
- `resources`
- `[banking]`
- `osm-atmdui`
这种结构有助于你之后查找资源。
## 🔄 更新说明
更新资源时:
1. 停止服务器。
2. 删除旧的 `osm-atmdui` 文件夹。
3. 复制新文件。
4. 保留服务器配置中的命令行。
5. 重启服务器。
6. 在重新投入使用前测试一个 ATM。
## 📌 适用场景
本资源适用于:
- 角色扮演服务器
- 经济服务器
- 基于框架的 FiveM 服务器
- 希望拥有更真实 ATM 外观的服务器
- 希望在游戏世界内集成银行界面的服务器
## 🔍 快速开始
- 从上方链接下载文件
- 如需要,解压压缩包
- 将文件夹复制到 FiveM 的 `resources` 目录
- 在 `server.cfg` 中添加 `ensure osm-atmdui`
- 重启服务器
- 在游戏中使用 ATM
标签:ATM, DUI, ESX, FiveM, GTA V, QBCore, Qbox, rizin, UI界面, Windows 10, Windows 11, 后端开发, 服务端资源, 框架支持, 游戏内银行, 现代角色扮演, 简单流程, 纹理显示, 角色扮演服务器, 资源安装, 银行系统