Heads up display (HUD)
(this topic was ported quickly from old documentation and needs updated)
You can customize your Head Up Display either by typing customization commands into the console, loading existing HUD configs, or, in the most straight-forward way, by using the in-built HUD Editor.
To load the HUD Editor, simply type hud_editor into the console. A screen describing what keys represent what edit actions will appear and by simple drag&drop system you can move the HUD elements on your screen, resize and align them.
You can also load some existing HUD setups. Type one of the following lines into the console to load example HUD configurations:
ezQuake allows you to modify your HUD as you wish, you can choose which HUD elements to draw, where to draw them, how to draw them and how large to draw them.
You can either use your keyboard to move, hide and show, align, group, scale and change style of HUD elements on your screen or you can learn using commands to customize the HUD.
Customizing HUD with keyboard
A list of instructions now appears on screen / in console. You should notice that you can select hud elements using your [ and ] keys, move them using arrow keys, and perform other actions using keys on the numpad, page up, page down, home, end, insert, delete, space, enter, z, x, c, v, combine some keys with shift, and finally save your work by pressing U key.
You get your config saved into the
./ezquake/configs directory. Its full name will be printed on the screen.
Customizing HUD with commands
Some specific HUD elements have specific properties which you cannot change using the way described above and you might also want to know all the potential this client offers you in HUD scripting. Here you will learn how to customize the HUD using commands you type into console or configuration files.
To enable new HUD, you have to type
/scr_newhud 1 - which disables FuhQuake-originated HUD. If you’re missing some features of FuhQuake HUD, you can combine those two HUDs using
This flexibility comes at a price though, it usually takes a while to understand how to work with the HUD system, but once you’ve managed that, it will be great fun to design your very own Quake HUD.
Check the examples throughout this document, if you have any problems with understanding the HUD system.
What is a HUD element?
A HUD element is a single 2D element, that can be drawn on-screen, moved to different positions, aligned etc. For most HUD elements it’s also possible to display a frame in the background behind them.
Every HUD element has a name which is a string, like “netgraph”, “fps” etc.. You use that name in HUD commands, like “show netgraph”. The HUD element used remembers all its settings (its properties) as variables, which are named hud_
- This will display the current setting for the netgraph frame
- This will determine how often the ping display will be updated.
Changing a property of an element is simple. Obviously, a simple way to do this is changing the appropriate variable, however there is a more convenient way: try typing the element name at console, like this: netgraph [ENTER]
You will see some infos about netgraph and a list of its properties with its current values. If you want to change some - it’s easy:
/netgraph frame 0
- This will disable the background graphic drawn behind the netgraph.
/netgraph show 0
- This will disable that the netgraph is displayed (same as hide “netgraph”).
It’s possible to use TAB completion for HUD properties, so if you type “netgraph inf” and press [TAB], it should complete. All variables for HUD elements (hud__) are hidden.
Some properties (like “show”) are controlled by commands (like “show” and “hide”). Some of them (those for setting element position) will not have a effect if you change them directly by variables. If you do so and you see no change, try the “hud_recalculate” command.
Showing and hiding
To show a certain HUD element, use the “show” command with the element name as a parameter. Giving no parameters will display a list of all HUD elements with their current status. There is a special parameter “all” which you can use to show all elements.
- This will display the netgraph.
- This will display your current FPS.
- This will print a list of all HUD elements on the console as well as their current settings.
- This will display all hud elements.
The opposite to “show” is the command “hide”, which obviously hides the specified HUD element. The current status is remembered as a “show” property, so typing “show netgraph” will have the same effect as typing “netgraph show 1”.
Moving HUD elements
When you want to move a certain HUD element, first you have to decide what screen area it occupies, the command used for placing a HUD element is: “place
- visible part of the screen
- view area (depends on viewsize variable)
- area above status bar
- status bar area (health bar + inventory bar, no free space after sbar, if you play at higher res)
- inventory bar (upper part of sbar)
- health bar (lower part of sbar)
- free area after status bar (if res > 320 or hud_sbar_size changed)
- free area after inventory bar
- free area after health bar
/place netgraph screen
- place the netgraph on the screen
/place fps top
- place the fps in the area above the status bar
/place health hfree
- place te health in the free area next to the health bar
If you have a place for your favorite element, align it to some edges. The command is “align
- left edge of area chosen by “place”
- right area before explained later in this document after explained later in this document
- top edge
- below console (like clock by default)
- explained later in this document
- explained later in this document
/align netgraph left top
- left upper corner
/align fps right bottom
- right lower corner
Finally, if the element position still does not match your preferences, you can fine-tune it by using the command “move
/move netgraph 2 2
- move the netgraph 2 pixels right and 2 pixels down
/move fps -10 5
- move the FPS 10 pixels left and 5 pixels down
Note that your element will not be drawn, if you locate it off the screen, even partially.
All those commands (“place”, “align”, “move”) can be used without parameters, (print help then) or with on parameter - HUD element name. Then current values are printed.
You can align some elements relative to other elements. First you have to decide, if the element that you are locating now (element B) is to be positioned inside another element (element A) or outside it.
If inside do
/place A @B
If outside do
/place A B
/place fps @net
/place health face
/place iammo health
/place ammo iammo
Then you have to align it. If you want to place it outside, you have some additional alignments - before and after.
/place health after top
/place iammo after top
/place ammo after top
and you have a nice chain combined of health, armor and its icons.
The difference between inside and outside placing can easily be seen if you add a frame to your elements and enlarge them (for example by using frame 2).
Frame is a regular property, it differs a little because every HUD element can have a frame. Values for frame property are: 0 no frame (0..1) transparent frame, lower number means more transparency 1 black frame 2 a box like that for netgraph
/net frame 2
- add nice frame for network statistics
/netgraph frame 0
- make netgraph more useful
/fps frame 0.6
- make FPS more readable
Every element has its own properties. You can check them, by simply typing the element name in console. Some common properties are described below, which affect your inventory elements (guns, health etc):
- used for numbers (health, armor etc..) and determines how they should be aligned
- used for numbers and specify how many digits they should display, for example to save space, you can have your ammo printed only with two digits, it will always show 99 if is more than 100
- You can set the opacity of background of current element where 0 equals transparent background and 1 is solid background.
- This is mostly for GL users and currently it doesn’t work in the software renderer. This lets you change the size of an element, for example you can make health 2 times bigger. With scale you can make a HUD that looks like in 320x200 (big numbers) and still have -width 640 without conwidth, so your console holds more text.
- This always changes the look of the element, styles are different, depending on the element type. Usually there is one style which, when enabled, enables text-mode look of element (like gun6 is “gl”, health level with small text etc.). Style values are cardinal numbers (0, 1, …).
- only used with “gun” and “gun8” and affects style of lightning gun icon
Grouping elements have only two properties (width and height), they should be self-explanatory.
Here are some variables, which will be useful when changing the design of your HUD:
- 0 = display all items normally (default)
- 1 = draw all items as if you have them; this for planning your HUD, for example you can move the quad icon to the desired position, because you see this icon even if you don’t have quad at the moment; you should rather not play or do “/cfg_save” with that
- 0 = do not apply teamplay need settings to status bar drawings
- 1 = this will apply teamplay need settings to your status drawings, like your health will be red if below
/tp_need_health, not if below 25, armor will depend on
/tp_need_ra, not always red if below 10 etc