Scripted Buttons

What problem does it solve?

Scripted Buttons standardize and simplify the creation of journal-entry-facing buttons in Victoria 3 mods, reducing duplication and ensuring consistent UX across files.

Core Features & Use Cases

• Reusable button definitions: Declare name, description, visibility, and cooldowns in a single place.
• UI integration with JEs: Attach buttons to journal entries and trigger scripted effects or events.
• Lifecycle control: Manage visibility, availability, and AI usage to prevent spam and ensure correct gating.
• Use Case: When modding Victoria 3, define a button to open a JE and apply a modifier only if certain conditions are met.

Quick Start

Create a new scripted button in common/scripted_buttons following the example pattern, including the frontmatter with name and description and attaching it to a journal entry through scripted_button.