Skip to content
BranchesTags

Repository files navigation

SaintsField

unity_version license_mit openupm Percentage of issues still open Average time to resolve an issue openupm repo-stars

SaintsField is a Unity extension tool for enhancing inspector and data serialization.

Developed by: TylerTemp, 墨瞳

Unity: 2022.2 or higher

(Yes, the project name comes from, of course, Saints Row 2)

Getting Started

Highlights

  1. Works on deep nested fields!
  2. Works with custom type drawer (either it's IMGUI or UI Toolkit implemention)
  3. Allow stack on many cases. Only attributes that modified the label itself, and the field itself can not be stacked. All other attributes can mostly be stacked. All decorative attributes can work with 3rd part attributes
  4. Allow dynamic arguments in many cases
  5. Serialize dictionary, interface, hashset and more
  6. Easily group different fields with box

SaintsField is the Top 3 updated Unity Package in 2025 openupm. Hooray!

Note

Since 5.19.0, SaintsField's IMGUI implemention is back to support. But IMGUI support is not in a high priority

Installation

  • Using git upm (Unity UI):

    1. Window - Package Manager
    2. Click + button, Add package from git URL
    3. Enter the following URL:
    https://github.com/TylerTemp/SaintsField.git

  • Using git upm:

    add to Packages/manifest.json in your project

    {
    "dependencies": {
        "today.comes.saintsfield": "https://github.com/TylerTemp/SaintsField.git",
        // your other dependencies...
    }
}

  • Using OpenUPM

    openupm add today.comes.saintsfield

  • Using a git submodule:

    git submodule add https://github.com/TylerTemp/SaintsField.git Packages/today.comes.saintsfield

    Note: submodule will not auto upgrade. please read Git Submodule to know how to upgrade

  • Using a unitypackage (NOT RECOMMENDED):

    Go to the Release Page to download a desired version of unitypackage and import it to your project

  • Using Unity Asset Store (NOT RECOMMENDED)

If you have DOTween installed

  • Please also ensure you do: Tools - Demigaint - DOTween Utility Panel, click Create ASMDEF
  • Or disable related functions with Tools - Saints Field - Disable DOTween Support
  • If you can not find this menu, please read the "Add a Macro" section about how to manually disable DOTween support in SaintsField.

[Optional] To use the full functions of this project, please also do: Tools - Saints Field - Enable SaintsEditor. Note this will break your existing Editor plugin like OdinInspector, NaughtyAttributes, MyToolbox, Tri-Inspector.

If you need to put this project under another folder rather than Packages/today.comes.saintsfield, please also do the following:

  • Create Assets/Editor Default Resources/SaintsField.
  • Copy files from the project's Editor/Editor Default Resources/SaintsField into your project's Assets/Editor Default Resources/SaintsField. If you're using a file browser instead of Unity's project tab to copy files, you may want to exclude the .meta file to avoid GUID conflict.

Troubleshoot

After installation, you can use Tools - Saints Field - Troubleshoot to check if some attributes do not work.

namespace: SaintsField

Change Log

5.25.5

Fix: Remove UI Toolkit support for Animator and make it a plugin package instead. fix #423

Usage

Donation

Donation Link

PayPal: Image

Donation List

Thanks for the following generous donors:

About

A Unity extension for inspector enhancement and data serialization.

saintsfield.comes.today

Topics

unityunity-editorunity-inspectorunity3d

Resources

Readme
Activity

Stars

722 stars

Watchers

4 watching

Forks

33 forks
Report repository

Releases

Used by

Contributors

Languages