Xog Editor

Xog Editor is a based on console commands in-game xog editor, avaible in Black Mesa. This editor can configure on the fly most properties of global xog and xog volume with instant results in game; you can also add new ones to see how they look at your level. Initially, it was planned to implement the editor via VGUI, but because VGUI is not easy to work with, Kim made xogscript.cfg, which can be executed once to bind various console commands to keys on the keyboard to make the process much easier.

Usage

Before Xog Editor usage, make a copy of your config.cfg file (for example config_copy.cfg), because Xog Editor rewrites some bindings. With a copy of the file, you will be able to restore all your binds quickly.

To activate Xog Editor, at first, open the console (usually this is ` bind), than enter in the console exec xogscript (it is also recommended to enter sv_cheats 1, this to have full access to the commands). After this, you will be automatically moved in developer 1, with this, some bindings will rewratted, and you'll see the message in the console.

• 

  The message.

So, the Xog Editor editor is now activated and you may already noticed orange box around entity that is under your crosshair.

• 

  The orange box.

This is bounding box, usually uses by game engine to tell when model can be seen by player to draw or not draw it (for performance). You also can see the lines which shows direction of entity, they are always located in origin.

In this case, both things shows you entity that you are targeting, so, technically you can select and edit any entity, but most commands will not produce any results. The only two entities you should interact with is newxog_global and newxog_volume.

To edit your xog entity, move your crosshair at it. You'll note the lines which shows direction of it, you'll see bounding box in case of xog volume as well.

• 

  This is how it looks like with global xog.

• 

  This is how it looks like with xog volume.

Press ↵ Enter to select it (to deselect it, press ↵ Enter again). The bounding box and lines will disappear.

• 

  This is how it looks like with global xog.

• 

  This is how it looks like with xog volume.

Now you can change xog properties. In total you can change 10 different properties. There are 5 buttons in total, one button for every two property, you switch between them by pressing on it.

To select one of the properties you want to change, press one of these buttons: F1 to F5 or 1 to 5 on numpad. See below for what each does. To get full list of binds - press * on numpad.

• 

  This message appear when you select Start Distance property.

After property selection, you can increase or decrease property value. Use mouse wheel up to increase, or + on numpad. Use mouse wheel down to decrease, or - on numpad. The resulting value will be displayed in the console.

Note:There are limits due to scripting limits. Most values don't have the limits, or they are much larger than can be set using this editor.

• 

  This message appear when you change End Distance value.

Once you have decided on the values, manually write them in Hammer. If you have lost some value, you can get full information about selected light source, press , or / on numpad.

• 

  Example with the xog volume.

To delete xog, press Delete, or . on numpad.

To disable Xog Editor, enter in the console exec xogscript.

Keypad List

This is full list of bind/commands.

• F1 or 1 on numpad - Start Distance / End Distance.
• F2 or 2 on numpad - Height Color Start / Height Color End.
• F3 or 3 on numpad - Height Z Start / Height Z End.
• F4 or 4 on numpad - Noise Contrast / Noise Multiplier.
• F5 or 5 on numpad - Opacity Offset Bottom / Opacity Offset Top.

• ↵ Enter - select/deselect xog.
• Mause Wheel Up or + on numpad - increase value of selected property.
• Mause Wheel Down or - on numpad - decrease value of selected property.
• , or / on numpad - shows all values of selected xog.
• * on numpad - shows all keypad binds.
• Delete or . on numpad - removes any entity your crosshair is pointed at.

Unused Commands

Some commands are unsed. You still can use them via console when your xog is selected.

• xe_sky_col - sets xog sky color value (RGB).
• xe_sky_col_blend_factor - sets xog sky blend factor (float).
• xe_col_grad_type - sets xog color mode (0, 1 or 2).
• xe_col_grad_tex_name - sets grad texture (string).
• xe_col_top - sets top color value (RGB).
• xe_col_bottom - sets bottom color value (RGB).
• xe_noise1_speed - sets noise 1 speed (X, Y, Z).
• xe_noise2_speed - sets noise 2 speed (X, Y, Z).
• xe_noise1_tiling - sets noise 1 tiling (X, Y, Z).
• xe_noise2_tiling - sets noise 2 tiling (X, Y, Z).

See also

• New Lights Editor - similar editor, but for new lights.
• newxog_global - global xog entity.
• newxog_volume - xog volume entity.
• newxog_settings - entity that changes properties for xog.