File information

Last updated

Original upload

Created by

KH3R0S C0RP

Uploaded by

KH3R0S

Virus scan

Safe to use

About this mod

Take immersion in GTA V to the next level with enhanced visual effects for fire, smoke, and fog.
Inspired by the Ambient FX mod by Dilapidated.

Requirements
Permissions and credits
Donations
README_EN

Real-FX

  • Take immersion in GTA V to the next level with enhanced visual effects for fire, smoke, and fog.
  • Inspired by the Ambient FX mod by Dilapidated. (Link would go here if available/needed)

📌 [Update 1.1] 📌
  • ✅ (Fixed) Native game effect limit (some vehicles may have issues).
  • 📌 Creation of an intelligent priority system to reproduce the effects.
  • 📌 Optimisation of the pooling system.
  • 📌 Added logs for SHVDN.

🌟 Features 🌟
  • Dynamic and Realistic Effects: 🔥💨🌫️ Visually enhances fire, smoke, and fog on vehicles and pedestrians. More configurable than ever!
  • Optimal Performance (Effect Pooling): 🚀 Enjoy massive explosions without FPS drops. Advanced effect reuse system!
  • Total Customization (In-Game Menu & Config.ini): ⚙️ Adjust EVERYTHING to your liking: scale, opacity, detection radius, and much more. Tailored visual experience!
  • Intelligent Detection Radius: 🎯 Define the radius to detect fires. Optimize performance in populated areas or detect distant fires.
  • Adjustable Update Interval: ⏱️ Control the effect update frequency. Balance visual quality and performance.
  • User-Definable Max Active Effects: 🎛️ Limit simultaneous effects for smooth gameplay even in total chaos.
  • Configurable Menu Key: ⌨️ Choose your key to open the RealFX menu (F5-F12). Quick access to options!
  • Periodic Re-scanning: 🔄 Detects new fires in real-time.
  • Forced Effect Cleanup: 🧹 Deactivate the mod and automatically clean up all active effects. Smooth transition!
  • Detailed Logging: 📝 Logs.log file for advanced users and devs. Diagnose problems or technical curiosity!
  • Modular Effect Handlers: 🧩 Modular architecture for future expansions and new effects. Mod constantly evolving!
  • Opacity Optimization: 👁️ Effects with dynamic opacity for natural and harmonious visual integration.

🛠️ Installation 🛠️
  • Indispensable Prerequisites: ⚠️
    • ScriptHookV (Link needed)
    • ScriptHookVDotNet-Nightly-3.7.0 (Link needed)
    • LemonUI (Link needed)
    • (All included in the mod's lib folder!)
  • Download RealFX: ⬇️ Get the latest version.
  • Integration into GTA V: 📂
    • Open your GTA V main directory.
    • Go to the /scripts/ folder (create it if it doesn't exist).
    • Copy the RealFX folder into the /scripts/ folder.
    • Ensure LemonUI.SHVDN3.dll and ScriptHookVDotNet3.dll are in the main game directory or in /scripts/.
    • On the first launch of GTA V after installation, the Config.ini file will be automatically created in /scripts/RealFX/.


⚙️ Advanced Configuration (Config.ini) ⚙️
  • Path: /scripts/RealFX/Config.ini
  • [Mod] ModEnabled: true to enable the mod when GTA V starts, false to keep it disabled without uninstalling.
  • [Mod] ShowNotifications: true to display on-screen notifications (useful for debugging), false for cleaner gameplay.
  • [Mod] DebugMode: true for extended debug information in the log file (for developers or advanced users).
  • [Performance] MaxActiveEffects: Maximum number of simultaneous effects (Range: 0-12). (Default: 12)
  • [Performance] MinPoolSize: Minimum number of pre-created effects in the pool for faster response. (Default: 50)
  • [Performance] MaxPoolSize: Maximum size of the effect pool to limit memory usage. (Default: 500)
  • [Performance] CleanupCooldown: Time in seconds before inactive effects are cleaned up from the pool (-1 disables automatic cleanup). (Default: 60)
  • [Performance] DetectionRadius: Radius (in meters) within which fires are detected (-1 for infinite radius). (Default: -1)
  • [Performance] UpdateInterval: How often the mod checks for updates and manages effects (in milliseconds). Lower values mean faster updates but potentially more performance impact. (Default: 250)
  • [Effects] DetectionRadius: Maximum distance (in meters) at which effects are rendered. (Default: 3000.0)
  • [Effects] FireScale, SmokeScale, FogScale: Multiplier for the size of each effect type (Range: 0.1 - 10.0). (Default: 1.0)
  • [Effects] FireOpacity, SmokeOpacity, FogOpacity: Opacity (transparency) of each effect type (Range: 0.0 - 1.0). (Default: 1.0)
  • [Effects] FireRed, FireGreen, FireBlue: RGB color components for fire effects (Range: 0.0 - 3.0, allowing for HDR colors). (Default: 1.0, 1.0, 1.0)
  • [Effects] SmokeRed, SmokeGreen, SmokeBlue: RGB color components for smoke effects. (Default: 1.0, 0.7, 0.5 - grayish)
  • [Effects] FogRed, FogGreen, FogBlue: RGB color components for fog effects. (Default: 1.0, 0.7, 0.5 - grayish)
  • [EffectTypes] VehicleFire, VehicleSmoke, VehicleFog, PedFire: Enable (true) or disable (false) specific effect types.
  • [KeyBindings] MenuKey: Key used to open the in-game menu (Valid keys: F5-F12). (Default: F7)
  • [UI] GlobalMenuScale: Adjusts the size of the in-game menu (Range: 0.6 - 1.3). (Default: 1.0)

🎮 Interactive In-Game Menu 🎮
  • Access by pressing the key configured in Config.ini (F7 by default).
  • Allows you to enable/disable the mod and adjust most parameters in real-time without needing to edit the configuration file!

🚀 First Steps and Effective Use 🚀
  • RealFX is enabled by default when GTA V starts if ModEnabled is set to true in Config.ini.
  • Use the in-game menu (F7) to quickly toggle the mod or tweak settings.
  • Experiment with the configuration options in Config.ini or the menu to find the perfect balance between visual enhancement and performance for your system.

🐞 Known Bugs 🐞
  • Potential FPS drop when using very large effect scales or when getting extremely close to many simultaneous effects.
  • (TEST) Possible game crashes during the loading screen (investigating).

🙏 Acknowledgments and Credits 🙏
  • Created by KH3R0S C0RP.
  • Special recognition to Dilapidated for the original Ambient FX mod inspiration.
  • Credits to the creators of ScriptHookV, ScriptHookVDotNet, and LemonUI.

ENJOY!


README_ES

Real-FX

  • Lleva la inmersión en GTA V a otro nivel con efectos visuales mejorados de fuego, humo y niebla.
  • Inspirado en el mod Ambient FX de Dilapidated. (Link iría aquí si estuviera disponible/fuera necesario)

📌 [Actualización 1.1] 📌
  • ✅ (Arreglado) Límite nativo de efectos del juego (algunos vehículos pueden tener problemas).
  • 📌 Creación de un sistema inteligente por prioridades para reproducir los efectos.
  • 📌 Optimización del sistema de pools.
  • 📌 Añadidos logs para SHVDN.

🌟 Características 🌟
  • Efectos Dinámicos y Realistas: 🔥💨🌫️ Mejora visualmente el fuego, humo y niebla en vehículos y peatones. ¡Más configurable que nunca!
  • Rendimiento Óptimo (Pooling de Efectos): 🚀 Disfruta de explosiones masivas sin caídas de FPS. ¡Sistema avanzado de reutilización de efectos!
  • Personalización Total (Menú In-Game y Config.ini): ⚙️ Ajusta TODO a tu gusto: escala, opacidad, radio de detección y mucho más. ¡Experiencia visual a medida!
  • Radio de Detección Inteligente: 🎯 Define el radio para detectar incendios. Optimiza rendimiento en zonas pobladas o detecta incendios lejanos.
  • Intervalo de Actualización Ajustable: ⏱️ Controla la frecuencia de actualización de efectos. Equilibra calidad visual y rendimiento.
  • Máximo de Efectos Activos Definible: 🎛️ Limita los efectos simultáneos para un gameplay fluido incluso en caos total.
  • Tecla de Menú Configurable: ⌨️ Elige tu tecla para abrir el menú de RealFX (F5-F12). ¡Acceso rápido a opciones!
  • Re-escaneo Periódico: 🔄 Detecta nuevos incendios en tiempo real.
  • Limpieza Forzada de Efectos: 🧹 Desactiva el mod y limpia todos los efectos activos automáticamente. ¡Transición suave!
  • Logging Detallado: 📝 Archivo Logs.log para usuarios avanzados y devs. ¡Diagnostica problemas o curiosidad técnica!
  • Handlers de Efectos Modulares: 🧩 Arquitectura modular para futuras expansiones y nuevos efectos. ¡Mod en constante evolución!
  • Optimización de Opacidad: 👁️ Efectos con opacidad dinámica para integración visual natural y armoniosa.

🛠️ Instalación 🛠️
  • Requisitos Indispensables: ⚠️
    • ScriptHookV (Link necesario)
    • ScriptHookVDotNet-Nightly-3.7.0 (Link necesario)
    • LemonUI (Link necesario)
    • (¡Todos incluidos en la carpeta lib del mod!)
  • Descarga RealFX: ⬇️ Obtén la última versión.
  • Integración en GTA V: 📂
    • Abre el directorio principal de GTA V.
    • Ve a la carpeta /scripts/ (si no existe, créala).
    • Copia la carpeta RealFX dentro de la carpeta /scripts/.
    • Asegúrate de que LemonUI.SHVDN3.dll y ScriptHookVDotNet3.dll estén en el directorio principal del juego o en /scripts/.
    • Al iniciar GTA V por primera vez tras la instalación, se creará automáticamente el archivo Config.ini en /scripts/RealFX/.


⚙️ Configuración Avanzada (Config.ini) ⚙️
  • Ruta: /scripts/RealFX/Config.ini
  • [Mod] ModEnabled: true para activar el mod al iniciar GTA V, false para desactivarlo sin desinstalar.
  • [Mod] ShowNotifications: true para mostrar notificaciones en pantalla (útil para depuración), false para un juego más limpio.
  • [Mod] DebugMode: true para información de depuración extendida en el archivo de log (para desarrolladores o usuarios avanzados).
  • [Performance] MaxActiveEffects: Número máximo de efectos simultáneos (Rango: 0-12). (Default: 12)
  • [Performance] MinPoolSize: Número mínimo de efectos pre-creados en el pool para respuesta rápida. (Default: 50)
  • [Performance] MaxPoolSize: Tamaño máximo del pool de efectos para limitar el uso de memoria. (Default: 500)
  • [Performance] CleanupCooldown: Tiempo en segundos antes de limpiar los efectos inactivos del pool (-1 desactiva la limpieza automática). (Default: 60)
  • [Performance] DetectionRadius: Radio (en metros) dentro del cual se detectan incendios (-1 para radio infinito). (Default: -1)
  • [Performance] UpdateInterval: Frecuencia con la que el mod comprueba actualizaciones y gestiona efectos (en milisegundos). Valores bajos significan actualizaciones más rápidas pero potencialmente mayor impacto en rendimiento. (Default: 250)
  • [Effects] DetectionRadius: Distancia máxima (en metros) a la que se renderizan los efectos. (Default: 3000.0)
  • [Effects] FireScale, SmokeScale, FogScale: Multiplicador para el tamaño de cada tipo de efecto (Rango: 0.1 - 10.0). (Default: 1.0)
  • [Effects] FireOpacity, SmokeOpacity, FogOpacity: Opacidad (transparencia) de cada tipo de efecto (Rango: 0.0 - 1.0). (Default: 1.0)
  • [Effects] FireRed, FireGreen, FireBlue: Componentes de color RGB para efectos de fuego (Rango: 0.0 - 3.0, permite colores HDR). (Default: 1.0, 1.0, 1.0)
  • [Effects] SmokeRed, SmokeGreen, SmokeBlue: Componentes de color RGB para efectos de humo. (Default: 1.0, 0.7, 0.5 - grisáceo)
  • [Effects] FogRed, FogGreen, FogBlue: Componentes de color RGB para efectos de niebla. (Default: 1.0, 0.7, 0.5 - grisáceo)
  • [EffectTypes] VehicleFire, VehicleSmoke, VehicleFog, PedFire: Activa (true) o desactiva (false) tipos de efectos específicos.
  • [KeyBindings] MenuKey: Tecla usada para abrir el menú in-game (Teclas válidas: F5-F12). (Default: F7)
  • [UI] GlobalMenuScale: Ajusta el tamaño del menú in-game (Rango: 0.6 - 1.3). (Default: 1.0)

🎮 Menú In-Game Interactivo 🎮
  • Accede presionando la tecla configurada en Config.ini (F7 por defecto).
  • ¡Permite activar/desactivar el mod y ajustar la mayoría de parámetros en tiempo real sin necesidad de editar el archivo de configuración!

🚀 Primeros Pasos y Uso Efectivo 🚀
  • RealFX se activa por defecto al iniciar GTA V si ModEnabled está en true en Config.ini.
  • Usa el menú in-game (F7) para activar/desactivar rápidamente el mod o ajustar la configuración.
  • ¡Experimenta con las opciones de configuración en Config.ini o el menú para encontrar el equilibrio perfecto entre mejora visual y rendimiento para tu sistema!

🐞 Errores Conocidos 🐞
  • Posible caída de FPS al usar escalas de efectos muy grandes o al acercarse extremadamente a muchos efectos simultáneos.
  • (TEST) Posibles crasheos del juego durante la pantalla de carga (investigando).

🙏 Agradecimientos y Créditos 🙏
  • Creado por KH3R0S C0RP.
  • Reconocimiento especial a Dilapidated por la inspiración del mod original Ambient FX.
  • Créditos a los creadores de ScriptHookV, ScriptHookVDotNet y LemonUI.

¡DISFRUTA!