旧版中国版MC Studio工具链¶

这篇说明适合在维护旧版中国版MC Studio项目时阅读。这里集中整理了2020年至2021年前后常见的启动器、地图编辑器、关卡编辑器、逻辑编辑器、特效编辑器、界面编辑器和调试工具信息；新项目仍应优先按照当前中国版开发工作台和当前平台要求实施。

不要外推为国际版规则

本页只描述旧版中国版MC Studio工具链。它不表示国际版Minecraft编辑器、国际版附加包、@minecraft/server脚本API或当前Minecraft启动器具有相同功能、目录或发布流程。

工具定位¶

旧版MC Studio把开发者启动器、作品模板、内嵌游戏、多个可视化编辑器和发布入口集中在同一工具中。旧版资料说明，开发者需要使用中国版开发者账号登录；非开发者账号可在工具内提交资料申请成为开发者。

启动器负责创建、导入、测试和发布中国版作品。旧版“基岩版组件”分页会同时显示本地作品和已经上传到中国版平台的云端作品；“发布”分页用于向中国版资源中心提交作品审核；“工具箱”中可启动额外的ModPC开发包或调试工具。

旧版资料还记录了基岩版网络游戏和Apollo相关入口。本批次只整理MC Studio开发工具本身，不展开Apollo网络服流程。

作品流程¶

旧版MC Studio支持从模板新建基岩版作品，也支持本地导入已有地图、附加包、材质、光影或皮肤。模板大致分为“纯编辑器开发”和“脚本开发”两类：前者主要依赖可视化组件生成资源，后者包含较复杂的Python脚本并需要打开作品目录维护文件。

常见流程如下：

在启动器中新建空白地图、空白附加包或模板作品。
通过地图编辑器、关卡编辑器、逻辑编辑器、特效编辑器或界面编辑器制作内容。
使用“开发测试”启动ModPC开发包验证作品。
如需测试多人联机玩法，先启动一个开发测试客户端，再从工具箱启动额外ModPC开发包加入局域网房间。
通过作品页“更多”菜单进入发布流程，补全作品信息并提交审核。
审核、打包和上线测试后，再按中国版平台要求上架。

旧版资料说明，在开发测试和上线测试时可按F11在电脑与移动端操作模式之间切换。该行为属于旧版中国版测试环境细节，不应写入国际版教程。

编辑器矩阵¶

工具	旧版用途	典型产物或影响	维护风险
地图编辑器	在内嵌游戏中绘制、选取、编辑地形与结构	存档方块数据、素材文件、结构文件	工具操作会直接改变地图副本，迁移前应备份
关卡编辑器	通过组件配置世界、玩家、生物、物品、方块、配方和流程	行为包、资源包、`pack_manifest.json`、中国版专有目录	手动修改文件后再次保存可能被组件覆盖
逻辑编辑器	用节点图封装部分模组SDK逻辑	`.ets`逻辑文件、`storyline`目录内容	复杂逻辑可维护性低，旧版资料也建议优先学习Python
特效编辑器	制作中国版粒子、序列帧、模型挂接与预览	`effects`、`models`、`textures`中的中国版资源	与国际版粒子系统不是同一种格式
界面编辑器	可视化编辑中国版游戏内界面	`.mcgui`工程文件和同名JSON界面文件	旧版适配规则、控件名称和缩放逻辑具有版本敏感性
调试工具	连接ModPC或安卓测试包查看日志、管理资源与模组	调试日志、远程目录操作、模组启用配置	只适用于旧版中国版测试环境

地图编辑器¶

地图编辑器用于在旧版中国版内嵌游戏窗口中修改地图。旧版资料把它的功能分为选取、编辑、笔刷和地形四组。

选取功能通过包围盒选择方块区域，可移动、调整面、取消、复制、剪切、堆叠、填充、替换、偏移或删除。编辑功能会对选中区域进行旋转、缩放或其他结构化变换；旧版资料强调，编辑模式中看到的图像是模拟生成结果，需要确认生成后才正式生效。

笔刷功能提供单点、方形、球形、圆柱和半球等形状，并可设置尺寸、中空、直线生成、覆盖原方块、连续生成间距、放置基点、放置方向和方块朝向。地形功能提供隆起、侵蚀、平滑、填充、顶层覆盖和植物生成等操作。

旧版地图编辑器还包含素材与结构功能。素材功能可把选区保存为素材库中的.mdl素材，也可导入FBX或OBJ模型并转换为可放置素材。结构功能可把选区保存到行为包的structures/<命名空间>目录；保存时可选择是否包含实体、是否去除空气方块以及是否按边长切分为多个结构。旧版资料进一步说明，切分结构会生成基础坐标配置，脚本可通过中国版模组SDK的PlaceStructure接口按坐标还原结构。

关卡编辑器¶

关卡编辑器是旧版MC Studio中配置和管理附加包组件的中心。旧版资料建议新手先用组件搭建玩法，熟手通过资源管理理解附加包文件，高阶开发者则把组件用作快速原型，再进行文件级修改。

关卡编辑器中的组件会生成或修改作品文件。世界基础属性可覆盖进入游戏后的难度、游戏模式、随机刻速度等设置；玩家基础属性可配置饥饿锁定、名称透视和逻辑文件；生物组件可配置自定义生物名称、模型动作、移动、战斗、行为、经济与逻辑；物品基础组件可生成自定义物品并设置贴图、特殊类型或生成蛋等属性。

组件大类包括世界、维度、玩家、生物、物品、方块、配方、队伍、经济、剧情、流程和玩法元素。任务链模板、对战玩法模板和塔防模板等旧版模板都依靠多个组件协同生成对话、任务、掉落、实体和流程。

旧版地图类作品的典型结构如下：

作品文件夹
- .mcs：编辑器配置。
- behavior_packs
  - behavior_pack_***
    - entities：实体服务端JSON。
    - script_***：Python脚本目录。
    - items：原版物品JSON。
    - netease_items：中国版自定义物品JSON。
    - netease_blocks：中国版自定义方块JSON。
    - loot_tables：战利品表。
    - recipes：配方。
    - spawn_rules：生成规则。
    - trading：交易表。
    - storyline：逻辑编辑器逻辑文件。
    - Galaxy：逻辑编辑器宏文件。
    - pack_manifest.json：旧版中国版包清单。
- resource_packs
  - resource_pack_***
    - entity：客户端实体定义。
    - attachables：附着物。
    - models：模型资源。
    - materials：材质。
    - effects：中国版粒子和序列帧特效JSON。
    - textures：图片资源。
    - netease_items_res：中国版自定义物品客户端配置。
    - sounds：音效。
    - texts：本地化文本。
    - ui：界面JSON。
    - font：字体。
    - pack_manifest.json：旧版中国版包清单。
- .db：存档数据库。
- level.dat
- level.dat_old
- levelname.txt
- world_behavior_packs.json
- world_resource_packs.json
- world_icon.jpeg
- work.mcscfg

Addon类型作品不包含地图文件、behavior_packs和resource_packs集合目录，而是直接包含行为包和资源包。维护旧项目时，应先确认实际目录是地图作品还是附加包作品，再判断文件路径。

逻辑编辑器¶

逻辑编辑器把部分中国版模组SDK能力包装为节点图。旧版资料明确指出，逻辑编辑器适合入门开发者或逻辑不复杂的组件；如果具备代码能力，使用Python脚本更灵活、上限更高。

逻辑编辑器保存.ets文件，文件名只能由英文字母和数字构成。节点图以事件节点为起点，后续连接行为节点、逻辑节点、运算节点或参数节点。事件节点在事件发生时触发；行为节点操作实体、方块、物品或界面；逻辑节点处理关系判断和流程控制；运算节点提供简单数学运算；参数节点处理常量与变量。

旧版逻辑编辑器使用多种数据类型，包括布尔值、整数、浮点数、字符串、二维坐标、三维坐标、实体ID、方块类型、物品类型和任意数据。物品类型在旧版由物品ID、数据值和数据版本组成，其中中国版自定义物品的数据版本会区分不同代自定义物品格式。

.ets文件需要挂接到世界、玩家或生物等对象上才能运行。世界挂接适合世界加载后即开始执行的逻辑；玩家挂接适合玩家相关逻辑；生物挂接会对每个该类型生物实例执行。调试时可插入“打印信息”节点，并在脚本日志或输出窗口中观察结果。

逻辑编辑器还提供临时变量、永久变量和宏。临时变量用于单个.ets内传递数据，重启后清空；永久变量可跨.ets使用并在重启后保留。宏用于封装重复节点图。旧版资料特别提醒，分叉与汇聚连接会按深度遍历确定执行顺序，结果可能不同于直观的并行执行；复杂节点图应尽量保持顺序连接，或避免既分叉又汇聚。

界面编辑器¶

界面编辑器用于可视化编辑旧版中国版游戏内界面。工程文件后缀为.mcgui；保存时，每个.mcgui会另存一个同名JSON文件，后者才是游戏运行时实际读取的界面文件。

旧版界面编辑器中的主要控件包括画布、面板、图片、按钮、文本、滚动列表和网格。画布是完整界面，不能作为其他控件的子控件；面板用于组织控件；按钮包含普通、按下和悬浮贴图；滚动列表的内容通常引用其他画布中的面板、按钮或网格；网格用于规律排布物品栏等界面元素。

控件基础属性包括锚点、名称、隐藏状态、层级、位移和尺寸。旧版资料使用%+Px形式描述位移和尺寸：百分比部分按父控件尺寸计算，固定像素部分再乘以界面缩放比例。手机界面适配以320×210适配区域为基准；电脑端基岩版旧版资料给出的基准为376×250。若同一套界面资源同时面向手机和电脑端，应优先按手机基准控制核心显示范围。

这些规则有助于维护旧版中国版界面，但不应直接替代当前JSON UI参考。当前项目应先确认目标中国版客户端、工具版本和实际生成的JSON结构。

调试工具¶

旧版调试工具可在MC Studio工具箱中启动，用于连接ModPC开发包或安卓移动端测试包。首次连接时需要在调试工具中输入客户端IP地址；成功连接过的客户端后续会向上次连接的调试工具请求连接。若客户端已经连接到一个调试工具，其他调试工具再通过IP连接无效。

连接后，右侧日志窗口显示游戏日志，并支持搜索、跳转匹配项、复制全文和清空。旧版资料说明日志可用[DEBUG]、[INFO]、[WARNING]和[ERROR]关键字区分颜色。左侧调试窗口可在进入游戏后向客户端线程或服务端线程运行Python测试代码。

远程目录功能用于管理客户端目录中的部分资源文件。旧版资料特别注明，它暂不支持修改模组脚本，也不支持添加新的资源文件，只能修改原有资源文件。模组管理面板可勾选世界中启用的模组；当游戏和调试工具不在同一机器上时，调试工具不能新增模组，只能配置已有模组。

更新记录的价值¶

旧版更新记录覆盖MC Studio0.14.5至0.16.11附近的变化，可用于判断某个功能在旧版工具链中大致何时出现。例如，旧版记录提到地图编辑器的结构保存、镜像翻转、笔刷与地形工具，关卡编辑器的组件多选与自定义生物属性调整，特效编辑器的第一人称模型、序列帧随机播放、动态贴图和模型挂接改进，界面编辑器的网格、物品渲染控件、分辨率选项和九宫格规则，以及移动端调试工具。

这些记录只能作为历史语境。维护旧项目时，可用它们解释“为什么某个旧教程里有这个按钮”或“为什么某个旧工程依赖中国版专有目录”；创建新项目时，不应把旧版更新记录当成当前功能清单。

是否应阅读本页¶

适合阅读本页的情况：

项目来自旧版MC Studio或中国版旧教程。
作品目录中出现.mcs、work.mcscfg、pack_manifest.json、storyline、Galaxy、netease_items、netease_blocks或effects等旧版中国版痕迹。
需要判断.ets、.mcgui、.mdl或中国版特效JSON是否仍与当前维护目标有关。
需要解释旧版文档中的ModPC、调试工具、开发测试、上线测试或发布流程。

不适合阅读本页的情况：

正在学习国际版Minecraft编辑器。
正在从零编写国际版附加包或脚本API项目。
希望获得当前中国版开发工作台的完整操作步骤。