• 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!

tutorial_pick.png


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.

tutorial_in_game.png


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!

tutorial_popup.png


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

tooltip_in_tooltip.png


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.

tooltips_4_days.png


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.

reactive_advice.png


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.

alert.png


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.

issues.png


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.

notifications.gif


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.

toasts.gif


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.

encyclopedia.png


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:

first_iter_encycloepdia.png


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:

second_iter_encycloepdia.png


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
Reactions:
tooltip_in_tooltip.png

That confirms there is no marquis nor grand duke rank, shame! I mean, CK2 added emperor-tier, so you'd think a next installment would add another, but I guess not...
Well, I suppose you'll still be able to be a "grand duke" by holding more than one duchy title, as in CK2. As for the Marquis title... maybe if you're a count and your capital is at the realm's border, your liege can designate your land as a March? And then that changes your title name (though not your tier)? Pretty please, Paradox?
 
Last edited:
View attachment 550256

Whoever decided this was a good idea needs a right good slap. W is the political mapmode.... not moving around the damn map. This ain't a first person shooter >.<

It is also a feature I rationally hate in Imperator.
I, for one appreciate not having to have my arm sprawled across my keyboard to the arrow keys when I want to move the map while clicking on something.
 
The first thing I see is the screenshot with WASD -- without any indication these can be altered. To my delight the first comment is about rebinding, but then I notice it has been 6x disagreed. Please explain, what the hell is wrong with you people?

It is about time the devs add a keyboard configuration tab to the settings. If "better interaction with hotkeys" means it will be integrated, than I am glad.

On the same note, WASD is the most stupid standard ever, only intended for small handed people who can't reach the modifier keys from the home row.

But will there be re-bindable keyboard shortcuts?

WASD to move around the map. A dream come true!
 
Looking at Ireland on the screenshot I count 12 counties with perhaps 1 or 2 obscured by the tutorial window. Is province count also still under development. I'd be a bit disappointed if CK3 starts with the province density CK2 had at launch. I've gotten used to 19-county Ireland, I don't wanna go back to 13.
Unfortunately, that seems to confirm what was already noted about Southern Italy.
I find this one of the most disappointing issues with the new game (together with fixed baronies), and I sincerely hope this is just WIP map.

On the tool tips, I like them in principle, but how easy will it be to click a second or third tier link without unadvertingly putting the mouse out of the tool tip frame, thus closing it? And when it is tied to time, I am also concerned that the showtime will be too short - thus forcing players to activate the tool tip more than once (pretty annoying for se on-tier tool tips) - or too long - thus interrupting the game...
 
On the WASD issue, I personally am not a big user of hot keys and I just learnt you could control the map types even though I've had my hours of play with PDX games and CK.

But I welcome the addition because it may help those using a nonstandard keyboard (e.g. When playing Shadow on an Android) that does not ha e arrow.

That said, I agree that the best way (and a good rule of thumb when you deal with easily customisable things) would be to allow custom keyboard mapping so that anybody can arrange it as it best suits their needs
 
Great, this is good.. Though, I'd rather hear about something more, well, interesting. The skill-trees almost killed my little hype I had going and this doesn't add to it.
 
I like WASD, but please tell me I can still middle-pan.

(And thank you for allowing us to disable edge scrolling, now go apply that to your other games.)
 
This should be the new "minimum" QoL all paradox releases in the future have to follow, it is such big improvement that the question is why we have not had this sooner?

Rather delay the games and make them good instead of releasing stuff like Imperator: Rome, it did not pay of from what I can tell with a player Count similar to Victoria 2 after several patches.
 
The first thing I see is the screenshot with WASD -- without any indication these can be altered. To my delight the first comment is about rebinding, but then I notice it has been 6x disagreed. Please explain, what the hell is wrong with you people?

It is about time the devs add a keyboard configuration tab to the settings. If "better interaction with hotkeys" means it will be integrated, than I am glad.

On the same note, WASD is the most stupid standard ever, only intended for small handed people who can't reach the modifier keys from the home row.
I really dont understand a lot of people here on the Paradox forums either, sometimes they dont want people to have even the option of doing stuff a different way.. I cant really wrap my head around it other that that there are a lot of very conservative people here, who fights change like the Inquisition. Even when that change is just an alternative to what is already there.

Let people bind their keys however they want, it wont bother anyone.
 
The first thing I see is the screenshot with WASD -- without any indication these can be altered. To my delight the first comment is about rebinding, but then I notice it has been 6x disagreed. Please explain, what the hell is wrong with you people?
IMO, the disagrees have to do more with the "first" thing than with the bindable keys
But will there be re-bindable keyboard shortcuts?

Also first.
 
Last edited:
This looks gorgeous, and I can't tell you how important that is for CK games as a player. This is all the foundation you guys are going to build (hopefully) years of great CK3 content on, I'm glad the aim is to do it right and make it easy to understand. Maybe I'll even be able to get some more friends to try it out!
 
Axis, this is exactly what everybody wants. And no Paradox game to date has hotkey settings.
We don't have an alternative, when it comes to the keyboard (unless we use Autohotkey)
Yeah it is quite ridiculous. They have been making games for a looooong time now, and their games could have enjoyed key binding customization since forever.
Which makes me think about animations and specs. I have a powerful gaming computer and welcome better graphics and animations etc, but in options it wouldnt hurt to be able to turn off animations, and downscale graphics if your computer is a bit dated or not a powehouse computer.