Merge pull request #64 from TATyKeFei/main

完善Geyser进阶教程
This commit is contained in:
lilingfengdev 2024-06-05 21:14:19 +08:00 committed by GitHub
commit ab869cd39b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
5 changed files with 153 additions and 88 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 MiB

View File

@ -0,0 +1,21 @@
---
sidebar_position: 6
---
# 字体图像转换
## AZPixel-Team的Java2Bedrock
:::tips
注意字体偏移是Java版独有的基岩版没有这个功能因此一些利用字体偏移做到的东西如IA菜单需要你写jsonui
我非常建议使用这个来管理基岩版的字体资源包,否则你的字体图像管理是非常痛苦的
:::
#### 如何使用
跟[这里](https://nitwikit.yizhan.wiki/%E6%89%A9%E5%B1%95%E9%98%85%E8%AF%BB/%E6%89%8B%E6%9C%BA%E7%8E%A9%E5%AE%B6%E6%94%AF%E6%8C%81/Geyser/%E8%BF%9B%E9%98%B6/%E6%9D%90%E8%B4%A8%E5%8C%85%E8%BD%AC%E6%8D%A2#%E6%93%8D%E4%BD%9C%E6%AD%A5%E9%AA%A4)基本没有区别
但是在填写资源包下载地址地方的下面,要把`Font Conversion`选项设置为Ture

View File

@ -13,22 +13,27 @@ sidebar_position: 1
## 资源包安装
你可以像Java版玩家一样给基岩版玩家发送服务器资源包
但与Java版玩家不同的是 基岩版玩家可以接受并加载多个资源包
:::warning
基岩版资源包与Java版格式完全不同 需要手动进行转换
基岩版的资源包扩展名均为.mcpack
基岩版的资源包扩展名均为.mcpack(其实.zip也行)
资源包转换在后续教程会提及
:::
此外基岩版不需要额外创建直链下载的链接, 直接通过服务器即可传输资源包
首先找到Geyser的配置文件夹 可以注意到里面有个packs文件夹
将资源包放入文件夹后重载Geyser即可
来到`服务端/plugins/geyser-spigot/packs/`目录
将资源包放入Packs文件夹后, 重载/Geyser reload或重启服务器即可
注意!重载Geyser来加载资源包可能会导致一些奇怪的问题发生没事还是建议重启服务器来加载资源包
## 优化兼容性
目前, 你服务器的基岩版玩家可能会遇到一些问题
像是卡在竹子中间, 缺少一些Java版独有的粒子 物品材质之类的
我们可以通过安装额外插件或资源包来对客户端和服务端进行额外的修改来完成兼容
像是卡在竹子中间缺少一些Java版独有的粒子物品材质之类的
我们可以通过安装额外插件来对客户端和服务端进行额外的修改来完成兼容
### Hurricane插件
此插件可以修复:
@ -44,7 +49,7 @@ sidebar_position: 1
### 皮肤
在安装Floodgate后 Java版玩家可以看到基岩版玩家的皮肤
但是在离线服务器, 我们为了让皮肤可以正确显示, 一般会安装额外的皮肤插件
但是在离线服务器, 为了让皮肤可以正确显示, 一般会安装额外的皮肤插件
这时, 基岩版玩家的皮肤显示又会变的不正常
我们可以通过安装GeyserSkinManager插件来解决这个问题
@ -62,14 +67,14 @@ GeyserSkinManager有不同版本
:::warning
BedrockSkinUtility仅支持1.19.4以下使用Fabric的客户端
BedrockSkinUtility仅支持 Fabric 1.20.2 以下的版本
:::
### GeyserOptionalPack
GeyserOptionalPack是一个资源包
它通过修改基岩版本身来实现一些Java版中独有的功能或特性
GeyserOptionalPack是一个可选资源包
它通过资源包来实现一些Java版中独有的功能或特性
你可以在 [此处](https://download.geysermc.org/v2/projects/geyseroptionalpack/versions/latest/builds/latest/downloads/geyseroptionalpack) 下载
@ -78,13 +83,13 @@ GeyserOptionalPack是一个资源包
- 盔甲架底座武器/底板可见性
- 盔甲架姿势
- 幻术师
- 缺失的粒子
- 部分缺失的粒子
- 副手动画
- 潜影贝隐形平等性
- 发光箭实体纹理
- 超过记分板字符限制的绕过方式
- 隐藏在Java版中不存在的UI元素例如
- 制图中的文本输入字段
- 发光箭实体纹理 (没有实体描边渲染,只有纹理)
- 提供超过记分板字符限制的绕过方式
- 隐藏在Java版中没有的UI元素例如
- 制图中的文本输入字段
- 创造模式下的2x2工作台
- 命令方块菜单中的时钟延迟和重命名字段
- Java版中不存在的结构方块选项
@ -124,7 +129,21 @@ GeyserUtils是zimzaza4开发的Geyser扩展工具
## floodgate-skript
一个Skript扩展插件可以在Skript中检测基岩玩家
一个Skript扩展插件可以在Skript中使用FloodgateAPI检测基岩玩家
示例:
```
#玩家加入服务器后执行事件
on join:
trigger:
#如果玩家是通过floodgate加入服务器就执行此指令
if player is from floodgate:
make console execute command "say %player%是基岩版玩家"
#如不是就让控制台执行此指令
else:
make console execute command "say %player%是JAVA版玩家"
```
## LuckBedrock
@ -148,13 +167,13 @@ GeyserUtils是zimzaza4开发的Geyser扩展工具
[注意事项]
- 不要使用允许基岩版绕过的登录插件
- 一定要启动own-linking 关闭global-linking
- 一定要启动 own-linking 关闭 global-linking
## BedrockPocketUIWarn
[下载地址](https://github.com/lilingfengdev/BedrockPocketUIWarnBuild/releases/tag/latest)
用于警告基岩版玩家不要使用Pocket UI
用于警告基岩版玩家不要使用`携带版UI`进服
## GeyserUpdater
@ -164,7 +183,7 @@ GeyserUtils是zimzaza4开发的Geyser扩展工具
## GeyserBlockJavaPlayers
阻止 Java 玩家加入您的服务器 - 使您的服务器/子服务器仅 Bedrock
让你的Java服务器仅基岩版玩家才能加入
[下载](https://ci.kejonamc.dev/job/GeyserBlockJavaPlayers/job/master/)
@ -176,7 +195,7 @@ GeyserUtils是zimzaza4开发的Geyser扩展工具
## GeyserVoice
GeyserVoice 是一个 Java 插件,旨在通过集成 VoiceCraft Proximity Chat 应用程序来增强 Minecraft 服务器上的多人游戏体验。该插件促进了跨平台通信,允许 Java 和 Bedrock 版本的玩家无缝地参与基于邻近的语音对话。
GeyserVoice 是一个 Java 服务端插件,旨在通过集成 VoiceCraft Proximity Chat 应用程序来增强 Minecraft 服务器上的多人游戏体验。该插件促进了跨平台通信,允许 Java 和 Bedrock 版本的玩家无缝地参与基于邻近的语音对话。
[下载](https://github.com/SineVector241/VoiceCraft-MCBE_Proximity_Chat/releases/)[wiki](https://github.com/mineserv-top/GeyserVoice/wiki/)
@ -185,3 +204,13 @@ GeyserVoice 是一个 Java 插件,旨在通过集成 VoiceCraft Proximity Chat
PickPack 允许您为每个间歇泉玩家提供打开或关闭基岩资源包的选项。不幸的是,由于 Bedrock 的工作方式,重新连接是必要的 - 但要无缝完成。 这对于无法轻松安装资源包(例如控制台)的主机玩家非常有用,或者只允许每个玩家自定义要使用的包。
[下载](https://github.com/onebeastchris/PickPack/releases/tag/latest)
## GeyserExtras
此插件为Geyser提供了JE攻击冷却指示器样式
![](_image/GeyserExtras.gif)
还有类似Java版TAB查看在线玩家、游戏内切换资源包等功能可以自己去项目地址看
[项目地址](https://github.com/GeyserExtras/GeyserExtras)

View File

@ -1,69 +0,0 @@
---
sidebar_position: 5
---
# 材质包转换
## 人工手写
(施工中)
## Kas-tle的java2bedrock
java2bedrock.sh(底下简称转换器)是一个自动资源包转换工具可以将JAVA版的资源包转化成基岩版资源包的工具
:::tips
不建议过度依赖转换器,转换器并非是完美的存在,他依然存在一些缺陷
:::
[项目地址](https://github.com/Kas-tle/java2bedrock.sh)
### 本地使用
:::tips
转换器需要在linux系统上运行如果你使用WINDOWS你可以选择wsl或者虚拟机
:::
本地运行你只需要执行
```
./converter.sh 我的资源包.zip
```
如果你需要更加复杂的转换请查看项目的Github
### 在线转换
:::tips
你需要拥有一个GitHUB账号才可以
:::
#### 操作步骤
* 首先你需要新建一个Issue
* 在类型选择**Pack Conversion**
* 在**Java Pack Direct Download URL** 填上你的资源包下载地址(不能是网盘,要求是直链)
* 最后勾上最下面的用户协议,点击开始就可以
* 转换好后有个机器人会提醒你去Github Action下载下载就来就是转换后的基岩版资源包
# 字体转换
## AZPixel-Team的Java2Bedrock
:::tips
我是建议用这个来管理基岩版的字体资源包,否则你的字体管理是非常痛苦的
注意字体偏移是Java版独有的基岩版没有这个功能因此一些利用字体偏移做到的东西如IA菜单需要你写jsonui
:::tips
#### 如何使用
跟上面基本没有区别,但是在填写资源包下载地址的地方下面,要把`Font Conversion`选项设置为Ture

View File

@ -0,0 +1,84 @@
---
sidebar_position: 5
---
# 自定义物品模型映射
Geyser提供了自定义物品映射功能可以为CustomModelData物品注册基岩版行为以实现自定义物品
## Kas-tle的java2bedrock
java2bedrock.sh(俗称转换器)是一个自动资源包转换工具可以将JAVA版的资源包转化成基岩版资源包的工具
:::tips
不建议过度依赖转换器,转换出来的资源包也仅供参考学习,没有手写的效果好,不过如果你能接受也不是不能用
转换器并非是完美的存在,他依然存在许多缺陷
:::
[项目地址](https://github.com/Kas-tle/java2bedrock.sh)
### 本地使用
:::tips
转换器需要在linux系统上运行如果你使用WINDOWS你可以选择wsl或者虚拟机
:::
本地运行你只需要执行
```
./converter.sh 资源包名称.zip
```
如果你需要更加复杂的转换请查看项目的Github
### 在线转换
:::tips
你需要拥有一个GitHUB账号才可以
:::
#### 操作步骤
* 首先你需要新建一个Issue
* 在类型选择**Pack Conversion**
* 在**Java Pack Direct Download URL** 填上你的资源包下载地址(不能是网盘,要求是直链)
* 最后勾上最下面的用户协议,点击开始就可以
* 转换好后有个机器人会提醒你去Github Action下载下载就来就是转换好的基岩版资源包
* 将
## 人工手写映射
:::tips
此教程需要你有一定的动手和理解基岩版资源包结构,你可以动脑去看[基岩版资源包模板](https://github.com/Mojang/bedrock-samples/releases)学习
此教程假设你已能熟练使用ItemsAdder插件、并且正在边看[Geyser Wiki](https://wiki.geysermc.org/geyser/custom-items/)边看这文档学着做
:::
#### 物品映射
这里我非常推荐使用[Geyser Wiki](https://wiki.geysermc.org/geyser/custom-items/)中的Json映射
(施工中)
#### 手持3D模型
(施工中)
#### 饰品(帽子翅膀类)
(施工中)
#### 自定义方块映射
[Geyser自定义方块映射](https://wiki.geysermc.org/geyser/custom-blocks/)
(施工中)