ℹ️Introduction to Dialogs

Dialogs are interactive popup windows that can be displayed to players in Minecraft. They provide a modern and user-friendly way to present information, collect input, and offer choices to players.

What are Dialogs?

Dialogs in zMenu are custom GUI windows that appear on the player's screen, similar to modern application dialogs. They can contain:

  • Text messages with rich formatting and placeholders

  • Item displays with descriptions and tooltips

  • Interactive inputs for collecting player data

  • Action buttons for player choices

  • Server links for external connections

Key Features

  • Multiple dialog types for different use cases

  • Rich content support including items, text, and interactive elements

  • Customizable styling with width, height, and layout options

  • Input validation and data collection

  • Action system integration with zMenu's action framework

  • Placeholder support for dynamic content

When to Use Dialogs

Dialogs are perfect for:

  • Welcome messages for new players

  • Server information and announcements

  • Player surveys and feedback collection

  • Rules and guidelines presentation

  • Interactive tutorials and guides

  • Server navigation and quick links

Basic Structure

Every dialog configuration file contains several main sections:

  1. Basic Information - Name, title, and type

  2. Behavior Settings - How the dialog behaves

  3. Body Content - What's displayed in the dialog

  4. Inputs (optional) - Interactive elements for data collection

  5. Actions - What happens when players interact with the dialog

Getting Started

To create your first dialog, you'll need to:

  1. Create a new .yml file in your dialogs folder

  2. Define the basic dialog properties

  3. Add content to the body section

  4. Configure any inputs or actions needed

  5. Test the dialog in-game

Continue to the next sections to learn about each dialog type and configuration option in detail.

Last updated