Reconnect Popup Widget

You can create your network reconnect UI using two methods: inheriting from the pre-built Parent Class, or building a custom UserWidget manually.

Option A: Inheriting from DztfixNetworkReconnectWidget

The plugin provides a pre-built Parent Class called DztfixNetworkReconnectWidget. When you create a Widget Blueprint and set its Parent Class to this, it automatically handles UI construction and subsystem events behind the scenes.

How to Create It

  1. Right-click in the Content Browser and select User Interface > Widget Blueprint.
  2. In the "All Classes" search box, search for DztfixNetworkReconnectWidget.
  3. Select it as the Parent Class and create your widget.

Automated UI Layout

When this widget starts, it automatically builds the following layout for you:

  • A Vertical Box serving as the root layout.
  • A TextBlock component showing the current offline status or retry status message.
  • A Button component with a "Retry" text label inside it. Clicking the button automatically runs a manual connection check.

Available Blueprint Functions

Because your widget inherits from this class, you can call these functions directly inside its Blueprint Graph:

  • Show Network Message: Shows the widget (sets visibility to Visible) and triggers custom UI animations.
  • Hide Network Message: Hides the widget (sets visibility to Collapsed).
  • Retry Connection Check: Manually calls the internet checking system to verify connectivity.
  • Set Network Message Text: Dynamically changes the message label text shown to the player.

Overrideable Blueprint Events

Right-click in the Blueprint Graph of your widget and search for these events to add custom UI transitions or audio effects:

  • On Reconnect Requested: Fires when the player clicks Retry and the subsystem starts a ping check.
  • On Network Message Shown: Fires when the popup becomes visible. Use this to trigger slide-in or fade-in animations.
  • On Network Message Hidden: Fires when the connection returns and the popup is hidden. Use this to play a success banner animation.

Option B: Custom Manual Setup (UserWidget)

If you prefer to design the layout completely from scratch in the UMG Designer, inherit from the standard UserWidget and implement the graph below.

UMG Designer Setup

Widget Blueprint: WBP_NetworkPopup Parent Class: UserWidget Canvas Panel -> Border or Overlay -> Vertical Box -> Text Block: TXT_Message -> Button: BTN_Retry -> Text Block: "Retry"

Event Construct Graph

Event Construct
Initial state layout
Set Visibility Self = Collapsed
Hide on start
Get Dztfix Network Check
Get referenceSubsystem Ref
Bind Event to On Network Lost
Show popup when offline
Bind Event to On Network Available
Hide popup when online

Retry Button Graph

OnClicked BTN_Retry
Click trigger
Set Text (TXT_Message) = "Checking..."
Update status label
Check Internet Connection
Trigger connection check