Top level Unreal Engine and plugin (#4977)

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
Co-authored-by: Sergey Dikiy <siarhei.dziki@gmail.com>
Co-authored-by: Sergey Dikiy <steampro97@gmail.com>

Author: 4 people

src/docs/contributing/approach/sdk-docs/write-data-management.mdx

@@ -30,7 +30,7 @@ This file is `/sensitive-data/index.mdx`. It explains how to scrub or filter dat
 
 For data scrubbing that the SDK DOES NOT support, add the name of the SDK to the `PlatformSection notSupported` statement, which ensures the content won't display. For example:
 
-`<PlatformSection notSupported={["flutter", "apple", "perl", "native.breakpad", "native.crashpad", "native.minidumps", "native.wasm", "native.ue4", "go", "ruby", "native", "elixir"]}>`
+`<PlatformSection notSupported={["flutter", "apple", "perl", "native.breakpad", "native.crashpad", "native.minidumps", "native.wasm", "unreal", "go", "ruby", "native", "elixir"]}>`
 
 Add the code sample to these directories:
 

src/docs/contributing/platforms/index.mdx

@@ -110,8 +110,8 @@ If you wanted to make hide the content for a platform by default, but enable it
 
 ```markdown
 ---
-supported:
-  - native.ue4
+supported: 
+  - native.wasm
 notSupported:
   - native
 ---

src/includes/capture-message/unreal.mdx

@@ -0,0 +1,90 @@
+To simplify creating events, there are shorthand functions that construct prepopulated event objects. The most important one is `CaptureMessage`. The `Level` parameter is optional:
+
+```cpp
+USentrySubsystem* SentrySubsystem = ...;
+
+SentrySubsystem->CaptureMessage("Message", ESentryLevel::Info);
+```
+
+There is also the option to configure scope for some specific messages:
+
+```cpp
+USentrySubsystem* SentrySubsystem = ...;
+
+FConfigureScopeDelegate ScopeDelegate;
+ScopeDelegate.BindDynamic(this, &USomeClass::HandleScopeDelegate);
+
+SentrySubsystem->CaptureMessageWithScope("Message", ScopeDelegate, ESentryLevel::Info);
+
+// Put scope configuration logic here
+void USomeClass::HandleScopeDelegate(USentryScope* Scope)
+{
+    Scope->SetTagValue("Module", "Test");
+    ...
+}
+```
+
+The same result can be achieved by calling corresponding functions in blueprint:
+
+![Capture message](unreal_capture_message.png)
+
+
+<Note>
+
+Scoped message capturing is supported only on iOS and Android.
+
+</Note>
+
+## Manual Events
+
+To create and capture a manual event:
+
+1. Create an event, `USentryEvent`. This internally creates an object and initializes it with common event attributes, like `timestamp` and `event_id`.
+2. Set custom attributes of the event, like `Message` or `Level`.
+3. Send the event to Sentry by invoking the `CaptureEvent` method `USentrySubsystem`.
+
+In a simplest case, it looks like this:
+
+```c
+USentrySubsystem* SentrySubsystem = ...;
+
+USentryEvent* Event = NewObject<USentryEvent>();
+Event->SetMessage("Message");
+Event->SetLevel(ESentryLevel::Info);
+
+SentrySubsystem->CaptureEvent(Event);
+```
+
+You can also configure scope for some specific events:
+
+```cpp
+USentrySubsystem* SentrySubsystem = ...;
+
+USentryEvent* Event = NewObject<USentryEvent>();
+Event->SetMessage("Message");
+Event->SetLevel(ESentryLevel::Info);
+
+FConfigureScopeDelegate ScopeDelegate;
+ScopeDelegate.BindDynamic(this, &USomeClass::HandleScopeDelegate);
+
+SentrySubsystem->CaptureEventWithScope(Event, ScopeDelegate, ESentryLevel::Info);
+
+// Put scope configuration logic here
+void USomeClass::HandleScopeDelegate(USentryScope* Scope)
+{
+    Scope->SetTagValue("Module", "Test");
+    ...
+}
+```
+
+The same result can be achieved by calling corresponding functions in blueprint:
+
+![Capture event](unreal_capture_event.png)
+
+<Note>
+
+Scoped events capturing is supported only on iOS and Android platforms.
+
+</Note>
+
+For the full list of supported values, check out [_Event Payloads_](https://develop.sentry.dev/sdk/event-payloads/) and linked documents.

src/includes/capture-message/unreal_capture_event.png

@@ -0,0 +1,12 @@
+```cpp
+USentrySubsystem* SentrySubsystem = ...;
+
+TMap<FString, FString> AdditionalData;
+AdditionalData.Add("SomeKey", "SomeValue");
+
+SentrySubsystem->AddBreadcrumb("Message", "Category", "Type", AdditionalData, ESentryLevel::Info);
+```
+
+The same result can be achieved by calling corresponding function in blueprint:
+
+![Add breadcrumb](ureal_breadcrumb.png)

src/includes/capture-message/unreal_capture_message.png

@@ -0,0 +1,15 @@
+```cpp
+USentrySubsystem* SentrySubsystem = ...;
+
+TMap<FString, FString> ContextData;
+AdditionalData.Add("Class", "Paladin");
+AdditionalData.Add("Role", "Taunt");
+
+SentrySubsystem->SetContext("Character", ContextData);
+```
+
+The same result can be achieved by calling corresponding function in blueprint:
+
+![Set context](unreal_set_context.png)
+
+Alternatively, this configuration cab be provided to the crash reporter [during initialization](/platforms/unreal/setup-crashreport/#configure-attributes).