Skip to content

Overlapping Affinities

Kaiconure edited this page Oct 31, 2025 · 3 revisions

Intdocution

WindowerLauncher v1.0.7.0 introduced the concept of overlapping processor affinities. It also added the coremap or cm mode that lets you preview exactly how your CPU cores would be assigned.

Be sure you've read through the Processor Affinity for Multiboxers wiki if you want some context on how overlapping extends the base affinity configuration.

Quick Start

If you don't want to understand how it works or how to tweak it, here's the recommendation for anyone running six toons on a system with at least 16 virtual cores. Follow the Processor Affinity for Multiboxers instructions, but use the following settings instead.

Main set of four toons

For your main profile:

wl run -name:Main -count:4 -core:2 -ncore:4 -overlap:2

Secondary set of two toons

For your secondary profile:

wl run -name:Secondary -count:2 -core:10 -ncore:4 -overlap:2 -verbose 

How it works

You're already familiar with the -core:<number> and -ncore:<count> options. As a refresh, -core allows you to set the first core that will be assigned to a toon and -ncore sets the number of cores that will be assigned to each toon.

The -overlap:<number> option controls how WL advances the core assignment cursor when moving from one toon to the next. Mathematically speaking, a simplified expression of how this works would look something like this:

  next_toon_core = current_toon_core + (ncore - overlap)

As you can see, an overlap of 0 (the default) results in the exact behavior that existed before this feature was introduced.

Let's look at this in practice. Let's run two toons, with 4 cores each, and an overlap value of 2. The new core map (cm) command let's us preview the result:

wl cm -count:2 -core:2 -ncore:4 -overlap:2 -verbose

The output should look something like this:

Core map with two toons

 

Note: The "Core allocations:" section is only shown with the optional -verbose command line switch.

As you can see, the first toon has access to cores 2, 3, 4, and 5. The second toon has access to cores 4, 5, 6, and 7. They share cores 4 and 5, which makes sense since we called for an overlap value of 2.

We can try this with a more advanced setup. Four toons, with the same core count and overlap. All we'll do is change -count:2 to -count:4 as follows:

wl cm -count:4 -core:2 -ncore:4 -overlap:2 -verbose
Core map with four toons

 

If you wanted to launch another two toons to round out your party of six, you'd probably run something like this next:

wl cm -count:2 -core:10 -ncore:4 -overlap:2 -verbose
Core map for our last two toons

 

This starts on core 10, since 10 and 11 are where the last toon from our first set left off.

Conclusion

This is a somewhat advanced feature, but it's not too hard to understand once you get it set up.

Clone this wiki locally