EU4 runyear Console Command

Documentation and detailed help with working examples.
runyear Command
PlayerDLC: None

This console command executes the commands contained within the identified file once the game reaches the specified year.

runyear [Year] [Filename]



The year at which, when reached, the command file should be ran. For example, if you entered 1850, when the game hits the year 1850, the commands within the file would be ran.


The name of the file, placed in the game's Documents folder (Documents/Paradox Interactive/Europa Universalis IV), that you wish to run all commands within (with extension). For example, example.txt.


Here are examples of how to use runyear.

runyear 1875 example.txt

Assuming you have placed a file named example.txt at Documents/Paradox Interactive/Europa Universalis IV, this command would run all of the commands inside of it (one command per line) when the year 1875 is reached.

Looking for EU4 console commands?

Search our complete list!

Quick Overview

The runyear command in Europa Universalis IV is used to schedule a specific command to be automatically executed once a certain year in the game is reached.

The format of this command typically follows: runyear [year] [command].

It can be used for various purposes, such as initiating events, changing country variables, or affecting diplomatic relations, among others.

In-Depth Description

The runyear command in Europa Universalis IV is a console command which triggers specified events or functions to run once the game reaches a certain year.

The syntax for runyear is runyear [year] [command]. The [year] parameter is the desired year when you want your specified command to run, and [command] is the actual command you want to execute.

Bear in mind that the [command] must be the name of a script function that does not require any arguments.

This command can be helpful when you want to set up particular game events for specific years. It automates the process of waiting for a particular year to execute a command, reducing manual effort.

This command should be used when you're trying to change the course of the game at a particular point in time. It's also beneficial when you wish to roleplay or simulate alternate histories where specific events occur at set years.

How to Open the Command Console

In EU4, cheats are executed from the command console, a text box that you type commands into.

To open the command console press the ~(tilde) key, which is typically located under ESC (escape).

If your keyboard does not have that key, or pressing ~ does not work, try the following keys:

  • ~
  • SHIFT + 2
  • SHIFT + 3
  • ALT + 2 + 1

Type your command into the console, and then press ENTER .