讨论 【实用】Add-On 开发参考资料整理

[SylJack]

Add-On Dev Guide
勿在本帖下回复不必要的灌水帖，感谢配合。

【官方】【英文】Minecraft Bedrock 开发文档
https://docs.microsoft.com/zh-cn/minecraft/creator/

【中英文】Bedrock Dev 开发文档

https://bedrock.dev/

【中文】Minecraft BE 开发者 Wiki
https://wiki.bedev.cn/

【中文】Minecraft Wiki
https://minecraft.fandom.com/zh/wiki/Minecraft_Wiki?variant=zh

折叠 : 版本区别指南

版本号后带有 B 字样的（如 1.19.70.20B），即为测试版本。
若没有 B 字样，即为正式版本。
有验证版本：来自 Google Play 且不经过任何破解验证的原版，不作任何修改，需要购入正版后才能使用。

折叠 : 无验证版本

以下版本均为破解验证版本，无需购入正版（如有条件，请支持正版）
① 有音乐包版本：在原版基础上仅作破解验证修改，无需购入正版即可使用。
② 无音乐包版本：在原版基础上作破解验证修改并将音乐包移除，安装后若需要音乐包可在游戏内的【市场】进行下载。（另注：1.19.22.01 及以前的版本不自带音乐包）
③ 路径修改版本：在原版基础上作破解验证修改并将存储路径从

/Android/data/com.mojang.minecraftpe/files/games/com.mojang/

修改为

/games/com.mojang/

（另注：Mojang Studios 在 BE 1.18 及以上的版本为遵循 Google 要求而修改存储路径，如果使用未修改路径的版本，卸载游戏后数据将丢失。另外，部分手机文件清理软件也会将其视为缓存数据清理。强烈推荐使用路径修改或混合修改版本。）
④ 混合修改版本：无音乐包版本 和 路径修改版本 的结合版本
⑤ 单机共存版本：单一设备内安装非共存版本可同时安装共存版本

折叠 : 架构区别指南

通过 DevCheck 可检查自己的设备是何种架构
DevCheck 下载：请点击此
（DevCheck ＞ 系统 ＞ 操作系统 ＞ 架构/指令集架构）

架构	适用情况
armv8（v8a，64位）	大部分手机、平板设备 Minecraft 1.16+ 考虑首选 armv8 旧机型可能无法运行 (旧：约 2016 年之前)
armv7（v7a，32位）	几乎所有手机、平板设备 Minecraft 0.1 - 1.14 考虑首选 armv7
x86（386，32位）	模拟器、极少数平板
x64（x84_64/AMD64，64位）	64 位模拟器

折叠 : 版本区别表格

折叠 : 1.19.30.04 及以上

版本名称	是否破解验证	有无音乐包	是否路径修改	是否共存
有验证版本
有音乐包版本
无音乐包版本
路径修改版本
混合修改版本
单机共存版本

折叠 : 1.18 - 1.19.22.01

版本名称	是否破解验证	有无音乐包	是否路径修改	是否共存
有验证版本
有音乐包版本	不适用	不适用	不适用	不适用
无音乐包版本
路径修改版本
混合修改版本	不适用	不适用	不适用	不适用
单机共存版本

折叠 : 1.17 及以下

版本名称	是否破解验证	有无音乐包	是否路径修改	是否共存
有验证版本
有音乐包版本	不适用	不适用	不适用	不适用
无音乐包版本
路径修改版本	不适用	不适用	不适用	不适用
混合修改版本	不适用	不适用	不适用	不适用
单机共存版本

- - -

基岩版（Bedrock Edition）（官方称为无副标题的 Minecraft）是由 Mojang Studios 、Xbox Game Studios 和 SkyBox Labs 开发的多平台版本 Minecraft，基于与携带版一脉相承的游戏引擎基岩引擎。

Android 支持情况（冒号后为所需的最低系统版本）

• 最新版本：Android Lollipop（5.0）
• 至基岩版1.17.0.52：Android KitKat（4.4）
• 至基岩版1.17.0.50：Android Jelly Bean（4.2）
• 至基岩版1.7.0：Android Ice Cream Sandwich（4.0）
• 至携带版0.14.3：Android Gingerbread（2.3）
• 至携带版0.5.0j：Android Eclair（2.1）

折叠 : 版本阶段介绍信息

折叠 : Alpha

Alpha
最初的版本在iOS和Android平台上发布后，更新开始同步发布，相同的特性也加入到这两个平台中。在Alpha阶段，不断加入携带版的特性有：合成、烧炼、更多的方块、物品、生物和更多游戏模式，使它更接近于Java版。因为携带版和Java版工作组在一起，所以在Java版发布的方块经常也会同时在携带版发布。一些特性在Java版上发布前，也会在携带版上测试，例如甜菜根及其相关物品，还有方块模型。

在Alpha阶段，基岩版被移植到更多平台上：首先，携带版于2012年9月13日发布在Kindle Fire上，于2014年12月10日发布在Windows Phone上。Windows 10版Beta于2015年7月29日发布，价格高于携带版。Gear VR版于2016年4月27日发布，价格与携带版相同。

在此期间，还发布了另外两个基于基岩代码库的Minecraft版本，它们与基岩版分开。树莓派版是和Minecraft的停止更新的树莓派免费版本，它基于基岩版的旧Alpha版本。教育版于2016年11月1日在Windows 10和macOS上发布。

折叠 : 正式版

正式版
2016年11月11日，1.0.0（末影更新）被宣布。其于2016年12月19日正式发布，与Apple TV版和Fire TV版一起于2016年12月19日发布。自2017年2月22日起，携带版开始再次收到Windows 10 Mobile的更新。

自1.2.0，独乐不如众乐更新开始，基岩版的所有版本都不再具有“Pocket Edition”副标题，并被重命名为Minecraft。Xbox One的基岩版端口随此更新一同发布，Nintendo Switch的端口于2018年6月21日以数字版和实体版方式发布。PlayStation 4用户则于2019年12月10日收到具有1.14.0更新的基岩版。这些主机原有原主机版的所有者可以免费下载新版本。

折叠 : 测试与预览版

测试与预览版
2013年11月22日起，Mojang开始为加入了测试组的用户公开发布包含完整更新内容的测试版，目的是让开发者能够及时得到反馈，尤其是漏洞报告，以使正式版更加稳定。0.8.0至0.12.1版本期间，用户需要参与Google+小组来获取测试版，随后玩家就可以像接收常规更新一样在应用商店里查看测试版的更新。2015年7月17日，Google+小组因为垃圾信息和广告而被移除。2015年11月3日，PE开发团队推出了专用博客，之后其被专门用来帮助用户加入0.13.0测试组，并会展示测试版的更新日志。现在可以在Google Play的Minecraft界面底部加入开发者测试来获得Android平台的测试版，Windows和Xbox One平台则是在Xbox会员中心获取测试版。

2022年1月31日起，测试版计划以Minecraft Preview的形式扩展到其他平台，最早在iOS/iPadOS平台上发布。现行的通过Xbox Insider Hub进行的测试计划预计将逐步淘汰，并最终被Minecraft Preview所替代。

 

[SylJack]

一个基本的物品JSON范例，需做修改使用

{
  "format_version": "1.16.1",
  "minecraft:item": {
    "description": {
      "identifier": "minecraft:blaze_rod"
    },
    "components": {
      "minecraft:fuel": {
        "duration": 120.0
      },
      "minecraft:max_stack_size": 64,
      "minecraft:icon": {
        "texture": "blaze_rod"
      },
      "minecraft:hand_equipped": true,
      "minecraft:display_name": {
        "value": "Blaze Rod"
      }
    }
  }
}

 

[SummerGoro]

补充一个网站，可以用于查询Addons开发相关参数内容

bedrock.dev

Minecraft基岩版文档

bedrock.dev