khorio

AGS: Accurate Gauge SystemThe end of arcade driving. Most GTA V vehicles feel like indestructible slot cars. You floor the gas, the car goes, and the gauges are just static decorations. AGS changes the fundamental relationship between you and your patrol vehicle. By simulating the hidden stresses of mechanical driving, from wind resistance to alternator load, AGS turns every pursuit into a test of man and machine. A Dashboard That Lives Forget the static mini-map HUD. AGS introduces a professional-grade instrumentation suite that reacts to the physics of the world. Mechanical Needle Fidelity: Experience the "wobble" of an aging engine and the violent bounce of the needle when you hit the rev limiter. Fluid Physics: Your fuel gauge isn't a progress bar; it’s a tank of liquid. Watch the needle "slosh" as you dive into hard corners or slam on the brakes. The Interior Experience: Small details matter. The system provides high-fidelity (is this an ai word again?) feedback for turbo boost, oil pressure, and engine temperature. Automatic RPM Range: Vehicles with a higher RPM range will automatically swap to a texture supporting the rev limiter. Measurement Unit Support: AGS will automatically detect your measurement unit (Miles|Gallons|F|$, KM|L|C|EUR), you can override these units to your preference from within the menu. The "Live Design" Suite You shouldn't have to be a coder to have a beautiful HUD. AGS includes a powerful, drag-and-drop Live Editor. Total Creative Freedom: Open the menu and literally grab your gauges with your mouse (you can't actually grab them individually, but this sets up the paragraph). Scale them or tuck a digital speedometer inside an analog dial. Visual Inspector: Change colors and toggle sub-components in real-time. Whether you want a minimalist modern look or a cluttered "old-school" cruiser vibe, you can build it in seconds without ever leaving the game. Skin & Palette presets: Create, load & save your own (or others) skin and color palettes. AGS comes with 2 Texture packs, 5 skins and 31 color palette presets. True-to-Life Simulation AGS tracks the variables that modern games usually ignore. Every mile driven is a calculation of efficiency and wear. Beyond the Fuel Tank: Consumption is dictated by reality. If you’re towing a heavy vehicle, running your sirens/lightbars (electrical load), or driving a cruiser with the doors ripped off (aerodynamic drag), you will watch your fuel disappear faster. Terrain & Surface Logic: Driving through mud or sand creates rolling resistance, while steep hills force the engine to work harder. Even the "quality" of the gas station you choose matters—low-grade fuel can lead to stutters and misfires during high-speed chases. The "Cold Start" Reality: Engines don't perform perfectly the moment you turn the key. AGS simulates thermal curves; your car needs to reach its optimal temperature for peak performance, and it can suffer from "Heat Soak" if pushed too hard in the Los Santos heat. Professional Driver Assists For the long-shift patrol officer, AGS provides the tools to make driving feel like a profession. Precision Cruise & Limiting: Use the PID-based Cruise Control to maintain an exact speed over hilly terrain, or set a hard Speed Limiter to stay in perfect formation with your partners. Intelligent Initialization: Every car you enter has a history. Based on the neighborhood and the vehicle, the fuel level is intelligently randomized. You might jump into a luxury car with a full tank, or a beat-up sedan that’s running on fumes and a prayer. THE TACTICAL SYMBOL CLUSTERThe AGS Symbol Cluster is a dedicated, real-time diagnostic suite that brings your vehicle’s dashboard to life. Unlike basic HUDs that only show a speed number, this system monitors the internal health and electrical state of your cruiser, displaying icons exactly when you need to see them. Real-Time Mechanical DiagnosticsThe cluster is directly tethered to the vehicle’s physics engine. You aren't just seeing lights; you’re seeing the live status of your machine: Critical Alerts (Red): Immediate warnings for Oil Pressure, Battery Voltage, Engine Temperature, and Brake System failures. Mechanical Safety (Amber): Stay informed on ABS activation, Tire Pressure fluctuations, and Check Engine status. Lighting & Signals: Visual confirmation for High Beams, Fog Lights, Daytime Running Lights, and synchronized Turn Signal indicators. Tactical Sync (Cruise & Limiter)The cluster includes a dedicated icon that illuminates whenever the Cruise Control or Speed Limiter is active. This provides an instant visual cue that the internal PID-controller is managing your throttle, allowing you to focus on the road and your surroundings during a pursuit or a long highway patrol. Customizing Your LayoutThe Symbol Cluster is a fully modular widget. Using the In-Game Live Editor, you can treat the symbols as their own standalone element: Positioning: Drag the entire cluster to a location that fits your screen layout—place it between your main gauges, at the top of your dashboard, or as a minimalist bar at the bottom of the screen. Scaling: Adjust the size of the icons to ensure they are readable at a glance without obstructing your view. InstallationAGS requires a dlc to be loaded, the download includes both the LML package and manual installation. Instructions can be found in the download. DEFAULT KEYSAll keybinds can be changed within the menu (Under system settings). If the default menu keybind is conflicting with another plugin you can change it through the console (F4->SetAGSMenuKey) Menu: F11 Move Gauges: F12 (Hold while dragging) Refuel: N (Hold down for manual or Double tap to auto refuel) Cruise Control: T Speed Limiter: Shift+T Modify Cruise Control\Speed Limiter target: PageUp\PageDown CUSTOM SKIN DESIGN: THE RIGID SPECIFICATIONS AGS uses a high-performance, stack-based rendering engine. Unlike generic HUD mods, AGS does not handle per-layer offsets. To ensure your skin renders correctly, you must adhere to the following hardcoded architectural rules. 1. The Square Canvas Rule Dimensions: All textures must be designed on a perfectly square canvas (e.g., 512x512). The Center-Point: The engine draws every layer at the exact same coordinates and rotates the needle around the absolute center of the square (256, 256). Centering: You must center your gauge face and the "pin" of your needle perfectly in your image editor. The code will not reposition them for you. 2. Hardcoded Texture NamingThe TextureResolver assembles names based on the Gauge Type, Layer Name, and optional Suffixes (Unit/Time). Inside your .ytd, your textures must match these Base Names: Layer Key Texture Base Name Purpose TX_UNDERLAY UNDERLAY The primary static background/face of the gauge. TX_FILL FILL The background layer for digital displays or secondary solid fills. TX_NEEDLE NEEDLE The rotating element. TX_NUMBERS NUMBERS The numerical dial (supports Metric/Imperial variants). TX_LABEL LABEL Text indicators (e.g., "MPH", "RPM"). TX_LED_ON/OFF LED_ON / LED_OFF Status and warning lights. TX_REDLINE REDLINE High-RPM limit markings. TX_LMAJOR / LMINOR LINES_MAJOR / LINES_MINOR Primary and secondary tick marks. TX_GLASS GLASS Glass overlay. 3. Naming Assembly & Fallbacks The TextureResolver generates names using a PREFIX_BASENAME_SUFFIX pattern. Prefixes: Automatically added based on the gauge (SPEEDO_, FUEL_, TURBO_, OIL_, TEMP_). Suffixes: * _KMH or _MPH are appended for NUMBERS and LABEL layers based on user settings. _NIGHT is appended to all primary layers when the headlights are on. Logic: If SPEEDO_NUMBERS_KMH_NIGHT is missing, the resolver falls back to SPEEDO_NUMBERS_KMH, then to the base SPEEDO_NUMBERS. 4. Speedometer CalibrationLinear: Standard rotation (e.g., 1 degree per 1 MPH). Non-Linear: For realistic police cruisers, you can define degree-per-unit SpeedMaps in the configuration. This allows the needle to point accurately even if the spacing between your elements on the NUMBERS/LINES are uneven. 5. Technical Design TipsResizing Artifacts: Stick to 512x512. Using larger textures causes the engine to downsample the image, creating a "shimmering" or blurry effect on the dashboard. Color Tinting: Design your NEEDLE, FILL, and LED layers in Grayscale/White. This allows the AGS in-game menu to apply the user's chosen RGB tint to the texture at runtime. Layer Toggling (Flags): Use the flags in the config to disable any layer you aren't using (e.g., if your skin doesn't need a REDLINE layer). This description was brought to you by Gemini because I am too lazy to write descriptions. The code however, was not.