Table of Contents:

1. Difficulty


2. Difficulty Calculation for Job Offers (mBase.ini)


3. Amount of NPCs created by Difficulty and NPC Level (npcranktodiff.ini)


4. Requirements to have Missions offered on a Base


5. Payment by Difficulty (diff2money.ini)

Difficulty

A basic requirement and variable for random missions is the Difficulty. It is an arbitrary decimal number in a range of [0, 100] (meaning 0 and 100 are included).

If needed the maximum difficulty can be adjusted by those offsets:
(Source, adoxa)



Difficulty Calculation for Job Offers (mBase.ini)

A key to understand how Difficulty works is the way how it is used and calculated. This is unfortunately not very easy to understand at first.
The main use is within mBase.ini where the values are set which difficulty a player can get from a base or NPC.

The difficulty number displayed in-game when reading a mission offer has a somewhat direct connection to the chosen technical difficulty behind. Apparently those in-game numbers are hard-coded somewhere for specific difficulty values.

Commonly the mission_type parameter can be understood as:

The weight is an arbitrary value, used relative to the sum of weights given. E.g. having one faction offer missions with weight=1, and another faction offering with weight=2 makes the second faction's missions appear in 2 out of 3 cases.

minDiff and maxDiff are important for the calculation of the real Difficulty that will be available for the player. Especially important is to note that maxDiff is not necessarily really the maximum.
The calculations are as follows:

Single Player


Multi Player
(Source, adoxa)

Looking especially on the first part of the multiplayer-specific calculation shows that maxDiff is not a constant value, but is getting multiplied by a random factor. This can make multiplayer missions go beyond the naively intended levels.

To understand the influence of the minDiff and maxDiff values in those calculations I do recommend to look on a graph plot for some simple values.
As an example in multiplayer when minDiff is 0 and maxDiff is 1 in the final calculation, the graph looks like this
If minDiff and maxDiff are swapped interesting results like this can be achieved. In those plots the left axis shows the probability to get the mission, whereas the lower axis shows the difficulty level to get.

To limit the difficulty in multiplayer between the minDiff and maxDiff value, the following patch can be applied on Content.dll using bwpatchw.
(Source, adoxa)



Amount of NPCs created by Difficulty and NPC Level (npcranktodiff.ini)

It is possible to define exactly how many NPCs of a specific level are being created for a specific Difficulty. This is handled within the npcranktodiff.ini.

A line looks as follows:

Important to note:

• Only exactly one line of NpcRank is picked for the spawn per wave in a job.


• The amount of spawned ships is determined by the highest Difficulty in that line (e.g. if Difficulty is 5 and the 3rd ship column is 5, then 3 ships get spawned).


• By default the game can handle up to 8 ships per line. To allow for more, see the following.

The game uses a table of weights to define a preference for the amount of ships being spawned. It is as follows:
(Source, adoxa)
The weights here are again relative to their sum. E.g. in multiplayer the sum is 27, so 4 ships get spawned in 9 out of 27 cases (33.3%). As you can see, 1 ship has weight of 0. This means the game never will pick an NpcRank where the Difficulty for only the first ship would match.
This table is very important to keep in mind. At any Difficulty picked, there always should be NpcRanks defined that cover all those ship counts.
If you notice your job-board being more empty than it should be, it could be that the game tries to pick a ship count which is not provided for the current Difficulty.

This table can be adjusted at the offset 11CC58 in Content.dll. First are the weights for singleplayer (starting for 0 ships, 1 ship, 2 ships, etc.) and after that for multiplayer (also starting for 0 ships, 1 ship, ...).

If you want to allow NpcRanks with more than 8 ships being spawned, you must create your own weight-table.
(Source, adoxa)



Requirements to have Missions offered on a Base

There are 4 requirements that must be met to have a mission of a specific Difficulty being offered to a player:

• The enemy faction must have an NPC spawn of any unrelated level/difficulty within at least one mission vignette zone in the system.


• The enemy faction must have at least one NpcShip from npcships.ini assigned via faction_prop.ini that must have the same level as any Difficulty-matching NpcRank, and have npc_class class_fighter.


• The enemy faction must have at least one NpcShip from npcships.ini assigned via faction_prop.ini that must have the matching npc_class diff-label + class_fighter for the matching NpcRank. And this NpcShip must have a level matching +-1.


• There must be at least one NpcRank that can spawn ships within the picked Difficulty range.

This sounds quite daunting, so let's explain this on an example:

We want to have some faction offer missions against fc_lr_grp in our system. For this we at first need a mission zone:


Now we must make sure the enemy spawns within this zone, so it will get selected by the game to be associated with this enemy faction.


Now we must find out which Difficulty our mission may have. For this we check in our mBase.ini:


With this value we now go into our npcranktodiff.ini file and look which line might match. Keep in mind the game has certain weights on how many ships it prefers to spawn (see above chapter). One of the possible NpcRanks might be:


With this we know that we want to spawn level 1 NPCs.
Now we must make sure fc_lr_grp has at least one ship matching this with an npc_class of class_fighter:

We see that the level=d1, matching our NpcRank. And we see the npc_class contains d1 and class_fighter, so it also can spawn the ship.
Important to know is that one ship with the required level must exist. But it does not need to be the same ship that is being spawned.
The ships that will be spawned are determined by their matching npc_class label. Meaning that if your ship has d1, but npc_class d100, it will not be spawned.
You can and must have at least one (but it can be another) ship with a matching npc_class diff-label for d1, and class_fighter. Important here is that whatever ship has the matching npc_class must match the level +1.
So we could say we have a level d2 ship with npc_class=diff1, class_fighter, it would be able to be spawned. But only if there is another ship defined somewhere that has level=d1. This may look like this and still get spawned in our d1 mission:




Payment by Difficulty (diff2money.ini)

Defining payments for specific Difficulties is very easy and straight-forward to be done in diff2money.ini.
A line looks as follows:

You can add as many or as few of those lines as you like. The payments between each defined Difficulty are linearly interpolated. You should at least provide a line for Difficulty 0 and 100 to allow the game to compute any payments between.

It's relative to the sum. Seemingly Freelancer devs chose to express it as a percentage, but any value can be used. E.g. three missions each with a weight of 1 means any is equally likely (one in three); three missions with weights of 1, 2 and 3 means the first is unlikely (one in six), the second is less likely (one in three [2/6]) and the third is likely (half [3/6]).

Thanks for clarifying that. Also, hello from a fellow QLDer, haha. Small world (universe?).