### This tutorial is out of date and is being rewritten.  If you are in a hurry, you can read the Chinese version first
### This tutorial is out of date and is being rewritten.  If you are in a hurry, you can read the Chinese version first
### This tutorial is out of date and is being rewritten.  If you are in a hurry, you can read the Chinese version first

# GeyserModelEngine

> GitHub：https://github.com/zimzaza4/GeyserModelEngine

[English](README_EN.md) | [简体中文](README.md)

# About

it can let your Geyser server support  on MEG4

# How to install？

download this plugin

[GeyserUtils](https://github.com/zimzaza4/GeyserUtils)

[GeyserModelEngine](https://github.com/zimzaza4/GeyserModelEngine)

[LibsDisguises](https://www.spigotmc.org/resources/libs-disguises-free.81/)

After downloading, place GeyserModelEngine in the plugins folder

The `geyserutils-spigot`/`velocity`/`bungeecord` into the plugins folder

Put `geyserutils-geyser` into geyser extensions folder, and the installation is complete

# convert model

Open your bbmodel project file and convert the model to bedrock model

Open the newly converted model and delete the extra hitbox (if not, leave it alone)

<img src="docimg/hitbox.png" width="500">

Otherwise BE players will see this hixbox

<img src="docimg/hitbox1.jpg" width="500">

Then save to export the texture of the model

# install model

Open Geyser's extensions folder and create a folder called `geyserutils`, and then create a folder inside called `skins`

Now let's create a folder called the id of your model.  For example, if the id of the test model I use is `parry_knight`, I create a `parry_knight` folder

Your file path should look like this: 

`plugins/Geyser-Spigot/extensions/geyserutils/skins/modelid/`

Finally put the model and texture map in

<img src="docimg/example.jpg" width="500">

now restart your server to generated MEG4 model , your BE player should be able to see the model normally.

restart you server,summon model.We should be able to see the model normally

after that , it's about model's animation's part :

# model animation

let model's animation export to json format

named the animation file by `animation.modelID.json`

then put it into your resource pack

<img src="docimg/example1.jpg" width="500">

now let us open the animation file to starting change the animaiton ID

originally , all the `animationID` were basic named like  `idle` , `walk` , but now you should add a prefix

such as :

`idle` to `animation.modelID.idle`

example : `animation.parry_knight.idle`

after changed the resource pack 's version or uuid , pack the resource pack.

finally , restart the Geyser or server

# END

Congratulations ! now you exactly know how to use , if you still can't finish yet

well , maybe that's my problem = D

# restrictions

,,,,,a lot

# problems

### why I have generrated the model , but I got a steve ?

I guess that you have not wholly read this file..