search

AgitoReiKen / ue-restyle

Restyle is a plugin for Unreal Engine v5.0, v5.1 that brings a brand new look for graph editors
14 stars 1 forks source link

readme

Product is "removed" from Marketplace due to inability to receive users's payments. All purchases are on Epic's account, so feel free to ask for refund

Apply here

Restyle is a plugin for Unreal Engine v5.0, v5.1 that brings a brand new look for graph editors.

Restyle replaces graph editor's widgets with customizable versions while also leaving overall engine look unchanged.

Table of Contents:

= Gallery

image host

Come to Image Gallery to see Restyle in action

= Installation

  1. Goto your unreal engine's project directory (should contain .uproject file in there)

  2. Run one of the following commands:

    • For UE v5.0 
      git clone --single-branch --branch v5_0 https://github.com/agitoreiken/ue-restyle ./Plugins/Restyle
    • For UE v5.1 
      git clone --single-branch --branch v5_1 https://github.com/agitoreiken/ue-restyle ./Plugins/Restyle

      It will install the plugin into project's Plugin directory.

  3. Regenerate & Recompile project and you've got it installed

  4. In editor, open Edit -> Editor Preferences

  5. Scroll down to Plugins section

  6. Find and open Restyle, set factories to Default

= Motivation

I did really want to see new design for blueprints in ue-5, but that didn't happen.

So i've searched through the marketplace, found some projects:

At the end of the day i decided to take the reponsibility and bring the thing i wanted to see

Spoiler It took a 6 unprofittable months lmao

= Features

Plugin is made of 3 factory providers which represents factories inside of FEdGraphUtilities, which are used by engine to spawn Nodes, Pins, Connections.

General

Nodes

Variable Nodes

Compact Nodes

Reroute

Comments

Comment Bubbles (Its not bubble)

Node Reports (error/warning etc.) and State (development/disabled)

Pin Connections

Pins

Recommendations (likely to change)

Windows OC, because MinHook library (i get used to) doesn't support other systems. It's used to redesign CreateWidget node. Thats probably all atm. You can run it anyway on any other system, just this widget will be with unreal style.

= Difficulties

Technical Side

To apply on "design" behavior of SGraphNode/SGraphPin classes, the new ones needed to be created.

Because some of them are not exported for external use, it becomes impossible to mantain the inheritance;

In simple words. All SGraphNodes are still SGraphNodes, but all SGraphNodeK2 are now SDefaultGraphNodeK2, and all logic inside of SGraphNodeK2 was copy-pasted to Restyle's classes.

For each logical update on widgets made in newer versions of Unreal, the plugin must be updated in order to match them

User Experience

Do not try to change settings while working with graphs. Close them, make a change and only then open. Otherwise, editor will crash (due to style changes)

Having opened "Editor Settings" window with restyle loaded may cause editor to slow down. (For some reason slate processess non-visible options)

= FAQ

Could it break my data?

If you are not trying to force old plugin version works on new unreal version then no. In the worst case of the plugin malfunction you will not see some widget element or it's style is still an old one :)

But if you really curious about your data safety, use external backup system (not git), because this engine is pretty volatile thing itself.

I have my own factories defined, will it work?

Plugin registers factories at Index 0 and they check if there is any other factory wants to spawn that UClass. So yes it will work, but styles will mismatch (ways of fixing this part are not discussed nor done yet)