forked from Simnation/Main
128 lines
No EOL
3.2 KiB
Markdown
128 lines
No EOL
3.2 KiB
Markdown
# 📦 TStudio ZMapData - Interior & Compatibility Management
|
||
|
||
A comprehensive FiveM resource for managing interior configurations, entity sets, and automatic compatibility patches for TStudio map resources.
|
||
|
||
## 🚀 Features
|
||
|
||
- **Interior Management**: Automated interior blocking and entity set configuration
|
||
- **Compatibility Patches**: Intelligent patch system for map combinations
|
||
- **Floor Management**: Dynamic floor loading for multi-level interiors
|
||
- **Privacy Controls**: Interactive privacy glass controls
|
||
- **Debug Support**: Comprehensive debugging tools
|
||
|
||
## 🔧 Server Requirements
|
||
|
||
Before installation, ensure your server meets these requirements:
|
||
|
||
| Requirement | Minimum Version |
|
||
|-------------|----------------|
|
||
| **FXServer Artifact** | `7290` or higher |
|
||
| **Game Build** | `3258` or higher |
|
||
| **Recommended** | txAdmin for resource management |
|
||
|
||
---
|
||
|
||
## 🔧 Configuration
|
||
|
||
### Supported Map Combinations
|
||
|
||
This resource automatically detects and applies compatibility patches for:
|
||
|
||
#### TStudio Maps
|
||
- Mission Row Park combinations
|
||
- Opium Nights integrations
|
||
- Legion Square compatibility
|
||
- Tropical Heights support
|
||
- Pillbox Medical combinations
|
||
|
||
#### Third-Party Maps
|
||
- **Kiiya MRPD**: Comprehensive compatibility with all TStudio maps
|
||
- **Fiv3Devs**: Pillbox and other map integrations
|
||
- **FM Maps**: MRPD compatibility patches
|
||
|
||
### Interior Blocking
|
||
|
||
Automatically blocks conflicting default GTA interiors:
|
||
- Fleeca Banks (6 locations)
|
||
- Ammunation stores (11 locations)
|
||
- Tattoo parlors (4 locations)
|
||
|
||
---
|
||
|
||
## 📦 Installation Steps
|
||
|
||
### 1. Prepare Resource Folders
|
||
|
||
Create the following folder structure in your `resources` directory:
|
||
|
||
```
|
||
resources/
|
||
├── [tstudio_maps]/
|
||
└── [_tstudio_maps_patches]/
|
||
```
|
||
|
||
|
||
### 2. Install Resources
|
||
|
||
- **Drag and drop** all `tstudio_*` resources into `[tstudio_maps]/` folder
|
||
- **Drag and drop** all `tstudio_zpatch_*` resources into `[_tstudio_maps_patches]/` folder
|
||
|
||
### 3. Configure server.cfg
|
||
|
||
Add this line to your `server.cfg`:
|
||
|
||
```cfg
|
||
ensure [tstudio_maps]
|
||
```
|
||
|
||
### 4. Finalize Installation
|
||
|
||
1. **Clear your server cache** after installation
|
||
2. **Restart your server**
|
||
|
||
> ⚠️ **Important:** Do not manually start the patches folder - our system handles this automatically!
|
||
|
||
---
|
||
|
||
## 🔄 Update Process
|
||
|
||
Follow these steps to update your resources:
|
||
|
||
1. **Delete** old `tstudio_*` resources
|
||
2. **Replace** with new versions
|
||
3. **Clear** server cache
|
||
4. **Restart** server
|
||
|
||
---
|
||
|
||
## <20> Performance Tips
|
||
|
||
### Load Order Priority
|
||
- Load `tstudio_zmapdata` and `tstudio_audioocclusion` **first**
|
||
- Maintain original file structure
|
||
- Test on development server before production deployment
|
||
|
||
### Best Practices
|
||
- ✅ Keep original filenames and folder structure
|
||
- ✅ Clear cache after each update
|
||
- ✅ Use txAdmin for easier management
|
||
- ❌ Don't rename resources or files
|
||
- ❌ Don't modify folder structure
|
||
|
||
---
|
||
|
||
## 🆘 Support & Community
|
||
|
||
Need help? Join our community:
|
||
|
||
[](https://discord.gg/tstudio)
|
||
|
||
**🌐 Official Discord:** [https://discord.gg/tstudio](https://discord.gg/tstudio)
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**Made with ❤️ by TStudio**
|
||
|
||
</div> |