The docs are wildly confusing and seemingly neglected: Seems that there's both a v1 and v2 version of matchmaking, where 2 years later the docs still aren't updated (?!) and intermingling words of the old one (such as using the term game mode) with the new.
In my Matchmake() calls, I keep getting an error that my "game mode" is invalid, but there is no game mode in v2. This led me to believe I have v1. However, staff in Discord linked v2 docs that linked to an example API doc that... is what I implemented and allegedly deprecated (and now is being called both v1 and v2 in a paradoxical manner).
There is also a "Matchmaker" API and a "Multiplayer Matchmaking" API in both the docs and unreal SDK, to add to the confusion:
If this wasn't confusing enough, there's more. Within the API doc link ago, if you go back to that section's summary page, you will see [Un]Subscribe calls for PubSub:
...However, there is no further documentation about how to actually use these [in Unreal SDK or any]. In fact, if I search the Unreal SDK for keywords, there's not a single instance of PubSub
or Subscribe
in the entire SDK!
Then if you search the docs for PubSub, we find this.
5414-image.png
Now, here we can see the summary of how PubSub works:
...wait, no we cannot because there's no summary here! Not a single description. Perhaps the related links would guide us in how to use pubsub for matchmaking, since it's referenced in the multiplayer matchmaking module?
Nope, not here, either.
While trying to sift through the forums here, the Microsoft Discord and the BaaS Discord -- I find that everyone is confused and no one seems to truly have an answer. The closest thing I got to an answer was link to the v2 matchmaking docs earlier, but again that linked to another deprecated API call that results in "invalid game mode" errors (game mode doesn't exist in v2, meaning the v2 docs still intermingle with v1 docs); just a giant wild goose chase of deprecated documentation.
Is there any staff here that can verbosely explain which is new, which is old, what the diff is between the "matchmaker" api and "multiplayer api matchmaking calls" (where one of these seems to be deprecated), what is deprecated and what is not, how to setup pubsub [ue4] and interact with these -- just things that the scattered docs don't seem to actually explain?