必须确保json文件符合_mcjs解析规范:一、验证utf-8编码与标准json语法,用jsonlint校验并修正;二、拖放至虚线框区域自动解析;三、通过文件选择对话框上传;四、手动粘贴已校验json文本后点击解析。

如果您在使用\_MCJS网页版时需要导入自定义JSON文件以配置资源包、数据包或行为定义,则必须确保JSON格式符合\_MCJS的解析规范。以下是完成JSON文件导入的具体操作流程:
一、确认JSON文件结构合规
在导入前,需验证JSON文件是否为合法的UTF-8编码纯文本,且无语法错误(如末尾多余逗号、未闭合引号、注释残留等)。\_MCJS仅接受标准JSON,不支持JavaScript风格扩展(如单引号、注释、尾随逗号)。
1、用文本编辑器(如VS Code、Notepad++)打开JSON文件。
2、检查文件开头是否为{或[,结尾是否为}或]。
3、复制全部内容,在JSONLint中粘贴并点击“Validate JSON”进行校验。
4、若提示错误,根据行号修正语法问题,保存为无BOM的UTF-8格式。
二、通过拖放方式导入JSON文件
\_MCJS网页版支持直接拖拽文件至指定区域触发解析,该方式跳过手动路径选择,降低文件路径误读风险。
1、在\_MCJS网页界面中找到标有“拖放JSON文件至此”的虚线框区域。
2、确保浏览器已允许文件拖放权限(Chrome/Firefox默认启用)。
3、在文件管理器中选中目标JSON文件,按住鼠标左键将其拖入该虚线框内。
4、松开鼠标后,页面将自动读取并显示JSON根结构预览;若出现红色报错提示,则说明文件仍含非法字符或结构异常。
三、使用文件选择对话框导入
当拖放不可用(如移动端或浏览器限制)时,可通过传统文件选择器上传,系统会读取文件二进制流并解析为对象树。
1、点击页面中“选择JSON文件”按钮。
2、在弹出的系统文件对话框中定位到JSON文件所在目录。
3、单击选中文件,点击“打开”或“确定”。
4、等待右上角加载指示器消失,观察下方JSON视图区是否渲染出可折叠的对象节点。
四、手动粘贴JSON文本内容
适用于调试片段、快速测试小段配置,绕过文件IO环节,直接将字符串交由\_MCJS内部JSON.parse()处理。
1、在\_MCJS界面中找到“粘贴JSON文本”文本域(通常位于导入区域下方)。
2、将已校验无误的JSON字符串(不含```json```包裹符)完整复制。
3、在文本域中按Ctrl+V(Windows)或Cmd+V(macOS)粘贴。
4、点击旁边的“解析并载入”按钮,触发即时解析与结构渲染。











