跳到主要内容

如何添加Addon(附加包)

本篇文档将教你如何在服务端安装Addon。

前言​

部分内容已过期

本文档部分内容已过期！现已隐藏！

危险警告
  • BDS在添加Addon后会造成性能下降（尤其是修改生物类模组），严重时可能会崩服。
  • BDS无法完美兼容所有Addon（例：一个Addon在本地客户端上正常运行，当其装载之服务端后就无法运行）。
  • 在安装Addon之前强烈建议先备份一次整个服务端，以免安装Addon后服务端出现不可逆错误进而损坏存档！
  • Nukkit系服务端无法安装Addon！
提示

本篇文档的部分配图将使用Windows桌面窗口演示。

提示
  • 基岩版没有模组的概念，其修改或新加内容的手段叫做叫做Addon(附加包)，请不要与Java版的 mod(模组) 混淆！
  • 在提问时请正确的将基岩版的修改或新加内容的手段称作Addon 或 附加包，以便解答者快速判别你所使用的版本！

准备工作​

什么是Addon？​

附加包（Add-on） 是基岩版加入新内容或修改原有内容的一种手段，受Mojang官方支持。附加包允许玩家更改世界的纹理样貌、实体的模型、行为规则等，是实现Minecraft全版本自定义（即数据驱动）的坚实一步。通常包含资源包与行为包两部分。
资源包（ResourcePacks）：资源包是一组图像、模型、声音和其他资源文件，用于修改游戏的外观和声音效果。
行为包（BehaviorPacks）：行为包是一组数据文件，用于定义实体（生物、物品、方块等）的行为和交互规则。

检查文件格式（很重要）​

想要使用以下的方式安装，首先要保证文件后缀统一，如果你的资源文件为.zip或者.rar，请务必再导入前修改为.mcpack（材质纹理音效）或者.mcaddon（Addon/附加包）格式。

.mcpack：是最早引入MCBE的文件格式，仅仅表示单个资源包或单个行为包，该文件包直接包含资源包或行为包的内容文件。
.mcaddon：随版本发展，该文件格式被引入后，批量安装Add-on的操作变得容易，一个.mcaddon文件可包含多个子文件夹（资源包或行为包的内容文件夹，或者是mcpack包），在安装时，由游戏自动识别每个子文件夹的类型（子附加包类型），从而可以一次性安装多个行为包或资源包。
两种文件格式的区别如下图所示：

示例图

方法一：AddonHelper导入​

过期的内容

此部分内容已过期！

方法二：手动导入​

提示

适用服务端：BDS，LLBDS
不适用服务端：所有Nukkit系服务端

挺麻烦的，如果你是新建的服务器/世界为啥不试试第三种方法？

byd懒得配图了，方法二会用的自己用去，不会用的自己学。

第一步​

准备好你需要安装的Addon，并将Addon的行为包与资源包分离出来。 关闭服务器。

第二步​

在简幻欢控制台的文件页面，转到/worlds/<你的存档名字>/，先检查当前存档根目录下是否有world_behavior_packs.json文件和world_resource_packs.json文件(如果没有的话请自行创建)，然后再找到behavior_packs和resource_packs这俩文件夹。

第三步​

将addon的行为包放入behavior_packs文件夹，将addon的资源包放入resource_packs文件夹。

将行为包的uuid与版本号写入world_behavior_packs.json文件，再将资源包的uuid与版本号写入world_resource_packs.json文件。

格式如下图所示：

这方法是我从蓝天云那边借鉴的，欸嘿

提示

uuid与版本号在哪里？

在资源包/行为包的manifest.json内，如下图所示，红框内为uuid，绿框内为版本号：

shabi腾讯我csndm

第四步​

回到终端界面，重新开服，并检查addon是否正常加载。

方法三：替换世界文件夹​

提示

适用服务端：BDS，LLBDS
不适用服务端：所有Nukkit系服务端

警告

这种方法只适合在新世界安装Addon，旧有的世界无法安装！

第一步​

将你需要安装的addon先导入本地客户端，并创建一个新世界安装addon。
各个系统导入与安装方法请自行搜索教程。

第二步​

将整个存档文件夹导出并上传至服务器的worlds文件夹，并记下存档文件夹的名称(尽量使用英文)。

从客户端导出存档并上传至服务器的方法点这里。

例：此处我上传的新存档文件夹名称为Fontaine。

我是⑨
(请忽略这是个Windows窗口的事实，你把它想象成简幻欢的控制台就行了)

第三步​

回到服务器根目录，打开server.properties，找到下面这行配置：

level-name=Bedrock level
# Allowed values: Any string without semicolon symbol or symbols illegal for file name: /\n\r\t\f`?*\\<>|\":

将其中的Bedrock level更改为你上传的存档文件夹的名字。
例：在上一步中我上传的存档文件夹名为Fontaine，那么我就需要把Bedrock level更改为Fontaine，如下图所示：

Fontaine的中文是枫丹，原神启动！

第四步​

回到终端界面，重新开服，并检查世界是否正常加载。