MATCHMAKE_UNHANDLED error has occurred

5min
If MATCHMAKE_UNHANDLED error occurs during QR test, try the method below to solve it.
﻿
﻿
Please check the Multiplay server script (index.ts).
This error code may occur when the client does not smoothly receive Multiplay Room State data from the server after connecting to multiplay server.
Refer to the tutorial below and check the code in the onCreate/onJoin part of the server script (index.ts).
📘 Please refer to the following guide. ZEPETO Multiplay Tutorial﻿ 
﻿
Please update the ZEPETO WORLD SDK version to the latest version.
Refer to the guide below to check if the ZEPETO WORLD SDK version is up to date, and then update to the latest version.
📘 Please refer to the following guide. Updating Package﻿ 
﻿
Please check the Zepeto World Multiplay component.
This error might occur if Zepeto World Multiplay components are present in different scenes.
Add the Zepeto World Multiplay component to just one scene and follow the example code below to implement it as a singleton.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
 
export default class MultiplayComponent extends ZepetoScriptBehaviour {
 
    private static _instance: MultiplayComponent = null;
    public static get instance(): MultiplayComponent {
 
        // If an instance hasn't been created yet, perform the following logic.
        if (this._instance === null) {
 
            // Search for an instance of type MultiplayComponent within the scene.
            this._instance = GameObject.FindObjectOfType<MultiplayComponent>();
 
            // If no MultiplayComponent instance is found in the scene, perform the following logic.
            if (this._instance === null) {
                this._instance = new GameObject(MultiplayComponent.name).AddComponent<MultiplayComponent>();
            }
        }
        return this._instance;
    }
 
    private Awake() {
        // If another instance already exists and the current instance is different, execute the following logic.
        if (MultiplayComponent._instance !== null && MultiplayComponent._instance !== this) {
 
            // Destroy the current GameObject (with the current instance) to prevent duplicate instance creation.
            GameObject.Destroy(this.gameObject);
 
        // If no other instance exists or the current instance is the same, execute the following logic.
        } else {
            MultiplayComponent._instance = this;
            GameObject.DontDestroyOnLoad(this.gameObject);
        }
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
 
export default class MultiplayComponent extends ZepetoScriptBehaviour {
 
    private static _instance: MultiplayComponent = null;
    public static get instance(): MultiplayComponent {
 
        // If an instance hasn't been created yet, perform the following logic.
        if (this._instance === null) {
 
            // Search for an instance of type MultiplayComponent within the scene.
            this._instance = GameObject.FindObjectOfType<MultiplayComponent>();
 
            // If no MultiplayComponent instance is found in the scene, perform the following logic.
            if (this._instance === null) {
                this._instance = new GameObject(MultiplayComponent.name).AddComponent<MultiplayComponent>();
            }
        }
        return this._instance;
    }
 
    private Awake() {
        // If another instance already exists and the current instance is different, execute the following logic.
        if (MultiplayComponent._instance !== null && MultiplayComponent._instance !== this) {
 
            // Destroy the current GameObject (with the current instance) to prevent duplicate instance creation.
            GameObject.Destroy(this.gameObject);
 
        // If no other instance exists or the current instance is the same, execute the following logic.
        } else {
            MultiplayComponent._instance = this;
            GameObject.DontDestroyOnLoad(this.gameObject);
        }
    }
}
﻿
﻿
Updated 10 Oct 2024
Did this page help you?
VSCode auto-completion function does not work properly
Typescript Compiler is not working properly.