198 lines
6.3 KiB
Markdown
198 lines
6.3 KiB
Markdown
# 🌉 Community Bridge
|
|
> **By The Order of the Sacred Framework**
|
|
|
|
<div align="center">
|
|
|
|

|
|

|
|

|
|
|
|
*A modular, beginner-friendly collection of tools and systems designed to simplify and unify FiveM development.*
|
|
|
|
**Built with ❤️ by the community, for the community**
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## ✨ Overview
|
|
|
|
**Community Bridge** is a comprehensive compatibility layer that unifies development across different FiveM frameworks and resources. Whether you're building with QB-Core, ESX, QBox, or any other framework, this bridge ensures your scripts work seamlessly across all environments.
|
|
|
|
### 🎯 Core Philosophy
|
|
- 🔧 **Plug & Play** - Drop in and it just works
|
|
- 🌐 **Universal Compatibility** - One bridge, all frameworks
|
|
- 📚 **Beginner Friendly** - Clean, documented, and easy to understand
|
|
- 🚀 **Future Proof** - Built to adapt and grow with the community
|
|
|
|
---
|
|
|
|
## 🚀 Features
|
|
|
|
### 📦 **Inventory Systems**
|
|
<details>
|
|
<summary>Click to expand supported inventories</summary>
|
|
|
|
- `ox_inventory` ⭐
|
|
- `codem-inventory`
|
|
- `core_inventory`
|
|
- `jpr-inventory`
|
|
- `origin_inventory`
|
|
- `ps-inventory`
|
|
- `qb-inventory`
|
|
- `qs-inventory`
|
|
- `tgiann-inventory`
|
|
|
|
**Bonus:** Built-in item output generator supporting `ox_inventory`, `qb-new`, and `qb-old` formats!
|
|
</details>
|
|
|
|
### 🚨 **Dispatch Systems**
|
|
<details>
|
|
<summary>Click to expand supported dispatch systems</summary>
|
|
|
|
- `lb-tablet`
|
|
- `ps-dispatch`
|
|
- `qs-dispatch`
|
|
- `redutzu-mdt`
|
|
- `tk_dispatch`
|
|
- `linden_outlawalert`
|
|
- `cd_dispatch`
|
|
- `bub_mdt`
|
|
|
|
**Plus:** Built-in fallback system ensures notifications always reach their destination.
|
|
</details>
|
|
|
|
### 🔐 **Framework Support**
|
|
- **QB-Core** - Full compatibility
|
|
- **QBox** - Native support
|
|
- **ESX** - Complete integration
|
|
- **Custom Frameworks** - Extensible design
|
|
|
|
### 🏗️ **Additional Modules**
|
|
|
|
| Module | Description | Compatibility |
|
|
|--------|-------------|---------------|
|
|
| 🚪 **Doorlock** | Universal door management | `ox_doorlock`, `qb-doorlock`, `rcore_doorlock`, `jacksams-doorlock` |
|
|
| ⛽ **Fuel Systems** | Seamless fuel integration | All major fuel resources |
|
|
| 📱 **Phone** | Cross-phone compatibility | All major phone systems |
|
|
| 🎯 **Targeting** | Universal targeting system | `qb-target`, `ox_target`, `sleepless-interact` |
|
|
| 🔑 **Vehicle Keys** | Key management bridge | All major key systems |
|
|
| 🛍️ **Shops** | In-house shop system | Simple, expandable design |
|
|
| 📊 **Progress Bars** | Universal progress system | Most common progress resources |
|
|
| 🌤️ **Weather** | Weather control bridge | Most weather resources |
|
|
| 🎮 **Skills** | Skill system integration | Most skill systems |
|
|
|
|
### 🛠️ **Utility Features**
|
|
- 🌍 **Locale Support** - Multi-language ready
|
|
- 🧮 **Math Utilities** - Common mathematical functions
|
|
- 🔧 **Helper Functions** - Rich collection of development tools
|
|
- 📏 **Input Systems** - `qb-input` and `ox_lib` compatible
|
|
- 📋 **Menu Systems** - Interchangeable QB and ox_lib formats
|
|
- ✅ **Version Checker** - Built-in update management
|
|
|
|
Whether you're building a full framework or just need utility features, **Community Bridge** is designed to make your workflow easier and more efficient.
|
|
|
|
---
|
|
|
|
## 🤝 Community-Driven
|
|
|
|
This project includes contributions and snippets from across the development community. Some modules are under the **GPLv3 license**, with proper credit given in the `Attributions` file.
|
|
|
|
Our mission: to promote open collaboration, reduce friction between systems, and create a unified foundation for all developers—regardless of framework or experience.
|
|
|
|
---
|
|
|
|
## 🧰 Why Use Community Bridge?
|
|
|
|
- ✅ Easy for beginners
|
|
- 🔄 Highly modular and extendable
|
|
- 🔌 Compatible with all major scripts and systems
|
|
- 🔧 Built-in compatibility wrappers
|
|
- 📦 Future-proof and easy to expand
|
|
- 🤝 Built with community-first values
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Installation
|
|
1. **Download** the latest release from GitHub
|
|
2. **Extract** to your resources folder: `[bridges]/community_bridge`
|
|
3. **Add** to your `server.cfg`:
|
|
```cfg
|
|
ensure community_bridge
|
|
```
|
|
4. **Restart** your server
|
|
|
|
---
|
|
|
|
## 📚 Documentation
|
|
|
|
Read the full documentation here:
|
|
👉 [Our Gitbook Here](https://mrnewbs-scrips.gitbook.io/the-order-of-the-sacred-framework)
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
We welcome contributions from the community! Here's how you can help:
|
|
|
|
### How to Contribute
|
|
1. **Fork** this repository
|
|
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
|
|
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
|
|
4. **Push** to the branch (`git push origin feature/amazing-feature`)
|
|
5. **Open** a Pull Request
|
|
|
|
### Guidelines
|
|
- ✅ Follow existing code style and patterns
|
|
- ✅ Test your changes thoroughly
|
|
- ✅ Update documentation when needed
|
|
- ✅ Be respectful and constructive in discussions
|
|
|
|
---
|
|
|
|
## 💬 Join the Community
|
|
|
|
Have questions, suggestions, or want to contribute? Join us on Discord:
|
|
👉 [Our Discord Here](https://discord.gg/MukwBuJjP7)
|
|
|
|
### Community Resources
|
|
- 📖 **Wiki** - Comprehensive guides and tutorials
|
|
- 🐛 **Bug Reports** - Help us improve by reporting issues
|
|
- 💡 **Feature Requests** - Share your ideas with the community
|
|
- 🎯 **Support** - Get help from experienced developers
|
|
|
|
---
|
|
|
|
## 📄 License
|
|
|
|
This project is licensed under the **GPLv3 License** - see the [LICENSE](LICENSE) file for details.
|
|
|
|
### Attribution
|
|
Some modules include contributions from the FiveM community. Full attributions are listed in the `Attributions` file.
|
|
|
|
---
|
|
|
|
## ⭐ Support the Project
|
|
|
|
If Community Bridge has helped your development workflow, consider:
|
|
- ⭐ **Starring** this repository
|
|
- 🐛 **Reporting** bugs and issues
|
|
- 💡 **Suggesting** new features
|
|
- 🤝 **Contributing** code or documentation
|
|
- 💬 **Sharing** with other developers
|
|
|
|
---
|
|
|
|
> "A bridge built not for one, but for all — strong, simple, and open."
|
|
|
|
<div align="center">
|
|
|
|
**Made with ❤️ by The Order of the Sacred Framework**
|
|
|
|

|
|

|
|
|
|
</div>
|