Diplomatic Catalysts

Guide Victoria 3 mod developers in designing and validating diplomatic catalyst definitions.

21|8|Updated Jun 23, 2025
One-click install
npx skills add https://github.com/mattia2110/tech-and-res --skill diplomatic-catalysts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Diplomatic Catalysts
Source: https://github.com/mattia2110/tech-and-res/tree/main/.agents/skills/diplomatic_catalysts
Command: npx skills add https://github.com/mattia2110/tech-and-res --skill diplomatic-catalysts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides comprehensive guidance for creating, editing, and reviewing Victoria 3 diplomatic catalyst definitions used by mod files. It explains how catalysts tie into actions, events, and scripted effects, and how to keep definitions coherent with category schemas and guidelines.

Core Features & Use Cases

  • Document the required schema for catalyst files (category, political_lobby_creation, ai_country_goal_recalculation, and effect) and how to reuse existing components to maintain consistency.
  • Outline the workflow to locate catalyst definitions in common/diplomatic_catalysts, verify related category definitions in common/diplomatic_catalyst_categories, and audit surrounding diplomacy logic such as actions and events that trigger catalysts.
  • Provide practical guidance for modders to update or add catalyst usage in callers like ztr_invite_to_power_bloc, ensuring tooltips, cooldowns, and outcomes stay aligned.

Quick Start

Create or review a catalyst definition in common/diplomatic_catalysts following the provided schema.

Frequently Asked Questions about Diplomatic Catalysts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create new diplomatic catalysts in Victoria 3 mods?

To create diplomatic catalysts, define them in common/diplomatic_catalysts following the required schema for category, political_lobby_creation, ai_country_goal_recalculation, and effect to ensure correct integration with actions and events.

What is the correct schema for Victoria 3 diplomatic catalyst files?

The diplomatic catalyst schema requires category, political_lobby_creation, ai_country_goal_recalculation, and effect blocks. Reusing existing components within these definitions maintains consistency across related actions and scripted effects.

Why are my Victoria 3 diplomatic catalysts not triggering scripted effects?

Diplomatic catalysts may fail if definitions lack coherence with category schemas or if cross-file references in actions and events are misaligned. Audit surrounding diplomacy logic and verify category definitions in common/diplomatic_catalyst_categories.

How do I update catalyst usage in Victoria 3 actions like ztr_invite_to_power_bloc?

To update catalyst usage in callers, verify that tooltips, cooldowns, and outcomes stay aligned with the catalyst definition. Audit the surrounding diplomacy logic to ensure safe, localized effects and overall balance.

Do I need to understand AI goal recalculations to add Victoria 3 diplomacy catalysts?

Yes, understanding ai_country_goal_recalculation is required. You must ensure catalyst definitions integrate safely with AI goals, lobby creation blocks, and localized effects to maintain coherence and balance across the diplomatic pipeline.

What's the best way to review existing Victoria 3 diplomatic catalyst definitions?

The best way to review catalysts is to locate definitions in common/diplomatic_catalysts, verify related category definitions in common/diplomatic_catalyst_categories, and audit surrounding diplomacy logic such as actions and events that trigger them.