Tutorial 【导航】BDS服务端 与 LiteLoaderBDS 新手教程 & 常见问答

image

为了帮助萌新可以更快速地掌握BDS插件服开服方法,避免反复提问求助,在这里聚合了一些常见的BDS服务端与LiteLoader加载器的教程与问答。
萌新可以从这里找到很多自己想知道的答案



BDS 与 LiteLoaderBDS 概述

对 Mojang 官方 Bedrock Dedicated Server 服务端和 LiteLoaderBDS 加载器项目进行简单的介绍。
Bedrock Dedicated Server(下面简称BDS)是 Mojang Studio 官方开发的基岩版服务端,为基岩版提供服务器运行支持。
BDS 拥有很多其他各种服务端没有的优势:

  • Mojang 官方领域服的开服选择。官方支持,稳定维护,不存在众多分支,不存在兼容问题,不存在停更问题
  • 完整的原版游戏内容,包括完整的原版游戏特性,支持全部 Addons 附加包使用,支持原版存档以及来自多种客户端的连接游戏,拥有正版验证,真正的原版开服体验
  • 开服简单易懂,插件仅作辅助功能,所有游戏特性在服务端内部即拥有,无需安装玩法拓展插件
  • 服务端使用 C++ 编写,性能优异,支持跨平台运行
  • Addons 生态历史悠久,插件生态发展迅速,在拓展方面有多种选择
LiteLoaderBDS 是一个非官方的 Minecraft 服务端插件加载器,为基岩版官方服务端 Bedrock Dedicated Server(以下简称BDS)提供 插件开发支持 和 插件加载服务,弥补了官方行为包开发接口长期以来存在的一些不足。

LiteLoaderBDS 提供了海量的API、强大的事件系统以及大量封装的开发基础设施接口,为拓展基岩版BDS的更多玩法和功能提供了坚实的基础。通过插件,可以很容易地拓展BDS的功能,相关开发易于学习,且开发方式比较灵活。
项目支持使用 C++,Golang,JavaScript,Lua,Python 等各种语言编写插件。同时,插件不需要随着BDS版本更新而不断修改代码,仅需本项目在底层适配更新即可,给插件开发与维护带来了很大的便利。

LiteLoaderBDS帖子链接:https://www.minebbs.com/liteloader/
GitHub 项目链接:https://github.com/LiteLDev/LiteLoaderBDS
LiteLoaderBDS 由三部分组成:
LL本体,LLScriptEngine脚本引擎、其他支持组件(如自动更新,CrashLogger 等)

  • LLSELLScriptEngine 脚本引擎的简称,意为 “LiteLoader 的脚本插件”。使用脚本语言编写插件,和 DLL 插件一样由LL加载运行
  • LXL:LLScriptEngine 脚本引擎的前身,在 LL2.1 版本中合并进入 LiteLoaderBDS 项目。如今,这个称呼等同为LLSE,也就是 LLScriptEngine 脚本引擎。
  • 所有的 “LLSE” 与 “LXL” 插件都可以使用 LiteLoader 进行加载,不同的称呼只是为了区分不同类型的插件。
由于 LXL 项目存在了相当长一段时间,很多腐竹已经养成了称呼习惯,因此 LXL 这个名字也就这么沿用下来

安装

在了解LiteLoaderBDS加载器的相关信息之后,下面给出相关的安装与使用教程:

BDS服务端相关
前往Mojang官方网站 BDS下载页面, 仔细阅读并同意EULA之后,下载Windows版BDS服务端
我们通过Wine支持运行Windows版BDS,来加载LiteLoaderBDS并使用插件,兼顾Linux服务器的高性能和BDS插件服的高可拓展性。
你可以选择我们提供的 Docker镜像 直接进行部署

加载器相关
前往 LL文档站 查看加载器安装说明

插件相关
既然都来到MineBBS了,不要错过这个全球最大的BDS插件论坛中心。
前往 资源中心 下载LL插件。
注意资源前面的类型前缀需要是 ”LL“ 或者 “LXL” 或者 “LLSE”
将插件解压(如果需要的话),将得到的所有内容都移动到plugins目录下,即安装完成。
开服运行即可


升级服务端 / 加载器

由于插件加载器工作原理的特殊性,一般来说 每个BDS服务端版本都有其对应的加载器版本。在安装 / 升级时,必须使用正确版本的服务端与加载器,服务器才可以正常工作。

考虑到项目维护工作量,一般来说,LL加载器将一直 跟随当前最新版本BDS 进行版本更新、bug修复以及功能更新。
如果你希望第一时间获取新功能、新接口以及安全更新,那么你需要时刻将BDS与加载器 保持在最新版本

下面聚合了一些常见的升级教程,希望可以帮到你:


一般来说,BDS版本升级意味着加载器也需要进行更新,以适配最新的BDS。
因此,在你得知BDS版本升级之后,请首先通过各个渠道(如论坛、Q群等)了解加载器的适配情况。在加载器已经适配完毕并且发布最新版之后,再进行BDS服务端的更新。

如果你需要更新BDS服务端,请遵循如下步骤:

  1. 在你旧的BDS服务端目录中删除几个文件夹:behavior_packs、definitions、resource_packs、structures,删除文件bedrock_server.pdb
  2. 从上面提到的 Mojang官方网站 BDS下载页面 下载最新版本的BDS Windows版服务端压缩包
  3. 将下载得到的压缩包解压,将其中的behavior_packs、definitions、resource_packs、structures 文件夹以及 bedrock_server.exe、bedrock_server.pdb 文件复制到你旧的BDS服务端目录中
  4. (可选步骤)检查是否要更新BDS配置文件 server.properties。如果需要的话顺手更新,并搬运设置项
接下来进行LL加载器的更新:
  1. 从 论坛 或者 GitHub 下载最新版本的LL加载器,务必仔细查看是否已经适配最新版本BDS
  2. 将下载得到的压缩包解压,将解压出的所有内容复制,直接粘贴到 BDS服务端根目录中
  3. 如果复制的过程中提示文件冲突,选择 覆盖 即可
  4. (关键步骤)运行 SymDB2.exe 重新生成符号数据库,并等待执行完毕
安装全部完成。一般来说,接下来运行 bedrock_server_mod.exe 即可正常开服。
如果在升级之后,你碰到了部分插件无法正常工作的问题,或者出现崩溃等问题,请查看下面的 常见问题 栏目
由于LL加载器自身拥有自动更新推送能力,因此在需要更新时,你可以先尝试使用 ll upgrade 命令在控制台进行自动更新。在自动更新无效的情况下,再手动进行更新。

如果你需要手动升级LL加载器,请首先进行确认:你要升级的LL版本是 适配 你当前正在使用的BDS的。安装错误版本的LL将导致崩溃等一系列问题。
如果你不确定,请 参考上面一个栏目的教程,同时把LL和BDS升级到最新

LL加载器升级步骤:

  1. 从 论坛 或者 GitHub 下载最新版本的LL加载器,务必仔细查看是否已经适配最新版本BDS
  2. 将下载得到的压缩包解压,将解压出的所有内容复制,直接粘贴到 BDS服务端根目录中
  3. 如果复制的过程中提示文件冲突,选择 覆盖 即可
升级完毕。一般来说,接下来运行 bedrock_server_mod.exe 即可正常开服。
如果在升级之后,你碰到了部分插件无法正常工作的问题,或者出现崩溃等问题,请查看下面的 常见问题 栏目
旧版BDS无法使用新版LL和插件
如果需要使用,请 参考上面栏目的教程,同时把LL和BDS升级到最新

常见问题

服务器工作异常

插件异常

寻求帮助的方法有很多,你可以从多个渠道进行问题反馈和求助
  1. 在 MineBBS 论坛搜索相关问题,查看有无相关帖子说明;也可以在问答板块发帖提问
  2. 前往 LL 加载器帖,在最下方联系方式栏目中加入QQ群,在群中寻求群友帮助
  3. 如果你认为这个问题由加载器本身导致,请前往 GitHub Issues 反馈问题: https://bugs.litebds.com/new/choose

插件开发

欢迎前往 LL文档站 查看插件开发文档与教程

待续。。。
 
Last edited by a moderator: