Skip to content
This repository has been archived by the owner on Feb 11, 2024. It is now read-only.

PlayerPrefs Editor & Utilities provide an easy way to see what PlayerPrefs your game is using and change them at run-time.

License

Notifications You must be signed in to change notification settings

sabresaurus/PlayerPrefsEditor

Repository files navigation

PlayerPrefs Editor & Utilities

openupm GitHub PRs Welcome

PlayerPrefs Editor & Utilities provide an easy way to see what PlayerPrefs your game is using and change them at run-time. It also includes encryption support to protect your player prefs from casual hacking and has additional support for more data types.

Editor features include:

  • list all active PlayerPrefs and EditorPrefs
  • search for prefs to refine results
  • change pref values at run-time
  • add new prefs
  • delete prefs
  • quick delete all button
  • import prefs from another project
  • supports working with the encryption features added in the utilities

Utilities features include:

  • set and get the built in PlayerPref types using an encryption layer - plain text values are transparently converted to encryption so that the PlayerPrefs are protected in the device data stores
  • set and get Enum values
  • set and get DateTime values
  • set and get TimeSpan values
  • set and get Bool values

This package was originally sold on the Unity Asset Store, but as of 29th April 2017 has been open sourced under the MIT License (see LICENSE for details). It is now maintained on this Github repository.

For a more comprehensive quick start guide and API documentation please go to https://sabresaurus.com/docs/playerprefs-editor-utilities-documentation/

PlayerPrefs Editor

To open the PlayersPrefs Editor go to Window -> PlayerPrefs Editor

This will open an editor window which you can dock like any other Unity window.

The Player Prefs List

If you have existing saved player prefs you should see them listed in the main window. You can change the values just by changing the value text box, you can also delete one of these existing player prefs by clicking the X button on the right.

Search

The editor supports filtering keys by enterring a keyword in the search textbox at the top. As you type the search results will refine. Search is case-insensitive and if auto-decrypt is turned on it will also work with encrypted player prefs.

Adding A New Player Pref

At the bottom of the editor you'll see a section for adding a new player pref. There are toggle options to determine what type it is and a checkbox for whether the player pref should be encrypted. Once you've selected the right settings and filled in a key and value hit the Add button to instantly add the player pref.

Deleting An Existing Player Pref

To delete an existing player pref, click the X button next to the player pref in the list. You can also delete all player prefs by clicking the Delete All button at the bottom of the editor.

PlayerPrefs Utilities

IMPORTANT: If using encryption, make sure you create a custom key under More Options, this will make sure your key is unique and make the protection stronger.

In PlayerPrefsUtility.cs you'll find a set of utility methods for dealing with encryption and also new data types. There is documentation within this file explaining how each method works. There is also additional documentation at https://sabresaurus.com/docs/playerprefs-editor-utilities-documentation/

License

Licensed under MIT, see LICENSE for details.

Installation

Add from OpenUPM | via scoped registry, recommended

This package is available on OpenUPM: https://openupm.com/packages/com.sabresaurus.playerprefseditor/

To add it the package to your project:

  • open Edit/Project Settings/Package Manager
  • add a new Scoped Registry:
    Name: OpenUPM
    URL:  https://package.openupm.com/
    Scope(s): com.sabresaurus
    
  • click Save
  • open Package Manager
  • click +
  • select Add from Git URL
  • paste com.sabresaurus.playerprefseditor
  • click Add
Add from GitHub | not recommended, no updates through UPM

You can also add it directly from GitHub on Unity 2020.3+. Note that you won't be able to receive updates through Package Manager this way, you'll have to update manually.

  • open Package Manager
  • click +
  • select Add from Git URL
  • paste https://github.com/sabresaurus/PlayerPrefsEditor.git
  • click Add
    or
  • Edit your Packages/manifest.json file to contain "com.sabresaurus.playerprefseditor": "https://github.com/sabresaurus/PlayerPrefsEditor.git",

To update the package with new changes, remove the lock from the Packages/packages-lock.json file.

To open the window go to Window → PlayerPrefs Editor

About

PlayerPrefs Editor & Utilities provide an easy way to see what PlayerPrefs your game is using and change them at run-time.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages