LikeDialogs

Animated cinematic dialogues with Display Entities for Paper.

Transform your server's conversations into immersive visual experiences. LikeDialogs renders 3D floating text directly in the player's view using Text Displays via packets — no physical entities, no lag.

---

Main Features

Feature	Description
Text Animators	static, typewriter, wave, glitch — each with configurable parameters
Interpolators	fade, move, scale, pop-in (composite) — smooth animations over opacity, position, and scale
Display Modes	STATIC (fixed in space), HORIZONTAL (horizontal plane), CENTER (follows the camera in 3D)
Billboard	fixed, vertical, horizontal, center — full control over text orientation
Interactive Responses	Choice system with raycasting — the player looks and clicks to choose
Branching Dialogues	Jump between dialogues with target-dialog — unlimited conversation trees
Staggered Children	appear-after so multiple entities appear sequentially
Sounds per Character	Each letter of the typewriter can play a custom sound
MiniMessage	Full support for MiniMessage colors, gradients, fonts, and tags
PlaceholderAPI	Native integration for dynamic placeholders
Zero Lag	Everything via packets with PacketEvents — no entities in the world

---

Quick Installation

1. Download the .jar and place it in plugins/
2. Install PacketEvents (required dependency)
3. (Optional) Install PlaceholderAPI for placeholders
4. Restart the server
5. Edit the files in plugins/LikeDialogs/dialogs/

---

Configuration Example

dialogs:
  forest_lore:
    distance: 4
    scale: 1.5
    display-mode: CENTER
    billboard: center
    background-color: "#051405"
    background-opacity: 240
    line-width: 250
    frames:
      - text: "<#A0522D>«The forest has heard you...»</#A0522D>"
        duration: 120
        offset:
          x: 0.0
          y: 0.3
        animator: typewriter
        params:
          speed: 0.6
          cursor: "<gray>_</gray>"
          sound:
            key: block.amethyst_block.chime
            volume: 2.5
            pitch: 1.6
            source: master
          interpolators: [fade, scale]
          fade-in: 25
          fade-mode: in
          scale-start: 0.8
          scale-end: 1.5
          scale-duration: 20
        responses:
          - text: "<#5D7A58>«I want to know more...»"
            target-dialog: "forest_lore_more"
            offset:
              x: -1.2
              y: -0.8
            scale: 0.2
            billboard: fixed
            params:
              interpolators: [move]
              move-y: 0.2
              move-duration: 10
              move-mode: in

Property Inheritance

dialogs:
  my_dialogue:
    billboard: center          # ← inherited by all frames
    background-opacity: 200    # ← inherited by all frames
    frames:
      - text: "Parent"
        billboard: fixed       # ← dialog override
        children:
          - text: "Child"      # ← inherits 'fixed' from parent frame

---

Commands

Command	Description
/likedialogs show <player> <dialog-id>	Shows a dialogue to a player
/likedialogs hide <player>	Hides the active dialogue
/likedialogs reload	Reloads all YAML files

---

Dependencies

• Paper 1.19.4+
• PacketEvents — required
• PlaceholderAPI — optional

---

Supported Placeholders

With PlaceholderAPI installed, you can use:

text: "<yellow>Hello <papi:player_name>! Your money: <papi:vault_eco_balance>"

---

File Structure

plugins/LikeDialogs/
├── dialogs/
│   ├── example.yml          # Included example
│   ├── forest_lore.yml      # Your epic dialogue
│   └── quests.yml           # More dialogues...
└── config.yml               # (coming soon)

---

Design Tips

• Use display-mode: STATIC + billboard: fixed for texts that must stay fixed in the world while the player walks.
• Use display-mode: CENTER + billboard: center for dialogues that follow the player's gaze (immersive UI).
• Combine fade + scale with scale-mode: in for "dramatic appearance" effects.
• Use children with staggered appear-after.
• background-color: "" + background-opacity: 0 makes the background completely transparent.

---

Created with ❤️ for the Minecraft community