Talky

Talky is a modern, Folia-ready cinematic NPC dialogue plugin.

It transforms NPC interactions into immersive cinematic dialogues featuring smooth camera rotation, camera locking, FOV zooming, blindness atmosphere, multiline chat styling with MiniMessage/PAPI, per-line command execution, and flexible progression modes (timer, click, sneak).

Features

• Folia & Paper Native: Built using unified region-safe scheduling (RegionScheduler, AsyncScheduler, GlobalRegionScheduler) with fallback to standard Paper Bukkit scheduler.
• Cinematic Camera Lock & Smooth Rotation:
  • Smoothly turns player camera to face NPC eye level using ease-in-out smoothstep curves over configurable ticks.
  • Locks player camera yaw and pitch onto NPC during conversation while allowing free body movement.
  • Anti-fly safe: jumping or falling players are not frozen mid-air; gravity lands players safely before anchoring.
  • Initiation grace period allows running or holding W towards NPC without accidental cancel.
• Atmospheric Effects:
  • FOV Zoom: Applies slowness effect for camera zoom without jarring double-FOV FOV jumps.
  • Blindness: Cinematic fog that focuses player attention on the speaking NPC.
• Rich Text Formatting:
  • Full MiniMessage support (<color>, <gradient>, <bold>, <click>, <hover>).
  • Supports multiline dialogue as YAML string lists, including blank lines for spacing.
  • Legacy color code compatibility (&a, §a) and hex (&#RRGGBB).
  • PlaceholderAPI integration with player (%player%, %player_name%) and NPC (%npc%) replacements.
  • Oraxen glyphs and font shifts supported.
• Action Triggers & Commands:
  • Run console commands or player commands on each dialogue line.
  • Run completion commands and sounds when dialogue concludes.
• Progression Modes:
  • AUTO: Timed progression using tick delays.
  • MANUAL: Dialogue pauses on each line until player sneaks or clicks.
  • HYBRID: Automatically advances after delay, or advances immediately if player clicks/sneaks to skip ahead.
• Broad NPC Support:
  • FancyNpcs (NpcInteractEvent)
  • Citizens (NPCRightClickEvent)
  • Vanilla named entities, villagers, and interaction entities (PlayerInteractEntityEvent)
  • Direct command trigger (/talk <id>)

Commands & Permissions

Default permissions:

• talky.use: Given to all players by default (default: true).
• talky.admin: Given to OP by default (default: op).