Advanced Features

Advanced Features

Welcome to the Advanced Features guide! 🚀 This section dives into some of the more powerful functionalities of the Strikes-Dialogues plugin, helping you to create a more dynamic and interactive experience for your players. Whether you're looking to implement advanced effects, execute custom commands, or control specific player interactions, these features will allow you to take your dialogues to the next level! ✨

Table of Contents

• Persistent Background Line

• Locking Player’s Perspective

• Zoom Effect (Temporarily Removed (Will added back soon))

• Custom End Actions

• Placeholders and Dynamic Content

---

Persistent Background Line

The persistent background line allows you to add a background element to the dialogue that persists throughout all pages of the dialogue, rather than changing or disappearing as you move from one page to another. This can create a more cohesive visual experience for players.

How to Use:

To set up a persistent background line, you need to define it in the settings section of your dialogue configuration.

settings:
  persistent-background-line: "&f"

In this example:

• The &f character will remain as the background line for the entire duration of the dialogue.

Example of Persistent Background:

dialogues:
  welcome_intro:
    settings:
      persistent-background-line: "&f"
    pages:
      - - "Welcome %player_name%!"
        - "This is your introduction page."
      - - "Here's your second page!"
        - "The background line persists across both pages."

---

Locking Player’s Perspective

The lock-perspective feature restricts the player's ability to look around during the dialogue, ensuring they focus solely on the conversation. This can be useful for immersive experiences, like guiding players through important instructions or roleplay scenarios.

How to Use:

To enable this feature, set lock-perspective to true in the settings section.

settings:
  lock-perspective: true

Example of Locked Perspective:

dialogues:
  immersive_intro:
    settings:
      lock-perspective: true
    pages:
      - - "You can only see the dialogue."
        - "You cannot move or look around until the dialogue ends."

This ensures that while the dialogue is active, players will be unable to shift their view. To release them, you can include a custom end action that reverts the lock.

---

Zoom Effect

The zoom effect is a powerful visual effect that zooms in on the player's screen during the dialogue, enhancing the player's immersion. You can also control the player's movement speed while the effect is active, adding to the intensity.

How to Use:

To enable the zoom effect, you can use the enable-zoom-effect option in the settings section. Additionally, you can adjust the player’s walk speed during the zoom.

settings:
  enable-zoom-effect: true
  zoom-walk-speed: -0.15

Example of Zoom Effect:

dialogues:
  zoomed_intro:
    settings:
      enable-zoom-effect: true
      zoom-walk-speed: -0.2
    pages:
      - - "You are now zoomed in!"
        - "Feel the intensity as you read this text."
      - - "The effect will be released after this page."

By adjusting the zoom-walk-speed, you can control how fast or slow the player moves while the zoom effect is applied. Negative values slow them down, while positive values increase their speed.

---

Custom End Actions

One of the most powerful features of Strikes-Dialogues is the ability to define custom end actions. These actions allow you to trigger a variety of events once the dialogue has finished, such as sending messages, executing commands, or playing sounds.

Available End Actions:

• [MESSAGE]: Sends a message to the player.

• [CONSOLE]: Executes a command in the console.

• [PLAYER]: Executes a command as the player.

• [SOUND]: Plays a sound effect.

• [BROADCAST]: Broadcasts a message to all players.

• [TELEPORT]: Teleports the player to a specified location.

How to Use:

End actions are defined in the end-actions section of your dialogue configuration. You can chain multiple actions together for more complex results.

end-actions:
  - "[MESSAGE] &aThanks for reading the dialogue!"
  - "[CONSOLE] say %player_name% has completed the dialogue."
  - "[SOUND] entity.player.levelup volume:0.8 pitch:1.2"
  - "[BROADCAST] &e%player_name% just finished an important dialogue!"

Example with Custom End Actions:

dialogues:
  final_instructions:
    settings:
      lock-perspective: true
    pages:
      - - "You have reached the end of the instructions."
        - "Get ready for your next challenge!"
    end-actions:
      - "[PLAYER] teleport %player_name% 100 64 100"
      - "[MESSAGE] &aGood luck, %player_name%!"
      - "[BROADCAST] &e%player_name% is ready for the next step!"

---

Placeholders and Dynamic Content

Placeholders are a great way to dynamically insert player-specific information into your dialogues. You can use PlaceholderAPI to include things like player name, balance, world, and more. This makes each dialogue unique and customized for every player!

Commonly Used Placeholders:

• %player_name% – The player's name.

• %vault_eco_balance_formatted% – The player's economy balance (if using Vault).

• %player_world% – The world the player is currently in.

• %player_x%, %player_y%, %player_z% – The player’s current coordinates.

• %server_tps% – The server's current TPS (ticks per second).

Example with Placeholders:

dialogues:
  dynamic_info:
    pages:
      - - "Hello %player_name%, welcome to the server!"
        - "Your balance is: %vault_eco_balance_formatted%."
        - "You are in the world: %player_world%."
        - "Current server TPS: %server_tps%."

Placeholders allow you to automatically display dynamic, real-time information for each player, making your dialogues feel more personalized and engaging.

---

Wrapping It Up

The Advanced Features in Strikes-Dialogues give you the power to create deeply immersive and interactive experiences for your players. Whether you're locking the player's perspective, adding dynamic content with placeholders, or triggering custom actions after dialogues, these features offer endless creative possibilities for your Minecraft server! ✨

Now you have all the knowledge to make your dialogues even more powerful and immersive. Enjoy exploring these advanced features and make your server stand out! 🚀

---

Happy Configuring! 🎉