sabresaurus / PlayerPrefsEditor

PlayerPrefs Editor & Utilities provide an easy way to see what PlayerPrefs your game is using and change them at run-time.
MIT License
292 stars 39 forks source link

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:

Utilities features include:

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 http://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 http://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