• We have updated our Community Code of Conduct. Please read through the new rules for the forum that are an integral part of Paradox Interactive’s User Agreement.

CK3 Dev Diary #16 - Tutorials and Tooltips and Encyclopedias, Oh My!

Hello everyone and welcome to the 16th CK3 Dev Diary!

I’m Matthew, one of the Programmers on CK3, some of you might have seen me around the Discord server or on the forums from when I was on CK2. I started out as a modder on CK2 and then a couple of years ago started working as a Content Designer in house at Paradox, before moving into the Programming role where I’ve been for the past year and a half.

As with the whole team I am of course very excited to be finally able to talk about the game after all our secrecy, so without further ado let us discuss the wonder of making pixels appear on the screen and convey useful information!

CK2 is one of my favourite games, even before I started working here, and I’ve sunk thousands of hours into modding and playing it. But I think we can all be honest here together and admit something, it had a UI with what one might describe as questionable usability.
I know when I started playing CK2 that I very quickly had to stop and go watch many hours of tutorials online because the UI was hard to use and buried relevant info without ever giving you an inkling of where to look.

This is something we very much want to avoid for CK3 for obvious reasons, the strategy and challenge of the game should come from mastering its systems not finding which button you need to click or which number you need to tooltip…

I’d like to quickly give a big shout out to our wonderful User Research team who has done lots of play tests with players of various experience levels in strategy games and given us lots of great feedback, all which has been invaluable in ensuring the various features of this dev diary can help to guide a new player who is unsure of what to do whilst also letting an expert to blaze through with doing what they want.

A lot of work has been put in to make the interfaces clearer and display relevant information to you so let's dive right in and explore it in the way that most of you probably will, when you first launch the game!

The first thing that will confront you when you open up and choose where to play is an option of if you want to start the guided tutorial or just dive in on your own. We are going to go down the guided tutorial otherwise this dev diary would lose quite the chunk of content!


In the tutorial you will take control of Petty King Murchad mac Donnchad of Munster: yes we have fully embraced tutorial Ireland as our starting location.

The tutorial will guide you through various parts of the interface and mechanics of the game, it will open the windows you need to see and highlight relevant pieces of information. Such as how to navigate the map, interacting with characters, and getting married.
All of this takes place in game, so it will be showing you the exact places in the UI you are meant to be looking at and interacting with instead of lumping just walls of text or screenshots at you.


I am not going to go through every piece of information here, as that is best served by going through the tutorial yourself once the game is released than me parroting the text here. But suffice to say it will give you a good starting grasp on how to use the UI and the core mechanics to get you started and playing.

One of the new features in CK3 is Tooltips in Tooltips, the aim of this is that relevant information can just be a mouse move away whenever you see blue highlighted text in game. Instead of making you need to dig through a wiki to find out what a Game Concept means you can just mouse over it and get an explanation!


For example if you tooltip the word Duchy here you get this popup:


This behaviour is nesting so you can get more and more information, so all the blue highlighted Game Concepts in this can also be highlighted to explain what a Ruler is and then what a Title itself is etc.


There are two different modes for Tooltips in Tooltips, timer lock and action lock with the former being the default. These modes determine what causes the Tooltips in Tooltips to lock in place and stay, either a timer which is configured in the settings menu or by clicking in the middle mouse button to manually lock them in place.
We have these two modes so that once you get more comfortable with the game you can turn the tooltips in tooltips into an opt in mode with the action lock for when you come across something you want to see instead of it being more present trying to aid you.

Once you finish the guided section of the tutorial the Reactive Advice section begins. These are bits of advice that appear as a purple info icon during normal gameplay, they will give you mini tutorials based on your current state in the game. If you remember from the tutorial selection popup the second option was to dive in on your own, that option skips the guided tutorial and jumps you right in to play and receive in the game advice.

For example, if your Bishop is not endorsing you and refusing to give you those taxes and troops that you rightfully deserve, as mentioned in Dev Diary #6, then you can click the bubble and get a run down of what that means for you instead of needing to find it on the wiki or find the relevant dev diary.


As with the guided tutorial, this advice will highlight relevant interface elements to show you where to look as well as give examples of actions you could potentially take.

The reactive advice can be reset in the settings menu to show advice you’ve already seen again if you feel like you are forgetting information and need a quick refresher. The reactive advice is also usable in multiplayer so your friends you just introduced the game to can play with you and still get the advice they may need.

Throughout the course of the game other pieces of information will appear in this top bar, as with our other games alerts about things that require your attention will appear such as prompting you go get married or that you have no heir of your dynasty and risk the game ending on your death.
These alerts are all something that can be solved by you by taking relevant actions to make them disappear, which clicking them will take you to a suitable action, they are not a status reminder of something constant such as being at war or having a truce expiring soon, as sometimes happens in our other games because those are not things you can take an action to fix.


Alongside the Alerts and Advice in the top bar is the Issues tab, this shows some summaries of your current situation such as claims you can press, duchies you can create or the fact you have emptied the realm’s cofferts and are bankrupt and in desperate need of money.
These are things you may wish to take action on but are not an urgent thing to fix, or potentially not something you can instantly fix like bankruptcy, you can think of them almost as mini-alerts.

Alongside these are Suggestions of things you can do, they will appear and based on your current situation give you a task you may wish to do, every few months they will appear and can be dismissed as you see fit or entirely disabled in the settings menu once you feel you can work without them.
In our play tests this feature has proven useful for both new and old players, as it gives guidance to new players of things they can do in this big sandbox world and for the more experienced players it acts as a good checklist whilst playing for things you know you want to handle.


For less long term information or pressing things to solve there are two more methods of showing new information, Notifications and Toasts.

A Notification is what it says on the tin really, like the message feed in CK2, smaller pieces of information which are sent over, they are not necessarily some big situation you need to pay attention and generally relate to the happenings of other characters that you may care to see.
Only a few will be displayed at a time and minimise themselves to allow room for the next one before automatically dismissing themselves after some in game time has passed.


Toasts on the other hand are slightly more bombastic compared to their more timid sibling Notifications, they appear at the top of the screen and inform you of good things to celebrate, and sometimes less good things to commiserate about.

They are used for things like the outcomes of events, to tell you what outcome in that dice roll you got without throwing up a huge event window or having it appear as a small notification, and for feedback on actions you’ve taken.

Unlike notifications, they will only show one at a time in a timed queue to show the next, of course if you mouse over one of them that timer will stall itself until you move the mouse away again to let it progress and fade away.


Now last, but in my opinion not least, is the new in game Encyclopedia. It acts as a central place where information on many different parts of the game can be found. From the highlightable Game Concepts mentioned before, to recaps of the guided tutorial and reactive advice, to the various types of terrains and traits present in the game and their effects.


The Encyclopedia contains various pages and is fully searchable as well as including a history of searches and the pages they were on which can be used to scroll back and forward between searches.
All the information on these pages is automatically generated by the game from our script files, so unlike pages on a fan wiki they will automatically update if any values or descriptions change.

Something I’d like to mention about all the new features I’ve talked about here is that they are entirely moddable. Mods are free to create new game concepts which will hook in to the tooltips in tooltips and Encyclopedia automatically, make new lessons in the tutorial to cover their new systems, add more reactive advice or alerts, make new suggestions and situation descriptions, and hook in more notifications or toasts in the script.

One of the aims of CK3 is to be even more moddable than CK2, which is already a very moddable game, and one of those things we’ve looked at improving a lot is the interface modding. In CK2 at best you could change some textures and move things a few pixels but you could rarely add new things, in CK3 we’ve made a lot of things more easily scripted so you can by and large create any new things just as we can.

So in conclusion we’ve worked on a lot of stuff to make the depth and strategy of our games shine through in the choices you make, not the 20 minutes you spend trying to find the information to help you make those choices because the interface is obtuse.

Hopefully you’ve enjoyed the dev diary, if you wanna chat more then I highly recommend joining our CK Discord Server as well.

Bonus Dev Story:

Once a month at the development studio we all spend a day (if your project is not extra busy for a milestone or release) doing whatever we decide to grow our professional skills, this is how the Encyclopedia came about as my little baby over multiple of these personal development days. I thought it would be fun to briefly walk people through its evolution from just an idea to a full feature!

To start with it only included the game concepts, and looked a lot less pretty as art had yet to bless me with their time and wisdom, here is a little screenshot of the “greybox” version that simply vomited out un-formatted text and had a search bar:


Moving on from there I wanted to reorganise it into this concept of “Pages”, so we could also show information on things like all the traits in the game instead of you needing to find someone with the trait to discover what it does, I worked on that and one of the artists generously used some of their time to give the whole thing a much needed makeover:


Our QA has then gone over this through the various iterations raising any issues, especially once it was in a more beta state to give more suggestions for polish and find bugs for me to fix.

Now that I had the text formatted nicer and some suggestions from QA I started adding more and more pages to get to the ones we now have, as well as adding some more luxury features like a search history, better interaction with hotkeys, showing all pages at once, and some debug functionality.

One of the technical problems I ran into was the hot reloading of files crashing the game now, in our debug builds we attach file watchers to all game files so if you change the values of a trait or add a new building type then the game will update its databases internally and update or add those new things. But the problem with that is the Encyclopedia was pointing now to the invalid memory of the old entries we had deleted, the solution to this was adding reload callbacks to fix up the encyclopedia by flushing out its old data and regenerating it, internally this just means that the encyclopedia instead has to register a bunch of page generators that it can re-run instead of using the actual database objects which can get corrupted if modified and the pointers invalidated.

Then with a little bit more polish and tweaking we finally get it in the state it is now which will hopefully prove useful to you all whilst playing!
  • 6Like
  • 2
  • 1
  • 1
Even though I'm already a CK2 player so I know what's the difference between Duchies, Counties etc. really like the idea of tooltips in tooltips for potential new players (and new functions in the game that aren't in CK2).
I like the Encyclopaedia too! I love reading things ingame instead of having to switch to the browser and checking the wiki if I want more info (and sometimes the wiki isn't updated). Also the Suggestions tab looks very clean and "tidy", instead of having a thousand icons popping on screen now there's a tab with all the possible actions I can take.

Oh, and Ireland is officially confirmed by the devs themselves as noob island. :p
Nice. I remember when I first played CK2 that it was my first Paradox game and I wasn’t sure what to do for a while so I think all these features will help new players.

What will you be telling us about next week?
Is there a notifications log? Are the notification forever lost if we dont catch them in time?

Because I liked that the notifications in ck2 stayed until I dismissed them manually
Look like a substansial improvement over the other paradox games, like why can't Imperator: Rome have something similar, I mean it look like CK3 is from Another era than Imperator: Rome. The difference between the lack of quality of Life features in Imperator: Rome and improvement upon them in CK3 is just crazy.

It is hard to Believe that CK3 and Imperator: Rome is made by the same developer and just a year or so between their release dates.
Last edited:
The Wiki is now part of the game, me likey.
Also it is nice to see that you now get the ability to solve some problems, more interaction is always nice.
Will you be able to interact with factions now beyond "Wait until they blackmail you, then win or lose a war or give up?"
While this is intuitive to every other PC game, this is very different from CK2 and EU4, where W has always been political map mode.

Please tell us that there are still keybinds for map modes (I'm personally okay with them being in different locations).

This guy gets it.

WASD is for shooters and top down RPGs, and those keys are better served as shortcuts.

At least be able to let us rebind them.
The tooltips and encyclopedia look great. How many of these 'project' days did it take until the other devs supported it as a real feature?
From a modding perspective: Do the toasts get triggered automatically when a new trait is gained (add_trait), or are there special commands for it?
Also, regarding interface modding: Is it possible to make new ui pages with 'character portraits' of specific characters (based on relationship, jobs and minor titles or even event targets)? I.e. one might want a 'throne room' ui element which shows the most important characters of the realm on one page.
The tooltips and encyclopedia look great. How many of these 'project' days did it take until the other devs supported it as a real feature?
From a modding perspective: Do the toasts get triggered automatically when a new trait is gained (add_trait), or are there special commands for it?
Also, regarding interface modding: Is it possible to make new ui pages with 'character portraits' of specific characters (based on relationship, jobs and minor titles or even event targets)? I.e. one might want a 'throne room' ui element which shows the most important characters of the realm on one page.
It was supported after the first day showing that it was possible to have something, it picked up more support at the end of the second day after art made it look a lot prettier and it felt more like something we could actually use in game.

Toasts and notifications are often triggered by script effects, we send a couple from the code when it needs to happen regardless of if the script called it or the code did, but a lot of them are scripted.

You can make new interface elements which are children of another interface but not add brand new windows, you can work around that by adding the new windows as a child of the main hud window. I am looking at adding support for doing your own windows entirely but its not been a high priority as there is a work around for it and it only effects mods.
I really really like the added tooltips and Notifications and especially the Encyclopedia so two huge thumbs up from me!.

Lambert aint gonna be happy when he see's the fact you move around with W,A,S and D though lol.
I like the idea of having encyclopedia, thank you Paradox.