ed

resources/[defaultmaps]/tstudio_doortuning/README.md

@@ -0,0 +1,224 @@
+# TStudio Door Tuning Resource
+
+A GTA V FiveM resource for advanced door tuning functionality developed by TStudio3d.
+
+## 📁 Project Structure
+
+```
+tstudio_doortuning/
+├── README.md                           # This file
+├── fxmanifest.lua                     # FiveM resource manifest
+├── gta5.meta                          # GTA V data file configuration
+├── doortuning.ymt                     # Door tuning configuration
+├── heightmap.dat                      # Water level data (enables swimming anywhere)
+└── audio/
+    ├── tstudio_door_game.dat151.nametable  # Audio name table
+    └── tstudio_door_game.dat151.rel        # Audio relations file
+```
+
+## 🚀 For Multimedia Team Members
+
+### Getting Started
+
+1. **Clone the Repository**
+   ```bash
+   git clone https://github.com/TStudio3d/tstudio_doortuning.git
+   cd tstudio_doortuning
+   ```
+
+2. **Switch to Development Branch**
+   ```bash
+   git checkout dev
+   git pull origin dev
+   ```
+
+### 🌿 Working with Feature Branches
+
+#### Creating a New Feature Branch
+
+Always create feature branches from the `dev` branch, not from `main`. This ensures a clean workflow and easier collaboration.
+
+```bash
+# 1. Make sure you're on the dev branch
+git checkout dev
+
+# 2. Pull the latest changes
+git pull origin dev
+
+# 3. Create your feature branch (use descriptive names)
+git checkout -b feature/your-feature-name
+
+# Examples of good branch names:
+# feature/audio-enhancement
+# feature/door-animation-fix
+# feature/new-sound-effects
+# bugfix/door-sync-issue
+# improvement/performance-optimization
+```
+
+#### Working on Your Feature
+
+```bash
+# 1. Make your changes to files
+# 2. Check what files you've modified
+git status
+
+# 3. Add your changes
+git add .
+# or add specific files
+git add filename.ext
+
+# 4. Commit your changes with a descriptive message
+git commit -m "Add new door sound effects for luxury vehicles"
+
+# 5. Push your feature branch to GitHub
+git push -u origin feature/your-feature-name
+```
+
+#### Submitting Your Work
+
+1. **Push your feature branch** to GitHub
+2. **Create a Pull Request** from your feature branch to the `dev` branch
+3. **Request review** from team leads
+4. **Merge** will be handled by team leads after review
+
+#### Keeping Your Feature Branch Updated
+
+```bash
+# While working on your feature, regularly sync with dev branch
+git checkout dev
+git pull origin dev
+git checkout feature/your-feature-name
+git merge dev
+```
+
+### 📋 Branch Strategy
+
+- **`main`** - Production-ready code, stable releases
+- **`dev`** - Development branch, integration of new features
+- **`feature/*`** - Individual feature branches created from `dev`
+- **`bugfix/*`** - Bug fix branches created from `dev`
+- **`hotfix/*`** - Critical fixes that go directly to `main`
+
+### 🎯 File Modification Guidelines
+
+#### Audio Files (`audio/` directory)
+- **What they do**: Handle door sound effects and audio cues
+- **When to modify**: Adding new sounds, adjusting audio timing, fixing audio bugs
+- **Format**: DAT151 format (GTA V audio format)
+
+#### Configuration Files
+- **`fxmanifest.lua`**: Resource configuration for FiveM
+- **`gta5.meta`**: GTA V data file references and configurations
+- **`doortuning.ymt`**: Door behavior and tuning parameters
+
+#### Data Files
+- **`heightmap.dat`**: Water level configuration that enables swimming anywhere on the map
+  - ⚠️ **Note**: This file is not directly related to door tuning but is included here because the resource requires the `gta5.meta` file structure
+- **`doortuning.ymt`**: Core door tuning configurations
+
+### 🛠️ Common Tasks
+
+#### Adding New Audio Files
+1. Place new audio files in the `audio/` directory
+2. Update references in `gta5.meta` if needed
+3. Test in-game before committing
+
+#### Modifying Door Behavior
+1. Edit `doortuning.ymt` for door parameters
+2. Update `gta5.meta` if adding new references
+3. Test functionality thoroughly
+
+#### Performance Optimization
+1. Check file sizes and optimize where possible
+2. Ensure compatibility with existing configurations
+3. Document any breaking changes
+
+#### Understanding the Heightmap File
+The `heightmap.dat` file included in this resource serves a specific purpose:
+- **Primary function**: Configures water levels across the entire GTA V map
+- **Effect**: Allows players to swim anywhere, regardless of terrain elevation
+- **Why it's here**: Despite being unrelated to door tuning, this file is included because:
+  - The resource structure requires the `gta5.meta` configuration file
+  - The meta file provides the framework needed for both door tuning and water level modifications
+  - Bundling them together reduces server resource overhead
+- **⚠️ Important**: Do not modify this file unless you understand water level mechanics
+
+### 🔍 Testing Your Changes
+
+1. **Local Testing**: Always test your changes locally before pushing
+2. **Documentation**: Update relevant documentation for new features
+3. **Compatibility**: Ensure changes don't break existing functionality
+
+### 📞 Getting Help
+
+- **Team Lead**: Contact for major changes or architecture decisions
+- **Documentation**: Check this README and inline code comments
+- **Issues**: Use GitHub Issues for bug reports and feature requests
+
+### 🚫 What NOT to Do
+
+- ❌ Don't commit directly to `main` branch
+- ❌ Don't push broken or untested code
+- ❌ Don't modify files without understanding their purpose
+- ❌ Don't forget to pull latest changes before starting work
+
+### 📝 Commit Message Guidelines
+
+Use clear, descriptive commit messages:
+
+```bash
+# Good examples:
+git commit -m "Add luxury vehicle door sound effects"
+git commit -m "Fix door animation timing issue"
+git commit -m "Optimize audio file loading performance"
+git commit -m "Update door tuning parameters for sports cars"
+
+# Bad examples:
+git commit -m "fix stuff"
+git commit -m "changes"
+git commit -m "audio"
+```
+
+### 🔄 Quick Reference Commands
+
+```bash
+# Clone and setup
+git clone https://github.com/TStudio3d/tstudio_doortuning.git
+cd tstudio_doortuning
+git checkout dev
+
+# Create feature branch
+git checkout -b feature/my-new-feature
+
+# Save your work
+git add .
+git commit -m "Descriptive commit message"
+git push -u origin feature/my-new-feature
+
+# Update from dev
+git checkout dev
+git pull origin dev
+git checkout feature/my-new-feature
+git merge dev
+
+# Check status
+git status
+git log --oneline
+git branch -a
+```
+
+---
+
+## 📄 License
+
+This project is proprietary to TStudio3d. All rights reserved.
+
+## 👥 Contributors
+
+- TStudio3d Team
+- Multimedia Team Members
+
+---
+
+**Remember**: When in doubt, ask! It's better to clarify than to break something. Happy coding! 🚀

resources/[defaultmaps]/tstudio_doortuning/audio/tstudio_door_game.dat151.nametable

@@ -0,0 +1,114 @@
+d_turbosaif_alamo_island_asset_ext_fnc_gatel
+d_turbosaif_alamo_island_asset_ext_fnc_gater
+d_johanni_aldentes_asset_door04_secret
+d_johanni_torture_asset_door
+d_johanni_tstudio_asset_elevator_door_ext
+d_johanni_aldentes_asset_door02
+d_johanni_tstudio_asset_elevator_door
+d_johanni_aldentes_asset_door03_toilet
+d_johanni_aldentes_asset_door01
+d_johanni_aldentes_asset_door05_l
+d_johanni_aldentes_asset_door02b
+d_johanni_aldentes_asset_door05_r
+d_tstudio_qx_ammunation_prop_officedoor
+d_tstudio_qx_ammunation_prop_door01
+d_tstudio_qx_ammunation_prop_officedoor2
+d_tstudio_qx_ammunation_prop_edoor_r
+d_tstudio_qx_ammunation_prop_edoor_l
+d_turbosaif_bennys_room_door03
+d_turbosaif_bennys_main_door02
+d_turbosaif_bennys_room_door
+d_turbosaif_bennys_exitdoor
+d_turbosaif_bennys_main_door01
+d_turbosaif_bennys_room_door02
+d_turbosaif_bennys_garage_door
+d_turbosaif_bennysd_door_r
+d_turbosaif_bennysd_garage_door
+d_turbosaif_bennysd_door_front
+d_turbosaif_racetrack_pitoffice_door02
+d_turbosaif_racetrack_pitoffice_door01
+d_turbosaif_bs_door03
+d_turbosaif_bs_door01
+d_turbosaif_bs_door02
+d_turbosaif_bs_door01_l
+d_turbosaif_carrent_main_door2
+d_turbosaif_carrent_main_door
+d_turbosaif_carrent_door_wc
+d_turbosaif_carrent_door_r
+d_uniqx_flecca_lockerdoor01
+d_uniqx_flecca_secdoor
+d_uniqx_flecca_safedoor02
+d_uniqx_flecca_safedoor01
+d_uniqx_flecca_entrance_door2
+d_uniqx_flecca_entrance_door1
+d_tstudio_impound_entrancegate01
+d_tstudio_impound_door01
+d_johanni_jurassic_asset_door03
+d_johanni_jurassic_asset_door02
+d_johanni_jurassic_asset_door01_wc_r
+d_johanni_jurassic_asset_door03_l
+d_johanni_jurassic_asset_door04
+d_johanni_jurassic_asset_door01_wc_l
+d_johanni_jurassic_asset_elevator_door
+d_adr0o_kebabking_wcdoor
+d_adr0o_kebabking_frontdoor
+d_johanni_frog_asset_door01_r
+d_johanni_frog_asset_door02
+d_johanni_frog_asset_door01_l
+d_johanni_frog_asset_door03
+d_turbosaif_lsia_exitarea_door01
+d_turbosaif_lsia_officearea_exitdoor
+d_johanni_opium_door02
+d_johanni_opium_door01
+d_tstudio_tuner_asset_gdoor2a
+d_tstudio_tuner_asset_gdoor1a
+d_tstudio_jhn_resort_asset_int_door04
+d_tstudio_jhn_resort_asset_int_door03
+d_tstudio_jhn_resort_asset_int_slide_door01
+d_tstudio_jhn_resort_asset_int_slidedoor01
+d_tstudio_jhn_resort_asset_int_door01
+d_tstudio_jhn_resort_asset_int_door02
+d_tstudio_jhn_resort_asset_int_door01b
+d_tstudio_jhn_resort_asset_int_door01c
+d_johanni_pillbox_md_asset_door07
+d_johanni_pillbox_md_asset_door06_r
+d_johanni_pillbox_md_asset_door03_l
+d_johanni_pillbox_md_asset_door02
+d_johanni_pillbox_md_asset_door01
+d_johanni_pillbox_md_asset_door08
+d_johanni_pillbox_md_asset_door03_r
+d_johanni_pillbox_md_asset_door08b
+d_johanni_pillbox_md_asset_garage_door
+d_johanni_pillbox_md_asset_slidedoor
+d_johanni_pillbox_md_asset_door04
+d_johanni_pillbox_md_asset_door06_l
+d_johanni_pillbox_md_asset_door05
+d_tstudio_tuner_asset_gdoor2
+d_tstudio_tuner_asset_gdoor1
+d_tstudio_tuner_asset_door_r
+d_tstudio_tuner_asset_door_l
+d_johanni_church_asset_door01_l
+d_johanni_church_asset_door02
+d_johanni_church_asset_door01_r
+d_turbosaif_taxi_door02
+d_turbosaif_taxi_door01
+d_johanni_skybar_asset_door02_l
+d_johanni_skybar_asset_door01
+d_johanni_skybar_asset_door03
+d_johanni_skybar_asset_door02
+d_johanni_vhotel_asset_ext_door02_r
+d_johanni_vhotel_asset_door01
+d_johanni_vhotel_asset_int_door02_b
+d_johanni_vhotel_asset_int_door02_a
+d_johanni_vhotel_asset_ext_door02_l
+d_turbosaif_vmc_slidedoor02
+d_turbosaif_vmc_slidedoor01
+d_turbosaif_vmc_slidedoor03
+d_turbosaif_vmc_door03
+d_turbosaif_vmc_door05
+d_turbosaif_vmc_door04
+d_turbosaif_vmc_door01
+d_turbosaif_vmc_door_garage
+d_turbosaif_vmc_door_elevator
+d_turbosaif_vmc_ext_door01
+d_turbosaif_vmc_door02

resources/[defaultmaps]/tstudio_doortuning/fxmanifest.lua

@@ -0,0 +1,30 @@
+fx_version 'cerulean'
+lua54 'yes'
+game "gta5"
+replace_level_meta 'gta5'
+
+author 'TStudio'
+description 'Overrides GTA Vanilla doortuning to adapt with TStudio MLOs'
+version '1.0.0'
+
+dependencies { 
+    '/gameBuild:2545',  -- ⚠️PLEASE READ⚠️; Requires at least GAME build 2545.
+    -- 'tstudio_zmapdata',  -- ⚠️PLEASE READ⚠️; Requires to be started before this resource.
+}
+
+data_file 'AUDIO_GAMEDATA' 'audio/tstudio_door_game.dat'
+
+files {
+  'gta5.meta',
+  'doortuning.ymt',
+  'heightmap.dat',
+  'audio/tstudio_door_game.dat151.rel'
+}
+
+escrow_ignore {
+  'gta5.meta',
+  'doortuning.ymt',
+  'heightmap.dat',
+  'audio/*.*'
+}
+dependency '/assetpacks'