Blacklight: Retribution

Blacklight: Retribution

32 ratings
BLR HUD Tweaker
By Duvel
The HUD Tweaker is a piece of software that let you modify any possible BlackLight:Retribution HUD element using a graphical interface.
   
Award
Favorite
Favorited
Unfavorite
How does it works ?
Your game directory contains a folder "Cooked" where are stored different config files that are fully modifiable by the players, with the benediction of Zombie Studios (from here you can stop thinking "Is this allowed?")
One of those config files is the FoxHud.ini, which contains all HUD elements that can be tweaked. But since this file is pure text, it's a real pain to modify values lying in it... the HUD Tweaker solves this problem by giving you an intuitive graphical interface to make your modifications, and save them in the FoxHud.ini format.

What is a Widget ?
Better to demystify this right now as that will increase your understanding of the software and what's next.

A Widget is a rectangle HUD element that can be moved and repositioned and is used to display specific information.

For instance the HealthWidget is:





A widget has several modifiable properties amongst:
  • X - Horizontal position : Distance between the center of the screen and the widget's anchor point represented by a red circle.
  • Y - Vertical position : Distance between the center of the screen and the widget's anchor point represented by a red circle.
  • Xrot - Horizontal rotation : Rotates your widget horizontally around its anchor point represented by a red circle.
  • Yrot - Vertical rotation : Rotates your widget vertically around its anchor point represented by a red circle..
  • DispTime : Time before the widget fades out. Widgets having a default DispTime=0 ignore this property.
  • Opacity : Defines the widget's Transparency (Percentage). Widgets having a default Opacity=0 ignore this property.
  • Scale : Defines the widget's Scale. Widgets having a default Scale=0 ignore this property.
  • Z : Only used on stuff named with "WorldLocationOffset". The WorldLocationOffset applies to an Object in the world instead of a HUD Widget. On those objects, X represent North-South axis, Y West-East axis, and Z the Top-Bottom axis"
Important Note:
Not all the widgets have all available properties exposed.

If a widget has not a property exposed, specifying a value for this property will have no effect in game.
Also there might be a max/min value for some properties on some Widgets.
All hidden info we don't know about.
Installation & first run
Download the latest build in the official forums[blacklight-forum.perfectworld.com]

Extract the zip contain anywhere on your HDD
Start the exe

At first start it will detect that your game directory is unknown and give you a notification, press OK.
Go in menu "Application" then "Locate Game" and browse to your \Blacklight Retribution\Live directory. Pay attention, you should select the "Live" dir!

If your game path looks correct it will notify you, after that you can go in menu "FoxHUD.ini" and select "Load". This will load your default config file. If you can see the widgets and colors, than it's OK

Note 1 : For Steam users, your game folder is in :
STEAM FOLDER\steamapps\common\blacklightretribution\Blac klight Retribution\Live


Note 2 : It will remember your game dir path and the next time you will start the app, it will automatically load the default config file.
Tweak your HUD
One you have a config file loaded, you can do the following using the sofware's Tabs.

1. Move the widgets and modify their properties in the first tab





There are 3 ways to move the widgets:
  • Drag & Drop them with your mouse
  • Move them with your keyboard's arrow keys for better accuracy
  • Manually change their X or Y values in the corresponding boxes



2. Change the colors in the second tab :




Note that to change a color, you can either use the ColorPicker Dialog by clicking on the button right to the color, or manually enter a color in Hexadecimal format



3. Change the advanced parameters in the third tab.











4. Save your config
Once you are done with your modifications, go in menu FoxHUD.ini and select Save, this will make a backup of your current config file and then overwrite the file with your modifications
You can start the game and see the result.
Tweak your FOV
Additionally to the FoxHud.ini, the HUD Tweaker also let you change an interesting property in the FoxEngine.ini config file : The Field of View.

This is a must have for all players having a Large screen, which is probably the majority of us.

You'll find more information about this in this thread[blacklight-forum.perfectworld.com] of the official forums.

To change your FOV, go in menu FoxEngine.ini and select Change FOV

You'll see the following window:















Note that Horizontal (XFOV), is the default value, more adapted to old screens having a 4:3 ratio.
Share your config
If you come to that ubber config of your dreams and find it perfect for you, chances are high that some other players will like it too...
so why wouldn't you share it with your fellow buddies and become the hero that made the perfect HUD ?

The software let you share your config on the forum in a matter of second thanks to a built-in assistant that automatically format your config file for a forum post. All you have to do is copy it and post it.






If you do so, it's probably better that you also add a screenshot of your interface.
Import a config
As you can share your config with others, of course you can also import other's configs as simply.












Just copy to your clipboard the config code that a generous player let on the forum, paste it into the HUD Tweaker and Load it.

Once it's loaded you can Save it like it is, or make your own modifications out of it, and why not Share the results with others afterwards.
The FoxHud.ini menu in details














Save : Backup the default config file then overwrite it with your modifications

Save As : Save your modifications to a ini file of your choice (no backup is done)

Load : Load THE FoxHud.ini config file

Load Zombie's default : Load the default config file backuped by Zombie after each patch as FoxHud.Bak

Load Specific File : Load the config file of your choice

Load From Clipboard : Load a config file found on the forum by copy/pasting it.

Share your config : Assistant to share your config in the forum

Open Config Directory : Opens an explorer on the folder where your config files lies.
Last thoughts
Believe it or not, I haven't make this for myself, I did it for you all. I don't even use it except to change a few colors (but I am looking forward to copy the best configs that will pop up on the forums :D ) ...

I'd like to thanks again Brian Sprague for the countless support he provided in the development thread[blacklight-forum.perfectworld.com], without him this tool would not have been possible !

If you need some support, it's better to ask on the Official forum thread[blacklight-forum.perfectworld.com], as I am more active on the official forums than on Steam.

On a final note, If you want to offer me a beer or a new camo, you have a "Donate" link in "Application" menu :-)
15 Comments
BrotherDJ 16 Aug, 2020 @ 6:29am 
yes now i can tweak game that says servers are closed
Derek Icelord 16 Aug, 2015 @ 2:37am 
Perfect World migrated their forums, hence all the URLs are broken. The tool no longer works post Parity Patch. The HUD can still be tweaked by editing the FoxHud.ini file. Check the BLR forums for guides.
Jerakl 11 Aug, 2015 @ 11:19pm 
Hey man, the link is broken as SweetJP said.
You got it hosted anywhere else?
Victor Hendricks 24 Jul, 2015 @ 10:45am 
the link provided is useless,as it just takes me to the forum,not the actual download
AFrozenKitten 11 Jun, 2015 @ 12:20pm 
Why did chrome block the installation of this saying it was malicious?
šmizla 24 Aug, 2013 @ 3:00am 
Jealous. :)
Duvel  [author] 23 Aug, 2013 @ 3:56pm 
I've see him live twice :P
šmizla 23 Aug, 2013 @ 3:37pm 
I'm always glad when people recognize that. :D
Also, fast reply. :P
Duvel  [author] 23 Aug, 2013 @ 3:09pm 
Thank you Aphex ;-)
šmizla 3 May, 2013 @ 4:35am 
This is awesome. Coming from TF2, I'm used to tweaking my HUD as I see fit. I'll definitely look into this.