Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/scottkirvan/scooterutils

Scooter Utilities is an Unreal Engine editor plugin that bundles essential quality-of-life tools for artists and developers. Quickly navigate to disk files, restart/reload your projects with a single click, and keep important settings persistent between editor sessions.
https://github.com/scottkirvan/scooterutils

cpp editor-plugins plugin scooter-utilities ue4 ue4-plugin ue5 unreal unreal-engine unreal-engine-4 unreal-engine-5 unreal-engine-plugin unreal-utilities

Last synced: 25 days ago
JSON representation

Scooter Utilities is an Unreal Engine editor plugin that bundles essential quality-of-life tools for artists and developers. Quickly navigate to disk files, restart/reload your projects with a single click, and keep important settings persistent between editor sessions.

Awesome Lists containing this project

README 

          
# Scooter Utilities [![starline](https://starlines.qoo.monster/assets/ScottKirvan/ScooterUtils)](https://github.com/qoomon/starline)




  logo

    
ScottKirvan/ScooterUtils


  
A collection of editor tools for Unreal Engine


  

  





  

    contributors

  

  

    last update

  

  

    forks

  

  

    stars

  

  

    open issues

  

  

    license

  

  

    

    

  



   



    View Demo

   · 

    User Documentation

   · 

    Report Bug

   · 

    Request Feature

  





**Scooter Utilities** is an Unreal Engine editor plugin that bundles essential quality-of-life tools for artists and developers. Quickly navigate to disk files, restart/reload your projects with a single click, and keep important settings persistent between editor sessions.



Think of **ScooterUtils** as a Swiss Army Knife of tools that make Unreal Engine a bit quicker to use, especially if you're creating and maintaining several projects. If you've got something you're repeatedly turning on or resetting every time you open your projects, that might be a good candidate for an addition to **Scooter Utilities**, so feel free to [make a suggestion](https://github.com/ScottKirvan/ScooterUtils/issues/new?labels=enhancement&title=%5BFEATURE+REQUEST%5D).



If you're looking for information on how to *use* the plugin inside Unreal, please check out the [User Documentation](notes/USER_README.md). This document is for people using the source code in the [GitHub repository](https://github.com/ScottKirvan/ScooterUtils).



Branches

--------



```

master

     └─── main development branch - supports the latest version of Unreal

All-Versions-Prior-to-5.1

     └─── These are the UE4.x versions. Tested back to 4.25, may work in earlier versions.

UE-5.1-to-5.2

     └─── tested and working in UE-5.1-to-5.2

UE-5.3-to-5.4

     └─── tested and working in UE-5.3-to-5.4

release-please--branches--master

     └─── used by Please-Release GitHub action.

```

New features are added to the `master` branch.  Older branches may not have the same feature support.



Repo Layout

-----------

```

ScooterUtils

├───.github

│   ├───release-please

│   └───workflows

├───Config

├───Resources

├───Source

│   ├───ScooterUtils

│   │  ├────Private

│   │  └────Public

│   └───ScooterUtilsBPLibrary

│      ├────Private

│      └────Public

├───_layouts

├───assets

│   ├───css

│   └───media

└───notes

```

The `_layouts` and `assets/css` folders help support the look of the repo when rended to GitHub Pages (Deployment Workflow).  You can see an example of this repo processed using Jekyll and published at [ScottKirvan.com](https://www.scottkirvan.com/ScooterUtils/). 



The css file creates a page that is styled similar to GitHub's [Dark High Contrast](https://github.blog/changelog/2021-08-25-dark-high-contrast-theme-ga/) theme.



The files in the `.github` folder implement and customizes a github action that runs [Release-Please](https://github.com/googleapis/release-please), which helps with releases, semantic versioning, and updating the [CHANGELOG](notes/CHANGELOG.md).  Release-Please uses the following: `fix:` triggers a patch release, `feat:` triggers a minor release, and `feat!:`, or `fix!:`, `refactor!:`, etc., are all considered breakers and trigger a new major version.  Some common commit prefixes are: `build:`, `chore:`, `ci:`, `docs:`, `style:`, `refactor:`, `perf:`, `test:`.



Release-Please creates a pull request in this repo.  Merging that back into `master` will create a new release, and tag it in GitHub.  



The two modules that make up the plugin are in the `Source` folder.  There's *two* modules because one needs to be editor-only, and the other is a runtime (in-game) module.  `ScooterUtils` is the editor-only module, and `ScooterUtilsBPLibrary` is the runtime module. The runtime module only contains Blueprint nodes.



Table of Contents

-----------------

- [Branches](#branches)

- [Repo Layout](#repo-layout)

- [Installation](#installation)

- [Features / Usage](#features--usage)

- [Contributions / Contact](#contributions--contact)

- [References / Inspirations / Credits](#references--inspirations--credits)



Installation

------------

This is kind of standard practice for GitHub Unreal plugins*; it goes

like this:



1. Create a new Unreal project.

1. Create a ```Plugins``` folder in your project directory.

1. Clone the GitHub repository (or grab and unzip the project) into your

```Plugins``` folder.

1. Launch Unreal; You should be prompted to build the plugin.

2. Optional:  Use or convert your unreal project to a C++ project so

that you can edit and build the code outside of Unreal.



> [!NOTE]

> As of UE 5.5.0, the automatic building of plugins within blueprint-only projects is no longer working - You need to be using a C++ based Unreal project for the source to build.  Once it's built, you can copy/paste the plugin to other projects (or to your engine's plugin folder (**[UE_PATH]/Engine/Plugins/Marketplace**) to install it as an engine plugin).

> 

> Working with c++ projects may involve additional dependencies, like installing and configuring an IDE, which may be more than some users are willing to do, and more than I'm willing to document and support, which is ~~why I've made the precompiled version(s) of the plugin available on the [Fab Marketplace](http://fab.com).~~ (WIP)



Features / Usage

-----

For documentation on what the plugin does, installing from fab, enabling, and using it, see the [User Documentation](notes/USER_README.md).



Developer Notes

--------

ScooterUtils is implemented in a single module: "ScooterUtils." It's an editor-only plugin (no runtime functionality), and uses an OnEndFrame callback to execute certain functionality when we're confident the engine (and our module) is fully loaded (PostEngineInit).



FScooterUtilsModule is the main module implementation, and that's where all the functionality of ScooterUtilsMenu (for restart, and open explorer) happen, and ScooterUtilsSettings (for all the Persistent Editor Preferences settings) are handled.



ScooterUtils preferences (engine install: `[UE_PATH]/Engine/Plugins/Marketplace`) are written to disk at:

```

c:\Users\\AppData\Local\UnrealEngine\\Saved\Config\WindowsEditor\EditorSettings.ini

```

The ScooterUtils section of EngineSettings.ini will look something like:

```ini

[/Script/ScooterUtils.ScooterUtilsSettings]

bOverrideUEApplicationScale=True

ApplicationScale=0.800000

MaxFPS=200

ShowViewportFPS=False

```

## Supported Platforms



Supported Unreal Engine versions: **4.25-5.5***



For the most part, it should work on other platforms, and be easily adaptable to any earlier or later versions.



* *If you are building this repo/plugin from source, with an engine version prior to UE 5.5, please make sure you clone/download the correct [branch](#branches).*



## Dependencies



The source requires Visual Studio (I've used the free 2019 & 2022 community version)

and either an Unreal C++ code (rather than blueprint) project or the full

Unreal Engine 4 source code from GitHub.



Building it inside a project is dead simple.  Clone the repository

into the *Plugins* directory of your Unreal C++ based project. Go to

**File**, and select **Update Visual Studio Project**.  From there,

the plugin should be buildable, and once compiled, can be left in *Plugins* directory for the project you're working on, or copied into

your Engine's main *Plugins* folder so it's available to all your future

editing sessions.  



If you are new to programming in UE,

please see the official [Programming Guide](https://docs.unrealengine.com/en-US/Programming/Plugins/index.html). 



Contributions

-----------------------

- [report any issues](https://github.com/ScottKirvan/ScooterUtils/issues/new?labels=bug&title=%5BBUG%5D%20).

- [request new features](https://github.com/ScottKirvan/ScooterUtils/issues/new?labels=enhancement&title=%5BFEATURE+REQUEST%5D%20).

- Developers:  [grab a fork](https://github.com/ScottKirvan/ScooterUtils/fork), hack away, and toss in a [pull request](https://github.com/ScottKirvan/ScooterUtils/pulls) with your changes.

- To show your support for my work, Throw me a bone!  please TODO TODO [star]() this repo, and rate/review the plugin on [fab](http://fab.com), and/or [donate]() to my GitHub projects.



Contact

-------

- Feel free to reach out to me on the [Unreal Slackers](https://discord.gg/unreal-slackers) discord. I'm @Fragmanget_. There is a ton of other Unreal programmers up there, so if I'm not around to help, someone else may be able to get you going.

- You can also reach me on my personal [Discord Server](https://discord.gg/TSKHvVFYxB) (@cptvideo),

via [LinkedIn](https://www.linkedin.com/in/scottkirvan/), or [email](mailto://ScooterUtils@skvfx.com).



References / Inspirations / Credits

-----------------------------------

- To learn c++ coding plugins in Unreal, sign into the Unreal Engine [Learning & Support](https://www.unrealengine.com/en-US/learn) area and take the *Best Practices for Creating and Using Plugins* course - it's great! *Anyone know where this went? It's out of date, but it still had a lot of great info.*

- Another resource for creating Editor (not runtime) specific tools is [this tutorial](https://lxjk.github.io/2019/10/01/How-to-Make-Tools-in-U-E.html) by Xun (Eric) Zhang.

- This blog post on [custom project settings](http://www.mov-eax-rgb.net/blog/custom-settings-object/) is short, but it saved me when I got stuck.

- Huge thanks to the Unreal Team!  I had only been learning Unreal for a little over a month when I first wrote this.  I am so totally blown away.  Epic's training material is outstanding - The sheer amount of material available, directly from Unreal, and being produced by end users, artists, and programmers is unlike anything I've ever experienced in the industry.

- Thanks, also, to [Caio Liberali](https://github.com/caioliberali) for the original Unreal Engine [Pull Request](https://github.com/EpicGames/UnrealEngine/pull/7436) that inspired this project.  



---

**Copyright (c) (2020-2025):** [Scott Kirvan](https://github.com/ScottKirvan)  - All rights reserved   

*ScooterUtils is licensed under the [BSD 3-Clause License](../LICENSE.md).*  



Project Link:  [ScooterUtils](https://github.com/ScottKirvan/ScooterUtils)  

[CHANGELOG](notes/CHANGELOG.md)  

[TODO](notes/TODO.md)