教育文件

教育文件（Education File）是文件名均为education.json的特殊数据驱动文件，根据放置位置和用途，分为教育元数据文件（Education Metadata File）和教育设置文件（Education Settings File）两种类型。

教育元数据文件

教育元数据文件位于世界模板或附加包的根目录，当清单文件的has_education_metadata字段为true时被游戏读取，用于向教育版游戏展示该包的课程信息，包括预计时长、描述、目标、任务和指导等。

• wt 世界模板
  • education.json

结构

• ：根对象（根对象在引擎内部的键名为edu_metadata，该键名仅在报错信息中出现，文件中不需要也不能填写该键名，应直接编写对象内容）。
  • type：课程类型，可选"world"（世界课程）或"non_world"（非世界课程）。
  • *content：课程具体内容对象。
    • *estimated_time：预计完成该课程所需时间，单位为分钟。
    • *description：课程描述文本。
    • goals：课程目标文本。
    • tasks：课程任务列表，每个元素为一个字符串。
    • instructions：课程指导列表，每个元素为一个字符串。
    • link_to_more：指向更多相关资源的链接URL。
    • *order：该课程在课程序列中的排列序数。
    • role：该课程适用的身份，可选"student_and_teacher"（学生与教师）或"teacher"（仅教师）。

教育设置文件

教育设置文件位于存档（游戏存档目录）的根目录，用于配置该存档内特定教育版功能的行为，包括代码构建器（Code Builder）的连接地址和显示标题、外部链接、摄像机（Camera）方块的视觉设置以及命令的可见性限制等。

结构

• ：根对象。
  • codebuilder：代码构建器的设置。
    • *defaulturi：代码构建器打开时默认加载的URI地址。
    • *title：代码构建器界面标题文字。
    • :json-field-bool:canResize：是否允许用户调整代码构建器窗口的大小，默认为true。
    • :json-field-bool:disableLegacyTitleBar：是否禁用旧版标题栏。
    • capabilities：附加功能权限配置。
      • agent：代理（Agent）相关权限。
        • permissions：权限详情。
          • :json-field-bool:canModifyBlocks：是否允许代理修改方块。
  • externalLink：外部链接配置。
    • url：链接URL。
    • displayName：链接在界面中的显示名称。
  • camera：摄像机方块设置。
    • filter：摄像机拍照的视觉滤镜，目前可选值为"grayscale"（灰度）。
    • border：摄像机拍照的边框样式，目前可选值为"borderpath"。
  • commands：命令可见性配置。
    • hiddenFromPlayer：从玩家命令起点隐藏的命令名称列表。列表元素为命令名字符串，支持在命令名前加!表示排除该命令（取非），*代表全部命令。
    • hiddenFromAutomation：从自动化命令起点隐藏的命令名称列表，规则同上。