Bedrock Wiki
  • QQ
  • 原站
新手入门指南
  • Guide
    • 1. 简介
      指南
    • 2. 附加组件详解
    • 3. 软件与准备工作
    • 4. 项目设置
    • 5. 创建自定义物品
    • 6. 创建自定义实体
    • 7. Blockbench:建模、贴图与动画制作
    • 8. 添加战利品表、生成规则与合成配方
  • Extra
    • a. 理解JSON
    • b. 下载示例包
    • c. 故障排除
      帮助
    • d. 高级清单文件指南
    • e. 格式版本
    • f. Android 项目设置
JSON UI
  • General
    • JSON UI 入门指南
      指南
    • 最佳实践
      指南
  • Tutorials
    • Aseprite 动画
    • 保留标题文本
      中级
    • 修改服务器表单
      中级
    • 字符串与数字转换
      中级
    • 按钮与开关
      新手
    • 添加HUD界面元素
      新手
  • Documentation
    • JSON UI 文档
Meta
  • Style Guide
  • 使用JSON模式(Schemas)
  • 实用链接
  • 版本控制
  • 附加包性能优化
  • Q&A
    • GameTest 问答集 2021/08/06
    • 世界生成问答 2024/11/15
    • 延迟渲染技术预览问答 2024/02/23
    • 方块与物品问答 2024/08/30
    • 脚本与编辑器问答 2023/09/22
NBT
  • General
    • .mcstructure
  • Tutorials
    • 扩展结构限制
      简单
    • 教育版中的实验功能
      简单
  • NBT in Depth
    • NBT 库列表
      专家
    • NBT读取示例
      专家
    • 关于NBT(命名二进制标签)
      专家
世界生成
  • General
    • 世界生成入门
      指南
      实验性
    • 特性类型
      实验性
    • 生物群系
      指南
      实验性
  • Tutorials
    • 特征(Feature)的方块条件
      实验性
    • 生成地表区块
      实验性
    • 生成自定义矿石
      实验性
    • 生成自定义结构
      实验性
    • 高度图噪声地形
      实验性
  • Documentation
    • 生物群系标签
动画控制器
  • 动画控制器入门指南
    指南
  • 实体命令
    中级
  • AFK检测器
  • 将Molang变量转换为计分板数值
  • 死亡指令
  • 重生指令
命令
  • General
    • 命令方块入门指南
    • 函数
    • NBT 命令
    • 坐标系
    • 方块状态
    • 理解目标选择器
    • 记分板操作
  • Commands
    • Execute
      简单
    • Playanimation
    • 伤害
    • 播放音效
  • On Event Systems
    • 玩家首次加入时
    • On Player Join
    • 玩家离开时触发
    • 玩家死亡事件
    • 玩家重生事件系统
    • 首次加载世界时
  • Scoreboard Systems
    • 实体计数器
    • 计分板计时器
    • 比较与获取分数
  • Techniques
    • 执行逻辑门
    • MBE - Max的方块实体
    • FMBE - 创建显示实体的新方法
    • 视线检测
    • 移动状态检测
    • 轨道摄像机
  • Useful Creations
    • 多人位置重排系统
      函数
    • 自定义合成台
      简单
实体
  • General
    • Intro to Entities BP
      指南
      新手
    • 实体资源包入门
      指南
      新手
    • 实体问题排查指南
      帮助
    • NPC对话系统
      中级
    • 实体事件
      新手
    • 实体属性
    • 渲染控制器
      新手
    • 生成规则
  • Tutorials
    • 任意坐标系间的坐标转换(世界、实体、骨骼)
      中级
    • 创建船只
      中级
    • 实体手持物品
      中级
    • 实体攻击机制
      中级
    • 实体睡眠机制
      中级
    • 实体碰撞体
      中级
    • 实体移动
    • 实体计时器
      中级
    • 无敌实体
      新手
    • 村庄机制实现指南
    • 检测其他实体
      中级
    • 生成已驯服的实体
      脚本
      中级
    • 视线检测实体
      中级
    • 禁用队友伤害
      中级
    • 范围效果云入门指南
      中级
    • 虚拟实体
      新手
    • 飞行实体控制
      中级
  • Documentation
    • Vanilla Usage Spawn Rules
    • 原版使用组件
    • 抛射物
    • 虚拟组件
    • 运行时标识符
    • 非生物实体运行时标识符
战利品、配方与交易
  • General
    • 交易行为
  • Documentation
    • 战利品表
    • 交易表
    • 合成配方
    • 物品函数
  • Tutorials
    • 随机化结构战利品
      简单
文档
  • Shared Constructs
  • Molang 查询详解
  • Vanilla Materials
    专家
  • 声音定义
  • 文件类型
  • 材质配置文件说明
    专家
  • 菜单分类
  • 资源包文件夹结构
  • 雾效ID
  • 高级Molang指南
方块
  • General
    • 方块入门指南
      指南
      新手
    • 方块组件
    • Block Tags
    • 方块状态
    • Block Traits
    • 方块排列组合
    • 方块事件
      脚本
    • 方块事件迁移指南
      帮助
    • 方块物品化
      中级
    • 方块问题排查指南
      帮助
  • Visuals
    • 方块剔除
      中级
    • 方块模型
      指南
      新手
      简单
    • 方块着色
      简单
    • 方块纹理动画
      中级
    • 方块纹理变体
      中级
  • Tutorials
    • Precise Interaction
      专家
      脚本
    • Precise Rotation
      专家
      脚本
    • 伪方块
      中级
    • 可旋转方块
    • 应用持续效果
      简单
      脚本
    • 矿石战利品表
      简单
      脚本
    • 规避状态值限制
      专家
  • Vanilla Re-Creations
    • 自定义作物
      中级
      脚本
    • 自定义活板门
      中级
      脚本
    • 自定义玻璃
      新手
      简单
      已弃用
    • 自定义釉面陶瓦
      简单
  • Documentation
    • 原版方块模型
      新手
    • 方块形状
    • 方块格式历史
    • 方块音效
服务器
  • Software
    • Bedrock Server Software
  • Protocols
    • Bedrock Protocol
    • NetherNet 协议
    • RakNet 协议
概念
  • contents.json
  • Molang
    中级
  • Rawtext
  • textures_list.json
  • 命名空间
  • 子包
  • 文本与本地化
  • 着色器
  • 纹理图集
    中级
  • 表情符号与特殊字符
  • 覆盖资源
    中级
  • 音效
    中级
物品
  • General
    • 物品入门指南
      指南
      新手
    • 物品组件
    • 物品标签
    • 物品事件
      脚本
    • Item Event Migration
      帮助
    • 物品问题排查指南
      帮助
  • Tutorials
    • Custom Pottery Sherds
    • 可投掷物品
      中级
    • 生成物品
      中级
    • 自定义武器
      简单
    • 自定义盔甲
    • 自定义食物
      简单
      脚本
    • 通过装备物品执行命令
      实验性
      中级
    • 高分辨率物品
  • Documentation
    • 附魔
    • Numerical Item IDs
    • Vanilla Usage Components
    • 原版物品标识符
      已弃用
    • 可附着物
      新手
    • 物品格式历史记录
视觉效果
  • General
    • 实体视觉效果简介
      指南
    • 基岩版建模指南
    • 动画中的特效
    • 基于数学的动画
      中级
    • 材质
      专家
    • 材质创作
      专家
    • 皮肤包制作指南
    • 自定义死亡动画
      中级
  • Tutorials
    • Glowing Entity Texture
    • 受伤动画
      中级
    • 实体纹理动画
      中级
    • 栓绳位置调整
      简单
    • 玩家几何模型
      新手
    • 移除实体阴影
      中级
    • 重绘生成蛋纹理
      新手
  • Ideas
    • 结构展示技巧
粒子效果
  • General
    • 粒子效果入门
      指南
  • Tutorials
    • 禁用粒子效果
      新手
  • Documentation
    • 原版粒子效果
脚本编写
  • General
    • 脚本编程入门
    • 什么是Script API?
    • API 模块
  • Tutorials
    • GameTests
      实验性
    • 简易聊天命令
      实验性
    • 脚本核心功能
    • 脚本表单
      实验性
    • 脚本请求API
      实验性
    • 阻止方块放置
  • Documentation
    • JavaScript 问题排查指南
    • Script Resources
    • Script Watchdog
      实验性
    • TypeScript
    • 引擎环境
虚拟现实
  • General
    • 启用VR模式
      指南
    • 配置资源包
      专家
  • Tutorials
    • 编辑你的第一个模型
      专家

软件与准备工作

软件与准备工作
  • 下载 Minecraft 基岩版
  • 选择编辑器
    • VSCode
    • bridge.
    • 移动端编辑器
  • Blockbench
  • 图像编辑器
    • Krita
    • GIMP
    • Paint․net
    • Pixilart
    • Piskel
    • Libresprite
  • 补充材料
    • 加入 Discord
    • 原版资源包
    • 文档资源
    • 故障排除与额外帮助
  • 下一步

在开始创建附加包之前,您需要先安装必要的工具和应用程序。虽然在 Windows 10 上进行开发最为便捷,但我们也为 Android 和 iOS 用户提供了适用的移动端替代方案。

本页面将为您列出需要安装的软件,并提供配置建议。

下载 Minecraft 基岩版 ​

  • Windows
  • Android
  • iOS
  • 在 Linux 上运行 MC

选择编辑器 ​

虽然任何文本编辑器都可以用来创建附加包,但使用专用编辑器会更加高效。优秀的编辑器能提供代码补全、错误检测和内置文档支持。

关于最适合初学者的编辑器众说纷纭,但选择 VSCode 或 bridge. 通常不会出错。如果您使用移动设备,则需要选择移动端替代方案。

VSCode ​

VSCode 是一款通用文本编辑器和集成开发环境。通过 VSCode,您可以在纯文本模式下编辑附加包,并借助丰富的扩展功能获得辅助。VSCode 非常适合程序员和高级用户。

⚙️安装 VSCode

配置 VSCode

以下扩展包能让附加包编辑更加便捷:

  • Blockception 的 Minecraft 基岩版开发扩展
  • .mcfunction 支持
  • .lang 支持
  • 基岩版定义
  • JSON 美化
  • 拼写检查器(用于编写维基)
  • Snowstorm 粒子编辑器
  • UUID 生成器

bridge. ​

bridge. 是一款轻量级、专为 Minecraft 附加包设计的集成开发环境。它具备多项创新功能,例如实体和方块预览、智能自动补全与文件验证,以及基于预设的高级文件创建功能。bridge. 既为经验丰富的附加包创作者提供常规文本编辑器,也为初学者提供便于编辑 JSON 文件的树状编辑器。

配置 Bridge
  • 了解为何选择 bridge.
  • 阅读 bridge. 入门指南
  • 在线试用 bridge.

移动端编辑器 ​

Android ​

  • ACode Editor
  • bridge. v2

iOS ​

  • Kodex
  • bridge. v2

Blockbench ​

  • Blockbench 是一款"方块风格 3D 建模工具",常用于创建 Minecraft 模型、纹理和动画。同时提供兼容移动设备的网页版。

图像编辑器 ​

选择图像编辑器时,需要注意传统 Minecraft 风格采用简单的 16×16 像素画。市面上有许多功能强大且免费的艺术程序可供使用,但其中许多工具的学习成本较高,且包含超出 Minecraft 图形设计需求的功能。

TIP

选择您觉得顺手易用的程序。许多附加包创作者会针对不同任务使用不同软件(例如:使用 paint․net 处理大部分美术工作,而用 piskel 制作 Minecraft 方块动画)。选择最适合您的工具!

Krita ​

Krita 是一款开源艺术软件,旨在为艺术家提供强大的免费数字艺术工具。其功能完全能满足 Minecraft 创作需求,支持 MAC 和 PC 平台。

  • + 优点:功能丰富,包含直观的像素画笔界面
  • - 缺点:需要时间熟悉工具操作

下载 Krita

GIMP ​

GIMP 与 Krita 类似,同为开源免费的数字艺术软件,但更侧重于图像处理(类似 Photoshop)。支持 MAC 和 PC 平台。

  • + 优点:工具完全满足 Minecraft 美术编辑需求
  • - 缺点:界面不够直观,学习曲线陡峭

下载 GIMP

Paint․net ​

Paint․net 是一款简单而强大的图像编辑软件。虽然功能不如 Krita 和 GIMP 丰富,但胜在简单易用。

  • + 优点:操作简单,学习成本低
  • - 缺点:仅支持 Windows 平台

下载 Paint.net

Pixilart ​

Pixilart 是一款网页版像素艺术软件,专注于像素画创作,使用极其简单。其强大的缩放功能可保持像素细节不失真。

  • + 优点:简单易学,专为像素艺术优化
  • - 缺点:需联网使用,功能较为基础

使用 Pixilart

Piskel ​

Piskel 是另一款网页像素艺术工具,专注于制作像素精灵(或游戏角色动画)。与 Pixilart 类似操作简单,特别适合制作翻页动画(Minecraft 方块或皮肤动画)。

  • + 优点:简单易用,制作翻页动画的理想选择
  • - 缺点:需联网使用,仅提供基础工具

下载 Piskel

Libresprite ​

LibreSprite 是一款免费开源的精灵制作与动画软件,基于 Aseprite 最后的 GPLv2 版本开发。

  • + 优点:基础易用,专为像素艺术家定制
  • - 缺点:可能不兼容 Mac 系统,仅由小型社区维护

补充材料 ​

TIP

本指南仅涵盖附加包开发的初级阶段!要深入学习附加包制作,您还需要参考以下资源。

加入 Discord ​

获取帮助的最佳方式是加入我们的 Discord 服务器。

原版资源包 ​

Minecraft 原版文件是绝佳的参考资料。建议下载这些资源包并存储在电脑方便的位置,当您需要参考物品、实体或动画示例时,可以随时查阅。

  • 原版资源包

文档资源 ​

附加包开发有许多优质文档资源,建议您熟悉并收藏这些网站:

  • bedrock.dev:参考文档
  • bedrock.8aka.org:教程与指南
  • MS 文档:微软官方附加包创作门户

故障排除与额外帮助 ​

  • 若 JSON 格式令您困扰,请阅读 理解 JSON 指南
  • 遇到奇怪错误时,可参考 故障排除指南
  • 更多工具资源请访问 实用链接

下一步 ​

当前进度

下一步:项目设置

贡献者

编辑 软件与准备工作

Bedrock Wiki by Bedrock OSS ,Translate by 8aka-Team

"Minecraft"是Mojang AB的注册商标。

Bedrock OSS、Bedrock Wiki以及 bedrock.dev 与Microsoft及Mojang AB不存在任何隶属关系。

  • 隐私政策
  • 加入QQ社区
  • 参与贡献指南
  • 访问代码仓库