Hello Victorians, My name is Alex, Im a multiclass programmer and designer on Victoria 3 and today its finally time for another Dev Diary on this very happy Thursday! Today we will be taking a look at Diplomatic Treaties, one of the features arriving with the free 1.9 update on June 17 together with our Mechanics Pack Charters of Commerce. Before we begin though, I should mention that today is a public holiday (ig_tradeunions) for us here in Sweden (and in a lot of other places). This dev diary was as usual written ahead of time, but when it comes to questions, this means I wont actually be around to answer them when it comes out. Instead, Martin will be around to answer some of your more pressing questions to begin with and Ill try to answer any remaining important questions on Monday (as we also get tomorrow off as a bridge day). With all that said, I should also remind you that as always any values, texts, designs, graphics etc. are work in progress and are subject to change! But now, without further ado, enter Treaties:

Diplomatic Treaties

As part of the changes to the World Market we described in Dev Diary #143 and with Trade Routes as you know them going away, we wanted to introduce a new mechanic that let you actively establish pointed strategic ways of elevating your industries or exploiting other countries through trade. We wanted more ways for you to peacefully (but aggressively) compete against your rivals (and allies) and establish your dominance across the globe. Initially, this was drafted to be a relatively simple tit-for-tat deal: you give me grain, I give you coal. But we of course got thinking and, particularly in the context of how often the community asks for more in-depth diplomacy, we thought: what if we went a step or two (or twenty) further and made it a full-blown system of treaties where you can weigh a bunch of different types of things against each other? Maybe to get Prussia to agree to an alliance you can sweeten the deal by promising to give them a certain amount of weapons every week. Or maybe you can say youll pay off Haitis debts in exchange for them granting you investment rights. And well, thats what we did. Diplomatic Treaties are a new way for you to interact with other countries diplomatically. They are, in a way, a natural extension of what the diplomatic actions and pacts currently in the game do (more on that later), but instead of just having you propose one thing at a time in a vacuum, you can combine them and have the whole context of what you want be available and weighted together. Pedro had some aggressive negotiation tactics
In short, the way it works is like this: you decide you want a treaty with another country, so you open the Treaty Draft panel (shown in the animation above). You then select what articles youd like to have, both offers and requests. When youre happy you send the proposal to the other country. They can then look at what you have proposed and either accept or reject of course, but they can also choose to negotiate further. Negotiating further lets them tweak the proposal however they want and then send it back to you. This is then repeated until either you agree on a treaty or you decide to just end the process. Assuming you sign the treaty, it is now in effect and remains so until either side withdraws from it. A big crux on a system like this is of course how the AI handles it. We want to make sure that you cant just scam the AI, but we also want you to feel you are drafting clever treaties and making use of any advantages you might have. In particular, we also want to feed into the fantasy of you being able to draft clearly unequal treaties with other countries because maybe you are able to remind them that you have big boats and a big army next door. These are all goals we have in mind while working on the balancing of this feature. Before we go into the details of this a bit more though, I want to specifically address something I know will come up in the comments: are multilateral treaties possible? No. Making this system support multilateral treaties would be on a completely different level of complexity and would be a massive undertaking. If nothing else it would immensely complicate the UX and require a completely different way of tackling AI, drafting and all that. So, unfortunately, its not feasible. That is of course not to say that we dont want multilateral treaties (they would be super cool!) or that a system like that couldnt in the future build on treaties, but at least for now, its not something we are doing. Enough of that though, lets dive into the details.

Articles

This is the core part of treaties that actually defines what they do. Articles have a few different classifications. On a fundamental level, articles can be either Mutual or Directional. This mostly just indicates whether the article is something that affects both sides equally or not. A prime example of a mutual article is an Alliance: both sides are involved equally. On the other hand, Transfer Goods is an example of a Directional article: one side (the source) is sending the goods and the other (the target) is receiving them. The next important aspect of articles is Inputs. Some articles have required inputs and others do not. Again, an Alliance is just an Alliance, you dont need to define anything else, but for Transfer Goods you need to specify which goods you want to transfer and how many. Supporting Texas with some good ol ammo
Articles can have a number of different inputs depending on what theyre meant to do. What these inputs are actually used for differs and is up for the article to define. As for what articles you can expect to be in the game, a lot of them will be things we are moving over from the old diplomatic actions system. This includes of course Alliances and Defensive Pacts, but also e.g. State Transfer and Join Power Bloc and if you own Sphere of Influence, Investment Rights. For the majority of the articles that have counterparts as diplomatic actions, the corresponding diplomatic actions or pacts will be removed and Treaties will be the new way through which you access them. Do note that not all diplomatic actions have been made into articles, only the ones that made sense, this means that actions like Declare Rivalry or Improve Relations will still work as they used to. Weve taken the opportunity to rework Treaty Ports by turning them into an article instead of a consequence of geography. No Treaty, no Treaty Port! (Historical treaties arent setup yet, so ignore the date and binding time details)
In addition to those, we also have some completely new articles coming with 1.9. One of them Lino talked about on the previous Dev Diary DD #145: Military Access. That Dev Diary already went into detail on how Military Access works, so lets talk about the other new article coming with 1.9: Transit Rights. Whos gonna play Switzerland as their first run when 1.9 drops?
If Military Access lets you march your troops through another country, Transit Rights lets landlocked countries pass through a country to access the world market. This can be chained through multiple countries if needed. Switzerland stans can calm down.

Ending a Treaty

A Treaty ends when either side withdraws from the treaty. Easy. Of course, if you gave away Angola in exchange for Spain transferring you a certain amount of money every week, you want to make sure they actually follow through and you dont get scammed. This is where binding periods come in. When signing a treaty, you also define for how long that treaty will be binding (e.g. 5, 10, 15 years). When the binding duration for the treaty lapses, either side can end the treaty at any point without consequences. Were still looking at a few alternatives for how to pick the binding period. This is one, but it could also maybe be a slider?
You can still end a treaty before the binding period ends of course, but then you would be in breach of the treaty and subject to hefty penalties depending on the articles present in the treaty.

(Re)Negotiation

If you made some poor choices and a Treaty is really not good for you, you can attempt to renegotiate the treaty instead of just withdrawing from it. To do so, you select what treaty you want to renegotiate and simply click on the button. This will bring you to a flow similar to the original drafting panel, but instead of having a blank slate, the existing articles will be the baseline. From there you can add or remove articles, change inputs or even change the binding period. When youre happy, you send the proposal as usual and the other side has the opportunity to respond. If they agree, great, the old treaty is replaced with this new one. If they reject your offer though, the old treaty remains in force as it was. New Granada is starting to feel like maybe this wasnt such a good deal after all
It is worth noting though that some articles are not renegotiable. This mostly applies to articles that have some kind of immediate effect upon signing, like transferring a state, because you cant just undo that simply by changing the terms somewhat.

Non-fulfillment Consequences

Say you are playing as Belgium and you need paper, but dont feel like actually making it yourself. You could set up a treaty where you give the Netherlands some of your Sulfur and in exchange they give you some of the Paper they produce. They agree to this, but then for whatever reason, say a foreign power annexed their only paper mills, they are not able to produce the Paper they should deliver to you. This would likely lead to a shortage of Paper in the Dutch Market which would mean they are not able to deliver the Paper to you. In such a case, the Netherlands would be considered to be in non-fulfillment of their part of the Treaty.When that happens, generally one of two things will happen depending on what Article is not being fulfilled: if its a serious breach, like not answering the call of an Alliance, that will break the whole treaty and the party at fault will receive all the penalties tied to an early withdrawal if the treaty is still binding. For less serious breaches though, like with the example above, what happens is that the other side of the treaty will be inactive until the breach is addressed, at which point the treaty resumes as usual. In our example, if the Netherlands stopped delivering Paper because they had a shortage due to not producing it, Belgium would stop delivering Sulfur in return as well. This would then hold until the Paper deliveries resume. If there are any other articles on Belgiums side (including mutual articles) those are also inactivated for as long as the other side is in non-fulfillment. The side that isnt fulfilling one of their articles stays active though. Finally, Id like to note that not all articles will be non-fulfillable. For some articles like investment rights, you cant not fulfill it, it just happens anyway.

Obligations

As usual, you can call in obligations to make countries more likely to accept a treaty you propose. When it comes to how you get those obligations were making some changes though. Broadly speaking, you will be able to say you consider a certain treaty as essentially a favor to the other side. This will reduce their acceptance of the treaty, but in turn, if the binding period of the treaty lapses and everyone fulfills their parts it will grant you an obligation you can then use as usual. Signed treaties will take on different names depending on different circumstances. There will also be some historical treaties scripted in with their historical names. Additionally, you will also be able to give your treaties a custom name if you so wish. (shout out to Default Window Line Two)

Modding

As always we have made an active effort to keep this feature as moddable as possible. Many times when thinking about how to solve a certain problem we could see an easy solution which would just work within the assumptions of what we have planned to do with the feature and a more complicated solution where making things work on a more abstract level meant more combinations were possible for modders and as much as possible we chose the latter. As such, Id like to take a little bit of time to talk about what you can do with this system, primarily centered around modding articles. A lot of article modding is similar to diplomatic action modding: you can set AI weights, modifiers, effects, costs and so on. What is a bit different here with how articles work, is that you are also able to set if an article should be mutual or directional, but more importantly, you can have the article take any combination of the following inputs (although only one of each):

• Quantity
• Goods
• Building Type
• Law Type
• Strategic Region
• Country
• State
• Company

You can then reference these inputs in the immediate effect of the article to do whatever you want that can be done in an effect block. A little example of how flags and inputs are set in script on articles
There are of course some significant parts of articles that are hard coded, but we tried to make them flexible in that. For instance, most vanilla articles work by setting behavior flags. So Transfer Goods has an is_transfer_goods flag. This then tells the code what behavior it should call and makes it take in the expected inputs that is_transfer_goods requires. Theres also say is_investment_rights, or is_alliance. And the cool thing here is that you can actually to some degree combine these. So if you want to make an article that grants both military access and transit rights at the same time, you can do that. The main limitation here is if you have two flags that look at the same input type, they will have to use the same input. So combining transfer goods with no tariffs would necessarily both target the same input. Another cool thing you can do is mod the non-fulfillment conditions. You could for instance have a version of Transfer Goods that is only active while the countries are at peace or something and then if that is broken maybe youd want the treaty to auto-break or maybe you want it to freeze instead. Up to you.

Charters of Commerce

While everything I have described so far will be part of the free 1.9 update, the Mechanics Pack Charters of Commerce will also include a number of new articles exclusive to it:

• No Tariffs on Goods: The country is not allowed to set tariffs on a specific input good when trading with the World Market
• No Subventions on Goods: The country is not allowed to set subventions on a specific input good when trading with the World Market
• Prohibit trade of good with World Market: The country is not allowed to trade a specific input good with the World Market
• Law commitment: The country commits to passing a specific law. As long as they dont, their side is not fulfilled and the other side of the treaty is inactive
• Non-Colonization Agreement: The country is not allowed to colonize a specific strategic region
• Grant Monopoly to Foreign Company: Tune in to the next dev diary when Lino will talk more about this

Portugal would really like to be left alone with their colonies
[hr][/hr] I feel like there is something I forgot to mentionhmmm

Just one more thing

Theres one more thing Id like to show before we end this though. In addition to the flow Ive already explained above, theres another way Treaties can be used: Diplomatic Plays. In 1.9, as part of the free update, were adding a new war goal: Enforce Treaty Article. This war goal lets you select between a number of articles that are specifically classified (in script) as enforceable. You can select this war goal multiple times targeting different articles. Then, at the end of the war, all instances of the war goal against the same country will result in a War Reparations Treaty against that country. This treaty, being enforced, cannot be withdrawn from. What this means is that on a base level you can have war reparations work as they used to, but if you prefer, as part of war reparations you can instead demand getting investment rights in the country in question. Or you can prohibit them from trading weapons and artillery with the world market. Or you could mod some other article we havent thought about and do that instead. Or all of the above. Now youll have more ways in which you can make the Prussians pay
[hr][/hr] Alright, now that was actually all I had to show you today. I hope you are as excited about all this as I have been to tell you about it. Its been a whole journey to work on it and its awesome finally getting to share it with you all. Let me know what you think: are there any article combinations you are particularly excited about? And for the modders out there, have the modding gears started turning already? Im very much looking forward to seeing what clever treaties you all come up with and hearing about all the backstabbing in MP when 1.9 releases on June 17. Before that though, Lino will be back in two weeks to tell you some more about what we have been cooking with Companies and Executives. Until then!

[ 2025-05-01 14:01:23 CET ] [ Original post ]