Skip to content

Matchmaking management

Start matchmaking

Go to the [Matchmaking > Matchmaking Management] menu in the console.

  1. Select the project you want to add matchmaking to and click the Start Button to create a matchmaking.

    Note

    If there is no project to set, check whether a project has been created by going to [App Center > Manage Project]. Matchmaking search is only possible when the project status is [In Development] or [Live].

  2. Enter basic information in the New Matchmaking screen when you first create a matchmaking in your project.

    • Match Linkage Method: Defines how the project will initiate match requests.
      • SDK: Select this option if you want to send match requests using Hive SDK.
      • Server Callback: Choose this option if you want to send match requests directly through the matchmaking server’s API.
    • Match Callback URL: Address to receive matchmaking results. Registration is required only if the matchmaking integration method is set to Server Callback.
    • Matchmaking Name: A name to identify the matchmaking in the console.

  3. Select a matchmaking option on the New Matchmaking Screen.

    • Matchmaking Method: Select the user matchmaking algorithm. If you select the score method, users with similar scores will be matched, and if you select random, users will be matched randomly regardless of their ability.

    • Matchmaking Unit/People: Select whether it is team matchmaking or individual matchmaking. For team matchmaking, you can choose the number of teams, and each team will always have the same number of members. The maximum number of teams is 4, and the total number of participants cannot exceed 16.

      • Maximum number of teams example: Number of teams: 4 / Number of members in each team: 2
      • Maximum number of team members example: Number of teams: 2 / Number of members in each team: 8

    • Matchmaking Attempt Time : If the number of matchmaking is not met, users are searched during the matchmaking attempt time.

    • Receive Matchmaking Results

      • Receive results only when the matchmaking amount condition is met : User information is sent along with whether the matchmaking was successful only when the matchmaking is completed within the attempt time.
      • Receive results even if the matchmaking amount condition is not met : Even if the number of matchmaking is not met by the time the attempt time elapses, results including information on users who have been matched to date will be delivered.

    • Enter the matchmaking range information if your matchmaking method is set to score.

      • Matchmaking Range
        • If a matchmaking target is not found, the score range is expanded by the matchmaking increase/decrease value each time the matchmaking increase/decrease time passes.
        • Matchmaking Range Expansion Time < Total Matchmaking Attempt Time
        • Matchmaking Range Increase/Decrease Value < Maximum Matchmaking Range Value
      • Maximum Matchmaking Range
        • Enter the score range to be used when matching the users. For example, entering 100 expands the search to only +-100 points from the requested score.

  4. When settings are complete, click ‘Save’.

  5. Refer to the API Guide to call the matchmaking information.

Matchmaking list

Please select a project to manage matchmaking.
Matchmaking connection information is displayed under the selected project if a matchmaking is registered in a project.

  1. Match Linkage Method: Defines how the project will initiate match requests.
    • SDK: Select this option if you want to send match requests using Hive SDK.
    • Server Callback: Choose this option if you want to send match requests directly through the matchmaking server’s API. This requires you to register the Match Callback URL and the Match Callback Secret Key.
  2. Match Callback URL: The address where match results will be sent. This is only needed if using the Server Callback method.
  3. Match Callback Secret Key: A required value generated automatically for secure communication with the matchmaking server. To update or regenerate the key, click the Refresh button.

Create matchmaking

You can add matchmaking settings with the New Matchmaking Button. You can register multiple matchmakings in one project.

Edit matchmaking

All items except the matchmaking method, matchmaking unit, and score criteria can be modified. Changed information is reflected in matchmaking in real-time.

Delete matchmaking

On the matchmaking list, select the matchmaking you want to delete and click the Delete Button.