https://github.com/Eldoir/Array2DEditor

Use 2-dimensional arrays in Unity's Inspector.
https://github.com/Eldoir/Array2DEditor

arrays editor plugin unity

Last synced: 2 months ago
JSON representation

Use 2-dimensional arrays in Unity's Inspector.

• Host: GitHub
• URL: https://github.com/Eldoir/Array2DEditor
• Owner: Eldoir
• License: mit
• Created: 2017-12-20T14:34:14.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-07-24T19:24:17.000Z (over 1 year ago)
• Last Synced: 2024-08-02T05:17:00.073Z (5 months ago)
• Topics: arrays, editor, plugin, unity
• Language: C#
• Homepage:
• Size: 1.09 MB
• Stars: 165
• Watchers: 7
• Forks: 11
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Array2DEditor

Use this if you want to deal with 2D arrays easily within the inspector of Unity.

## Getting Started

For a quick import into an existing project, just get the [UnityPackage](Array2DEditorPackage.unitypackage). It also contains some examples.

The `Array2DEditor` folder on this repo is an empty project with only the plugin imported! 🙂

To get started:

- Just use the types defined by `Array2DEditor`, such as `Array2DInt`, `Array2DBool`, `Array2DString`...

- Don't forget to add `using Array2DEditor` on top of your script.

- You can then use the method `GetCells()` or `GetCell(int x, int y)` on your variable to get the values from your array at runtime!

## See it in action

![Example 2](Screenshots/Example_2.gif)

![Example 1](Screenshots/Example_1.PNG)

## Create arrays from your own types!

To do that:

- Create a new class inheriting from `CellRow` with your own type as the `T` type.

	- See the classes in `CellRowTypes` as an example.

- Create a new class inheriting from `Array2D` with your own type as the `T` type.

	- See the existing `Array2D` classes that you can find in the `Array2DTypes` folder as an example.

- Create a new class inheriting from `Array2DDrawer` and put it in an `Editor` folder.

	- See the existing `Array2DDrawer` classes that you can find in the `Editor/PropertyDrawers` folder as an example.

- If your type is an enum, you can make your `PropertyDrawer` inherit directly from `Array2DEnumDrawer`. The code will then be trivial.

	- See `Array2DExampleEnumDrawer` as an example.

## Notes

* The plugin currently does not display well with collections of Array2D's (such as arrays or lists).

* Array2D's don't display in a ScrollView, so you're limited to a certain grid width before it goes out of the Inspector window. On a 1080p screen with a fullscreen Inspector window, you can have 50 cells with a 32px cell width, or 90 cells with a 16px cell width. You can change the cell size at any moment from the Inspector using the dropdown menu of any Array2D.

* Last tested with [Unity 2019.4.13f1 (LTS)](https://unity3d.com/unity/whats-new/2019.4.13).

## Authors

* **[Arthur Cousseau](https://www.linkedin.com/in/arthurcousseau/)**

* Thanks to **[Bugbyte Studio](https://www.linkedin.com/in/bugbytestudio/)** for the idea of using Enums in `Array2DEditor`.

* Thanks to **[CarlosManuelRodr](https://github.com/carlosmanuelrodr)** for the idea of using Sprites (and Objects in general) in `Array2DEditor`.

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details