🎉 sh-lib | 通用 UI & 工具框架
🚀 支持框架：QBCore / QBX / ESX /OX /Standalone
🧩 简介 · Introduction
sh-lib 是一款专为 FiveM 服务器开发者 设计的 轻量级 UI 与功能框架库，
它提供统一的视觉风格、标准化调用方式和高性能前后端通信结构。
这是我花费很长时间的测试，以及在每个框架进行不同维度的测试，确保能以所有的框架进行共存
最初只是为了方便我以后写插件能不依赖其他框架，现在我把它免费放出来，托管只是为了防止
他们进行篡改进行订价销售，里面已经写出了我所有功能的使用方法及调用的方法！
后续会进行持续的优化和使用，可能在使用的过程中会出现很多我未遇到过的Bug或未知的问题！
如发现可以联系我进行反馈，但我不对此脚本进行技术支持，我会将我收到的反馈不定时的进行修复！
💡 sh-lib = 类似 ox_lib，但更轻、更美、更统一。
同时是所有「SH插件」的核心依赖，也可单独使用。
🌈 特点 · Features
- ✅ Liquid Glass / iOS26 风格 — 磨砂玻璃质感 + 动画流畅
- ✅ 模块化架构 — 各模块可独立启用或单独加载
- ✅ 跨框架兼容 — 自动识别 QBCore、QBX、ESX 或独立运行
- ✅ 统一调用方式 —
exports['sh-lib']一键调用所有模块 - ✅ 多语言支持 — JSON 本地化系统，默认中英双语
- ✅ 前后端分离 — UI 完全独立，兼容任意脚本
- ✅ 免费使用 / 商业友好 — 可自由集成，仅限制核心修改
🧠 模块总览 · Modules Overview
模块
功能说明
默认位置
🔔 Notify
通知系统（标题/内容/类型/时长/位置/声音/堆叠）
Top-Center
💬 TextUI
屏幕提示（如“按 E 打开商店”）
Middle-Left
⏳ Progress
进度条系统（动画、取消、道具绑定）
Bottom-Center
📋 Menu
菜单系统（鼠标/键盘导航、图标、描述）
Middle-Center
✍️ Input
输入框系统（文本、多字段、选择框、复选框）
Middle-Center
⚡ Dialog
对话框系统（确认/取消、超时、队列）
Middle-Center
🎯 Skillbar
技能条系统（多轮挑战、成功判定）
Bottom-Center
🌀 Radial Menu
环形菜单（队列、二级菜单、鼠标交互）
Middle-Center
🧰 技术亮点 · Technical Highlights
- 🔄 统一的 NUI 通信结构（SendNUIMessage + Promise 回调）
- 🧱 公共库
common.css/common.js提供统一样式与工具函数 - 🌍 自动加载
/locales/*.json本地化文件 - 🔊 声音系统支持模块独立音效
- ⚙️ 全局配置集中在
config.lua - 🧪 调试模式下自动启用测试命令
💡 开发者信息 · Developer Info
- 语言：中文 / English
- 框架支持：QBCore / QBX / ESX / Standalone
- 依赖插件：无，可与 ox_lib 共存
- 推荐配套：ox_inventory · ox_target · oxmysql
🔒 使用条款 · License
- ✅ 免费使用与分发
- ✅ 允许修改配置文件与语言文件
- ❌ 禁止修改或反编译核心文件
- ❌ 禁止去除作者与版权信息
🌟 总结 · Summary
sh-lib 是一个 “更轻、更美、更兼容” 的 FiveM 通用 UI 框架。
让开发者以最少的代码构建出统一、高级的视觉体验。
它不仅是「SH插件」生态的核心依赖，
更是打造顶级 FiveM UI 的最佳起点。
