mirror of
https://github.com/Ed94/Cog.git
synced 2026-06-13 08:02:23 -07:00
Arnaud Jamin
187 lines
8.1 KiB
Markdown
187 lines
8.1 KiB
Markdown
# Cog
|
|
Cog is a set of debug tools for Unreal Engine built on top of [ImGui](https://github.com/ocornut/imgui)
|
|
|
|
|
|
|
|
## Project Structure
|
|
|
|
- `CogSample` - A Sample that demonstrate various Cog functionalities. The project was saved in Unreal 5.1
|
|
- `Plugins/CogAbility` - ImGui windows for the Gameplay Ability System (Abilities, Effects, Tags, ...)
|
|
- `Plugins/CogInput` - ImGui windows for the Enhanced Input library (Input action, Gamepad)
|
|
- `Plugins/CogEngine` - ImGui windows for the core unreal engine functionalities (Log, Stats, Time, Collisions, Skeleton, ...)
|
|
- `Plugins/CogWindow` - ImGui window management (Base Window, Layout)
|
|
- `Plugins/CogDebug` - Debug functionalities (Log, Debug Draw, Plot, Metric, ...)
|
|
- `Plugins/CogImGui` - Integration of Imgui for Unreal, inspired by [UnrealImGui](https://github.com/segross/UnrealImGui)
|
|
- `Plugins/CogInterface` - Interfaces implemented by actors to inspect them
|
|
|
|
## ImGui Windows
|
|
|
|
### General Notes
|
|
- Press the [Insert] key or use the 'Cog.ToggleInput' console command to open the Imgui Main Menu.
|
|
- Most windows display their contents based on a selected actor.
|
|
- The selector actor can be chosen using the selection window or widget.
|
|
- Mouse over a window title to display its help. This behavior can be disabled in the Window menu.
|
|
- Window Layouts can be saved/loaded.
|
|
- Windows save their own settings in a Cog.ini file to maintain their state between multiple sessions.
|
|
|
|
### Abilities
|
|
|
|
Displays the gameplay abilities of the selected actor.
|
|
|
|
[]()
|
|
- Click the ability checkbox to force its activation or deactivation.
|
|
- Right click an ability to remove it, or open/close the ability separate window.
|
|
- Use the 'Give Ability' menu to manually give an ability from a list defined in a Data Asset.
|
|
|
|
### Actions
|
|
Displays the state of Input Action.
|
|
|
|
|
|
- Can be used to inject inputs to help debugging.
|
|
- The display input action are read from a Input Mapping Context defined in a Data Asset.
|
|
|
|
### Attributes
|
|
Displays the gameplay attributes of the selected actor
|
|
|
|
|
|
- Attributes can be sorted by name, category or attribute set.
|
|
- Attributes with the Current value greater than the Base value are displayed in green.
|
|
- Attributes with the Current value lower than the Base value are displayed in red.
|
|
- Use the options 'Show Only Modified' to only show the attributes that have modifiers.
|
|
|
|
### Cheats
|
|
Used to apply cheats to the selected actor.
|
|
|
|
|
|
- The cheats are gameplay effects configured in a data asset.
|
|
- Key modifiers can be used to change which actor should be affected by the cheat:
|
|
- [CTRL] apply the cheat to the controlled actor
|
|
- [ALT] apply the cheat to the allies of the selected actor
|
|
- [SHIFT] apply the cheat to the enemies of the selected actor
|
|
|
|
### Collisions
|
|
Used to inspect collisions by performing a collision query with the selected channels.
|
|
|
|
|
|
- The query can be configured in the options.
|
|
- The displayed collision channels can be configured in a Data Asset.
|
|
|
|
### Debug Settings
|
|
Used to tweak how the debug display is drawn.
|
|
|
|
|
|
|
|
### Effects
|
|
Displays the gameplay effects of the selected actor.
|
|
|
|
|
|
- Mouse over an effect to see its details such as its modifiers, the gameplay tags it grants, the remaining time.
|
|
|
|
### Gamepad
|
|
Display the state of the gamepad
|
|
|
|
|
|
- Can be used to inject inputs to help debugging.
|
|
|
|
### Log Categories
|
|
This window can be used to activate and deactivate log categories
|
|
|
|
|
|
- Activating a log category set its verbosity to VeryVerbose.
|
|
- Deactivating a log category set its verbosity to Warning.
|
|
- The detailed verbosity of each log category can shown by using the Option menu.
|
|
- A client can modify the verbosity of the server.
|
|
- The log categories are used to display both output log and debug display in the world.
|
|
|
|
### Metric
|
|
This window gather values generated by the selected actor to compute how much output it produces or receives per second. This is typically useful to compute the damage dealt per second, the damage received per second, etc.
|
|
|
|
|
|
|
|
### Net Emulation
|
|
This window is used to configure the network emulation
|
|
|
|
|
|
|
|
### Output Log
|
|
Display the output log based on each log categories verbosity.
|
|
|
|
|
|
- The verbosity of each log category can be configured in the 'Log Categories' window.
|
|
|
|
### Pools
|
|
Displays attributes of the selected actor as pools.
|
|
|
|
|
|
- The pools can be configured in a data asset.
|
|
|
|
### Plots
|
|
Plots values overtime. When applicable, only the values of the selected actor are displayed.
|
|
|
|
|
|
|
|
### Scalability
|
|
Used to configure the rendering quality.
|
|
|
|
|
|
|
|
### Skeleton
|
|
This window display the bone hierarchy and the skeleton debug draw of the selected actor if it has a Skeletal Mesh.
|
|
|
|
|
|
- Mouse over a bone to highlight it.
|
|
- Right click a bone to access more debug display.
|
|
- Use the [Ctrl] key to toggle the bone debug draw recursively.
|
|
|
|
### Selection
|
|
This window can be used to select an actor either by picking an actor in the world or by selecting an actor in the actor list.
|
|
|
|
|
|
- The actor list can be filtered by actor type (Actor, Character, etc).
|
|
- The current selection is used by various debug windows to filter out their content.
|
|
|
|
### Spawn
|
|
Used to spawn new actors in the world. The spawn list can be configured in a Data Asset.
|
|
|
|
|
|
|
|
### Stats
|
|
Displays engine stats such as FPS, Ping, Packet Loss.
|
|
|
|
|
|
|
|
### Tags
|
|
Displays gameplay tags of the selected actor.
|
|
|
|
|
|
|
|
### Time Scale
|
|
Used to change the game global time scale.
|
|
|
|
|
|
- If changed on a client the time scale is also modified on the game server.
|
|
|
|
### Tweaks
|
|
Used to apply tweaks to all the spawned actors
|
|
|
|
|
|
- The tweaks are used to test various gameplay settings by actor category
|
|
- The tweaks can be configured in a data asset.
|
|
|
|
## Debug Functionalities
|
|
|
|
Cog provides C++ and Blueprint functions to log and debug draw within Log Categories.
|
|
|
|
|
|
|
|
Log and debug functions can be filtered to only what is outputted by the selected actor.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|