Map Categories

Map Categories are the first level of categorization of Controller Maps. Each Controller Map belongs to one Map Category and one Layout. The combination of the two serves to identify the Controller Map when selecting a Controller Map in the Rewired Editor or from the API.

UnlikeĀ Layouts, all types of controller maps share the same set of Map Categories.

Depending on your game's design, you may choose to use Map Categories for a variety of purposes. One example use would be for a game that has multiple different game modes. In such a game, Map Categories can help you organize controls for your different game modes easier. For example, if you have the following categories each of which correspond to a different game mode: System, Menu, Gameplay Shared, Infantry, Vehicle, Airplane. This allows you to have different control mappings for each game mode. You can use the category to determine which maps should be enabled/disabled when you change your game mode, for example going to the menu screen or getting on/out of a vehicle.

When creating user control assignment screens, you can use the "User Assignable" flag to help determine which categories to display to the user. For example, if your System category contains controls reserved for the system (Save, Load, Exit, etc), you may not want the user to be able to re-assign these. If that's the case, uncheck "User Assignable" and then check for this flag in your mapping screen code. (Some example mapping screen code is included in the Rewired/Examples directory.) Controls in non-user-assignable categories can also be locked from change during assignment conflict checking.

Category selective conflict checking - choose to conflict check some categories with other categories, but not necessarily in both directions. (Useful for complex stacked map setups). To choose which categories the current category should conflict check against, uncheck "Check Conflicts With All" and add categories to "Check Conflicts With Specific Categories."

Creating and Editing Map Categories:

Rewired Editor - Map Categories