关卡文件

自定义关卡

《PvZ2 Gardendless》游戏的自定义关卡文件与原版类似，是一个以.json或.json5为后缀的 JSON/JSON5 文本文件，其中包含了关卡的所有信息，包括植物、僵尸、地形等。相比原版，《PvZ2 Gardendless》的关卡文件增加了一些新的字段，来描述该关卡的基本信息。

JSON 与 JSON5

对象用 {}、数组用 []，字段以键值对表示。.json 的键和字符串必须用双引号，不支持注释或末尾逗号；需要这些写法时使用 .json5 后缀。下面保留关卡字段示例，按实际游戏数据填写。

关卡文件结构

《PvZ2 Gardendless》的关卡文件结构如下：

{
  // 关卡的标题
  "#comment": "Sample Level",
  // 关卡的基本信息
  "Information": {},
  "objects": [
    // 关卡设置的列表
    {},
    {}
  ],
  "version": 1
}

#comment字段为关卡的标题，在编写关卡时，请确定您关卡的标题唯一且不重复。version字段固定为 1。其它字段的详细说明见下文。

Information 字段

《PvZ2 Gardendless》增加了Information顶级字段，用于描述关卡的基本信息。该字段并不会影响自定义关卡在游戏内的功能，但能够帮助玩家快速了解您编写的关卡的信息。

这个字段包含了以下内容：

"Information": {
  // 关卡的UUID
  "uuid": "c58a208a-a5e3-4cfa-9bc3-cc7fbb08c2e3",
  // 关卡名称
  "name": {
      "en": "SampleLevel I",
      "zh-CN": "示例关卡1"
  },
  // 关卡的作者
  "Author": "LMYY",
  // 可选，作者的链接
  "AuthorLink": "https://github.com/Gzh0821",
  // 关卡的描述
  "Introduction": {
      "en": "This is a sample level.",
      "zh-CN": "这是一个示例关卡。"
  },
  // 关卡支持的游戏版本
  "GameVersion": "0.1.1",
  // 关卡的版本
  "Version": "1.0",
  // 关卡的创建时间
  "CreatedAt": "2022-03-08",
  // 关卡的更新时间
  "UpdatedAt": "2022-03-08",
  // 关卡的难度，可选值有：Easy, Normal, Hard, Expert
  "Difficulty": "Easy",
  // 关卡的分类
  "Category": "Survival"
},

uuid是关卡的唯一标识，用于区分不同的关卡。请确保您的关卡uuid的唯一性。要获取随机的uuid，可以使用在线生成工具，如UUID Generator。

objects 字段

objects 是一个列表，其元素为每一个具体的关卡设置。列表里面有多个对象，每个对象对应着一个配置项，下面是一个 objects 列表的示例：

"objects": [
  {
    // 配置项：关卡的基本设置
    "objclass": "LevelDefinition",
    // 关卡的基本设置
    "objdata": {
      // 关卡的描述
      "Description": "~",
      // 关卡的编号，用于系列关卡中
      "LevelNumber": 1,
      // 保持默认即可
      "Loot": "RTID(DefaultLoot@LevelModules)",
      // 关卡的玩法模式，给出的是基本玩法模式。
      "Modules": [
        "RTID(ZombiesDeadWinCon@LevelModules)",
        "RTID(DefaultZombieWinCondition@LevelModules)",
        "RTID(NewWaves@CurrentLevel)",
        "RTID(SeedBank@CurrentLevel)"
      ],
      // 显示在游戏内的关卡名
      "Name": "Bank theft 1",
      // 可选：多语言支持
      "NameMultiLanguage": {
        "en": "Bank theft I",
        "zh": "银行失窃I"
      },
      // 作者，建议与Author一致
      "WritenBy": "保罗_刘",
      // 目前无用：掉落相关
      "NormalPresentTable": "egypt_normal_01",
      "ShinyPresentTable": "egypt_shiny_01",
      // 关卡的场景，格式为:RTID(世界名Stage@LevelModules)
      "StageModule": "RTID(TutorialStage@LevelModules)"
    }
  },
  // 每个玩法模式的配置:
  {
    "aliases": [
      "SeedBank"
    ],
    "objclass": "SeedBankProperties",
    "objdata": {
      "PresetPlantList": [
        {
          "Level": -1,
          "PlantType": "peashooter"
        }
      ],
      "SelectionMethod": "chooser"
    }
  },
  {
    "aliases": [
      "NewWaves"
    ],
    "objclass": "WaveManagerModuleProperties",
    "objdata": {
      "WaveManagerProps": "RTID(WaveManagerProps@CurrentLevel)"
    }
  },
  {
    "aliases": [
      "WaveManagerProps"
    ],
    "objclass": "WaveManagerProperties",
    "objdata": {
      "FlagWaveInterval": 1,
      "WaveCount": 1,
      "Waves": [
        [
          "RTID(Wave1@CurrentLevel)"
        ]
      ]
    }
  },
  {
    "aliases": [
      "Wave1"
    ],
    "objclass": "SpawnZombiesJitteredWaveActionProps",
    "objdata": {
      "AdditionalPlantfood": 0,
      "Zombies": [
        {
          "Type": "RTID(tutorial@ZombieTypes)"
        }
      ]
    }
  }
]