Dialogues

Basic description of the dialogue files.

Settings

This section allows you to configure settings specific to dialogues.

Settings:
  typing-speed: 1 # Ticks(Second/20)
  range: 3 # 
  effect: Slowness # Slowness / Freeze
  answer-numbers: true
  prevent-exit: false
  character-name: true
  character-image: true
  background-fog: true

The prevent-exit setting prevents the dialogue from being instant ended using shift.

Dialogue

Specifies the dialogue pages; you can configure everything here.

Dialogue:
  '1':
    lines:
      - 'LuxDialogues is now on #2d87c3BBB!'
      - 'Have not you #cdff29bought #4f4a3eit yet?'
      - 'What are you waiting for?'
    pre-actions:
      - msg %player_name% dialoguepreAction1 @console
    post-actions:
      - msg %player_name% dialoguepostAction1 @console
  '2':
    lines:
      - 'New features are added almost'
      - 'every day I think you'
      - 'shouldn''t miss this'
      - 'opportunity...'
    pre-actions: {}
    post-actions: {}

pre-actions are triggered at the beginning of the dialogue page, while post-actions are triggered at the end. Available arguments here include @console, @delay.<seconds>, condition.<condition> and @redirect. A detailed explanation is provided in the following sections of the page.

The maximum number of lines you can use in dialogues is the same as specified in the Pack/Lines/lines.yml file.

Answers

The selection screen that appears at the end of dialogues.

Answers:
  '1':
    text: I'm buying it now.
    reply:
      - '#82d850<3'
      - '#82d85031 @delay.3'
    sound: luxdialogues:luxdialogues.sounds.ding
    actions:
      - msg %player_name% action1
  '2':
    text: Really?
    condition: :luxdialogues.test:==true
    reply:
      - '#82d850Yes!!'
    sound: luxdialogues:luxdialogues.sounds.beep
    actions:
      - say That's great!! (Player CMD) @delay.5
  '3':
    text: Eew, no!
    reply:
      - '#e52b2bI disagree with you, this plugin is amazing!'
    sound: luxdialogues:luxdialogues.sounds.beep
    actions:
      - msg %player_name% action1 @console

The usage of conditions and actions is explained in the following sections of the page.

You can completely remove this section if you want to create something that only consists of dialogues without any selections.

Conditions

There are 2 types of conditions: one for permissions and the other for placeholders.

Permission Conditions

:permission:==true
:permission:!=true

Placeholder Conditions

%placeholder%==true
%placeholder%!=true
%placeholder%>0
%placeholder%<0
%placeholder%>=5
%placeholder%<=5
%placeholder%==5

Actions

Actions can be used in dialogues and answers. The locations where they are used are specified in the texts above. There are several tags you can use for actions. These are exemplified below.

Delayed Action

say test @delay.5 # The specified value is processed in seconds.

Executed As Console

say test @console

Redirect Action

example2 @redirect # Allows you to seamlessly redirect to other dialogues.

Condition

say You're a VIP @condition.:vip.perm:==true

Tags can be used together with each other.