Skip to main content

Player Input

EasyTalk supports the new Unity Input System as well as the old Input Manager.

Input is handled by a Dialogue Input Handler component which is added to each Dialogue Display.

Custom Input Handling​

If you would rather use your own input system or control the dialogue system differently, you can look at the DialogueInputHandler class to see how input is handled and how it controls the Dialogue Display to get a better idea of how to implement your own or modify the DialogueInputHandler yourself.

In general, you will likely want to support the following:

  • Continuing to the next line of dialogue
  • Selecting options
  • Finalizing the option choice

Input Handler Settings​

The settings shown in the Unity Editor will depend on which input system you are using, but brief descriptions of settings for each are below.

Input Manager Settings​

If you are using the Input Manager, the following settings are shown in the Inspector for a Dialogue Display under 'Input Settings':

Input NameDescription
Continue Button NameThe name of the button which causes the conversation to move to the next line of dialogue during dialogue playback.
Choose Selected Option Button NameThe name of the button which causes the currently selected option to be chosen and finalized.
Quick Exit Button NameThe name of the button which causes the dialogue playback to be stopped immediately (only if 'Allow Quick Exit' is set to true).
Horizontal Axis NameThe name of the horizontal axis to use when selecting next/previous options and choosing options in a 2D direction.
DPAD Horizontal Axis NameThe name of the horizontal axis for the DPAD. Used when selecting next/previous options and choosing options in a 2D direction.
Vertical Axis NameThe name of the vertical axis to use when selecting next/previous options and choosing options in a 2D direction.
DPAD Vertical Axis NameThe name of the vertical axis for the DPAD. Used when selecting next/previous options and choosing options in a 2D direction.

Input System Settings​

If you're using the newer Input System, you'll need to have an Input Actions asset for the Dialogue Display.

The default controls set up on each Dialogue Display are in the 'Runtime/Resources/settings/DialogueInputs.inputactions' file.

If you decide to create your own input actions, you will need to configure the Dialogue Display by telling it the names of the configured actions to map to specific dialogue actions. Each action is expected to be of a certain type (button, value (axis), etc.).

The names of the settings provided in the Dialogue Display under 'Input Settings' are shown below, along with brief descriptions of each input action.

Input Actions: The Input Actions asset which the Dialogue Display should use.

Setting NameAction TypeDescription
Continue Action NameButtonThe name of the action which causes the conversation to move to the next line of dialogue during dialogue playback.
Next Option Action NameButtonThe name of the action which causes the display to select the next option when options are being displayed to the player.
Previous Option Action NameButtonThe name of the action which causes the display to select the previous option when options are being displayed to the player.
Choose Option Action NameButtonThe name of the action which causes the currently selected option to be chosen and finalized.
Exit Conversation Action NameButtonThe name of the action which causes the dialogue playback to be stopped immediately (only if 'Allow Quick Exit' is set to true).
Select Option X-Direction Action NameValue - AxisThe name of the action which determines the X value for selecting an option in a particular 2D direction (only applicable when using Directional Option Displays).
Selection Option Y-Direction Action NameValue - AxisThe name of the action which determines the Y value for selecting an option in a particular 2D direction (only applicable when using Directional Option Displays).