{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/quantifying-zero-shot-coordination-capability","title":"ZSC-Eval: An Evaluation Toolkit and Benchmark for Multi-agent Zero-shot Coordination","arxiv_id":"2310.05208","date":"2023-10-08","proceeding":null,"authors":["Xihuai Wang","Shao Zhang","WenHao Zhang","Wentao Dong","Jingxiao Chen","Ying Wen","Weinan Zhang"],"abstract":"Zero-shot coordination (ZSC) is a new cooperative multi-agent reinforcement learning (MARL) challenge that aims to train an ego agent to work with diverse, unseen partners during deployment. The significant difference between the deployment-time partners' distribution and the training partners' distribution determined by the training algorithm makes ZSC a unique out-of-distribution (OOD) generalization challenge. The potential distribution gap between evaluation and deployment-time partners leads to inadequate evaluation, which is exacerbated by the lack of appropriate evaluation metrics. In this paper, we present ZSC-Eval, the first evaluation toolkit and benchmark for ZSC algorithms. ZSC-Eval consists of: 1) Generation of evaluation partner candidates through behavior-preferring rewards to approximate deployment-time partners' distribution; 2) Selection of evaluation partners by Best-Response Diversity (BR-Div); 3) Measurement of generalization performance with various evaluation partners via the Best-Response Proximity (BR-Prox) metric. We use ZSC-Eval to benchmark ZSC algorithms in Overcooked and Google Research Football environments and get novel empirical findings. We also conduct a human experiment of current ZSC algorithms to verify the ZSC-Eval's consistency with human evaluation. ZSC-Eval is now available at https://github.com/sjtu-marl/ZSC-Eval.","url_abs":"https://arxiv.org/abs/2310.05208v3","url_pdf":"https://arxiv.org/pdf/2310.05208v3.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"quantifying-zero-shot-coordination-capability","repo_url":"https://github.com/HumanCompatibleAI/overcooked_ai","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"none","reach":{"status":"ok","spdx":"MIT"}},{"paper_slug":"quantifying-zero-shot-coordination-capability","repo_url":"https://github.com/sjtu-marl/zsc-eval","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}}],"tasks":[{"task_slug":"diversity","task_name":"Diversity"},{"task_slug":"multi-agent-reinforcement-learning","task_name":"Multi-agent Reinforcement Learning"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2310.05208","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2310.05208"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"provenance":"deterministic:regex_extraction","url":"https://github.com/sjtu-marl/ZSC-Eval","reach":{"status":"ok","spdx":"MIT"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/sjtu-marl/zsc-eval","reach":{"status":"ok","spdx":"MIT"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/HumanCompatibleAI/overcooked_ai","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"ran":7,"unverified":2},"by_repo_kind":{"official":{"samples":9,"ran":7,"repositories":2}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":0,"samples":[{"code_sha256_prefix":"df03d7c6bdd59e3e","entry":"DEFAILT_PARAMS_SCHEDULE_FN","repo":"HumanCompatibleAI/overcooked_ai","repo_kind":"official","path":"src/overcooked_ai_py/mdp/layout_generator.py","file_url":"https://github.com/HumanCompatibleAI/overcooked_ai/blob/HEAD/src/overcooked_ai_py/mdp/layout_generator.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"df03d7c6bdd59e3e"}},{"code_sha256_prefix":"b164bf4f4d2ab309","entry":"append_trajectories","repo":"HumanCompatibleAI/overcooked_ai","repo_kind":"official","path":"src/overcooked_ai_py/mdp/overcooked_trajectory.py","file_url":"https://github.com/HumanCompatibleAI/overcooked_ai/blob/HEAD/src/overcooked_ai_py/mdp/overcooked_trajectory.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"b164bf4f4d2ab309"}},{"code_sha256_prefix":"591c3a0919cdc129","entry":"load_dict_from_file","repo":"HumanCompatibleAI/overcooked_ai","repo_kind":"official","path":"src/overcooked_ai_py/utils.py","file_url":"https://github.com/HumanCompatibleAI/overcooked_ai/blob/HEAD/src/overcooked_ai_py/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"591c3a0919cdc129"}},{"code_sha256_prefix":"1db1eb104270f970","entry":"load_dict_from_txt","repo":"HumanCompatibleAI/overcooked_ai","repo_kind":"official","path":"src/overcooked_ai_py/utils.py","file_url":"https://github.com/HumanCompatibleAI/overcooked_ai/blob/HEAD/src/overcooked_ai_py/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"1db1eb104270f970"}},{"code_sha256_prefix":"acf181c97884d450","entry":"load_pickle","repo":"HumanCompatibleAI/overcooked_ai","repo_kind":"official","path":"src/overcooked_ai_py/utils.py","file_url":"https://github.com/HumanCompatibleAI/overcooked_ai/blob/HEAD/src/overcooked_ai_py/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"acf181c97884d450"}},{"code_sha256_prefix":"b682a7f9694b60ea","entry":"mdp_fn_random_choice","repo":"HumanCompatibleAI/overcooked_ai","repo_kind":"official","path":"src/overcooked_ai_py/mdp/layout_generator.py","file_url":"https://github.com/HumanCompatibleAI/overcooked_ai/blob/HEAD/src/overcooked_ai_py/mdp/layout_generator.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"b682a7f9694b60ea"}},{"code_sha256_prefix":"751a21653dbe3c07","entry":"scientific_notation","repo":"sjtu-marl/ZSC-Eval","repo_kind":"official","path":"zsceval/config.py","file_url":"https://github.com/sjtu-marl/ZSC-Eval/blob/HEAD/zsceval/config.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"751a21653dbe3c07"}},{"code_sha256_prefix":"57efc99646843520","entry":"add_path_prefix","repo":"sjtu-marl/ZSC-Eval","repo_kind":"official","path":"zsceval/algorithms/population/policy_pool.py","file_url":"https://github.com/sjtu-marl/ZSC-Eval/blob/HEAD/zsceval/algorithms/population/policy_pool.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"57efc99646843520"}},{"code_sha256_prefix":"3b9bb888eab52d5e","entry":"get_grf_args","repo":"sjtu-marl/ZSC-Eval","repo_kind":"official","path":"zsceval/grf_config.py","file_url":"https://github.com/sjtu-marl/ZSC-Eval/blob/HEAD/zsceval/grf_config.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"3b9bb888eab52d5e"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}