# extDebug - Debug Tools for Unity Created by [iam1337](https://github.com/iam1337) and [hww](https://github.com/hww) [![openupm](https://camo.githubusercontent.com/ad50bd5fab6ed43a9b136cc659acd265d0e30fb6a27a706823010e76268d15ab/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f636f6d2e69616d313333372e65787464656275673f6c6162656c3d6f70656e75706d2672656769737472795f7572693d68747470733a2f2f7061636b6167652e6f70656e75706d2e636f6d)](https://openupm.com/packages/com.iam1337.extdebug/) [![semantic-release: angular](https://camo.githubusercontent.com/b6a92c3a7964f89a4239acf06e58206b927884803eece79cf1392a6a4dc52096/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73656d616e7469632d2d72656c656173652d616e67756c61722d6531303037393f6c6f676f3d73656d616e7469632d72656c65617365)](https://github.com/semantic-release/semantic-release) ### Table of Contents - [Introduction](https://github.com/Iam1337/extDebug/raw/main/#introduction) - [Installation](https://github.com/Iam1337/extDebug/raw/main/#installation) - [extDebug.Menu](https://github.com/Iam1337/extDebug/raw/main/#extdebugmenu---debug-menu) - [extDebug.Notifications](https://github.com/Iam1337/extDebug/raw/main/#extdebugnotifications---debug-notifications) - [Extensions](https://github.com/Iam1337/extDebug/raw/main/#extensions) - [Author Contacts](https://github.com/Iam1337/extDebug/raw/main/#author-contacts) ## Introduction extDebug are tools for easy development and testing of games on Unity. Supported platforms are PC, Mac and Linux / iOS / tvOS / Android / Universal Windows Platform (UWP) and other. ### Features: - **Debug Menu**
Allows you to add a debug menu in game, with many different functions. - **Debug Notifications**
Allows you to show a debug notification in game. - **Analytics Heatmaps** (Work in progress)
TODO: Description **And also:** - TODO **And much more** ## Installation **Old school** Just copy the [Assets/extDebug](https://github.com/Iam1337/extDebug/raw/main/Assets/extDebug) folder into your Assets directory within your Unity project, or [download latest extDebug.unitypackage](https://github.com/iam1337/extDebug/releases). **OpenUPM** Via [openupm-cli](https://github.com/openupm/openupm-cli):
``` openupm add com.iam1337.extdebug ``` Or if you don't have it, add the scoped registry to manifest.json with the desired dependency semantic version: ``` "scopedRegistries": [ { "name": "package.openupm.com", "url": "https://package.openupm.com", "scopes": [ "com.iam1337.extdebug", ] } ], "dependencies": { "com.iam1337.extdebug": "1.15.0" } ``` **Package Manager** Project supports Unity Package Manager. To install the project as a Git package do the following: 1. In Unity, open **Window > Package Manager**. 2. Press the **+** button, choose **"Add package from git URL..."** 3. Enter "https://github.com/iam1337/extDebug.git#upm" and press Add. ## extDebug.Menu - Debug Menu It is easy to use, lightweight library initially forked from [hww/varp_debug_menu](https://github.com/hww/varp_debug_menu) but deeply modifyed. The library allows you to add a debug menu in game, with many different functions. ### Features: - Changing values: numeric values, booleans, strings, enums, flags and other - Store and restore default values - Invoke actions - Dynamic generation ### Examples: ![extDebug Menu Root](https://github.com/Iam1337/extDebug/raw/main/Documentation/Images/extDebug-Menu-Root.png) ![extDebug Menu Sub](https://github.com/Iam1337/extDebug/raw/main/Documentation/Images/extDebug-Menu-Sub.png) **Values**
```C# string _string; byte _uint8; UInt16 _uint16; // ushort UInt32 _uint32; // uint UInt64 _uint64; // ulong sbyte _int8; Int16 _int16; // short Int32 _int32; // int Int64 _int64; // long float _float; bool _bool; Vector2 _vector2; Vector3 _vector3; Vector4 _vector4; Quaternion _quaternion; Color _color; Vector2Int _vector2Int; Vector3Int _vector3Int; DM.Add("Values/String", () => _string); DM.Add("Values/UInt8", () => _uint8, v => _uint8 = v); DM.Add("Values/UInt16", () => _uint16, v => _uint16 = v); DM.Add("Values/UInt32", () => _uint32, v => _uint32 = v); DM.Add("Values/UInt64", () => _uint64, v => _uint64 = v); DM.Add("Values/Int8", () => _int8, v => _int8 = v); DM.Add("Values/Int16", () => _int16, v => _int16 = v); DM.Add("Values/Int32", () => _int32, v => _int32 = v); DM.Add("Values/Int64", () => _int64, v => _int64 = v); DM.Add("Values/Float", () => _float, v => _float = v); DM.Add("Values/Bool", () => _bool, v => _bool = v); DM.Add("Values/Vector 2", () => _vector2, v => _vector2 = v, order: 14).SetPrecision(2); DM.Add("Values/Vector 3", () => _vector3, v => _vector3 = v, order: 15).SetPrecision(2); DM.Add("Values/Vector 4", () => _vector4, v => _vector4 = v, order: 16).SetPrecision(2); DM.Add("Values/Quaternion", () => _quaternion, v => _quaternion = v, order: 17).SetPrecision(2); DM.Add("Values/Color", () => _color, v => _color = v, order: 18).SetPrecision(2); DM.Add("Values/Vector 2 Int", () => _vector2Int, v => _vector2Int = v, order: 19); DM.Add("Values/Vector 3 Int", () => _vector3Int, v => _vector3Int = v, order: 20); ``` **Enums and Flags**
```C# enum ExampleEnums { One, Two, Three } ExampleEnums _enum; [Flags] enum ExampleFlags { One = 1 << 0, Two = 1 << 1, Three = 1 << 2, } ExampleFlags _flags; DM.Add("Values/Enum", () => _enum, v => _enum = v); DM.Add("Values/Flags", () => _flags, v => _flags = v); ``` **Actions**
```C# DM.Add("Debug/Action", action => Debug.Log("Hello World")); DM.Add("Debug/Action 2", action => Debug.Log("Hello World"), "Action description"); // Action with description ``` **Branches**
```C# DM.Add("Example/Branch 1"); DM.Add("Example/Branch 2", "Branch description"); // Another way to add menu item in specific branch var branch = DM.Add("Example/Branch 3"); DM.Add(branch, "Action", action => Debug.Log("Hello World")); ``` **Variants**
```C# string _string = "Variant 2"; string[] _stringVariants = new string[] { "Variant 1", "Variant 2", "Variant 3" }; // You can pre-define lists of values and select the ones you need from them. DM.Add("Simple Menus/String Variants", () => _string, v => _string = v, _stringVariants, order: 1); ``` ### Keyboard Shortcuts: **Shared** - `Q` - Show or hide menu without closing it **When the menu is open:** - `W`, `S` - Moving through the menu - `A`, `D` - Change value, invoke action, open/close branch - `R` - Reset value to default - `E` - Close current branch branch **When the menu is closed:** - `Shift+A`, `Shift+D` - Change value, invoke action if menu is closed - `Shift+R` - Reset value to default even if menu is closed To change the default keyboard shortcuts, you need to create a class inherited from the [IDMInput](https://github.com/Iam1337/extDebug/raw/main/Assets/extDebug/Scripts/Menu/IDMInput.cs) interface, and set its instance to `DM.Input`. ### Rendering To change the default IMGUI render, you need to create a class inherited from the [IDMRender](https://github.com/Iam1337/extDebug/raw/main/Assets/extDebug/Scripts/Menu/IDMRender.cs) interface, and set its instance to `DM.Render`. ## extDebug.Notifications - Debug Notifications It is easy to use, in-game notification system. Based on [Garry's Mod notification](https://github.com/Facepunch/garrysmod/raw/master/garrysmod/lua/includes/modules/notification.lua) system. ### Examples: **Simple notification**
```C# // Show notification for five seconds DN.Notify("Simple notification", 5f); ``` **Context notification**
Calling a method with the same context allows you to declare infinite notifications. Also, the last call to the method with the new parameters and the same context will overwrite the parameters of the previous notification. ```C# // Create simple context object _context = new object(); // Show infinity notification DN.Notify(_context, "Infinity notification", -1f); // Hide infinity notification DN.Kill(_context); ``` ### Rendering To change the default IMGUI render, you need to create a class inherited from the [IDNRender](https://github.com/Iam1337/extDebug/raw/main/Assets/extDebug/Scripts/Notifications/IDNRender.cs) interface, and set its instance to `DN.Render`. ## Extensions List of useful repositories to help make extDebug easier to use: - [extDebug.UGUI](https://github.com/Iam1337/extDebug.UGUI) - Extension to support Unity UI and TextMeshPro in extDebug ## Author Contacts \> [telegram.me/iam1337](http://telegram.me/iam1337)
\> [ext@iron-wall.org](https://github.com/Iam1337/extDebug/raw/main/mailto:ext@iron-wall.org) ## License This project is under the MIT License.