[单脚本][MyClearRide] 坐骑|乘骑功能，为你的角色骑上彩虹小白马吧！

叽里咕噜小胡桃 · 发表于 2024-2-6 18:39:36

本帖最后由叽里咕噜小胡桃于 2024-8-15 14:25 编辑

0. 更新日志

MyClearRide.ts (65.89 KB, 下载次数: 90)

2024-8-15 14:25 上传

点击文件名下载附件

1. 效果演示&Json分享
彩虹小白马.gif

{"name":"彩虹小白马","GUID":"174968","Loc":{"x":20,"y":0,"z":-30},"Rota":{"x":0,"y":0,"z":0},"Scal":{"x":3,"y":3,"z":3},"ZOffset":90,"MainCharStanceGUID":"175598","RideCharAnimGUID":"150774","MoveAnimRate":1,"AttachInfo":"298414-0","ExtraJsonInfo":""}

修猫.gif

{"name":"修猫","GUID":"160412","Loc":{"x":20,"y":0,"z":-55},"Rota":{"x":0,"y":0,"z":0},"Scal":{"x":3,"y":3,"z":3},"ZOffset":90,"MainCharStanceGUID":"175598","RideCharAnimGUID":"150774","MoveAnimRate":1,"AttachInfo":"298124-2","ExtraJsonInfo":""}

爬行柴犬.gif

{"name":"爬行柴犬","GUID":"229674","Loc":{"x":10,"y":0,"z":-60},"Rota":{"x":0,"y":-90,"z":0},"Scal":{"x":1.5,"y":1.5,"z":1.5},"ZOffset":110,"MainCharStanceGUID":"175598","RideCharAnimGUID":"107637","MoveAnimRate":1.5,"AttachInfo":"","ExtraJsonInfo":""}

水龙.gif

{"name":"水龙","GUID":"248837","Loc":{"x":10,"y":0,"z":-60},"Rota":{"x":0,"y":0,"z":0},"Scal":{"x":4,"y":4,"z":4},"ZOffset":110,"MainCharStanceGUID":"175598","RideCharAnimGUID":"160618","MoveAnimRate":1,"AttachInfo":"","ExtraJsonInfo":""}

{"name":"小飞猪","GUID":"159590","Loc":{"x":25,"y":0,"z":-35},"Rota":{"x":0,"y":0,"z":0},"Scal":{"x":1.2,"y":1.2,"z":1.2},"ZOffset":90,"MainCharStanceGUID":"175598","RideCharAnimGUID":"181293","MoveAnimRate":1,"AttachInfo":"298419-2","ExtraJsonInfo":""}

冰怪背人.gif

{"name":"冰怪背人","GUID":"178922","Loc":{"x":5,"y":0,"z":80},"Rota":{"x":0,"y":0,"z":0},"Scal":{"x":1,"y":1,"z":1},"ZOffset":10,"MainCharStanceGUID":"35403","RideCharAnimGUID":"191847-3","MoveAnimRate":1.5,"AttachInfo":"","ExtraJsonInfo":""}

2. 接入方法
1. 下载导入单脚本
2. 从资源库拖出一个空锚点
3. 将单脚本挂载到空锚点上，运行编辑器
4. 通过API调用事件和方法实现乘骑、取消乘骑

3. 参数讲解

都在图里了，我就挑重点讲哈~
主角动画和坐骑动画的guid后面可以跟slot
例如 175598-2
人物插槽见：https://api-docs.ark.online/enums/mw.AnimSlot.html
另外029有非人类插槽，编辑器更新后就可以看到了：

移动动画速率倍率：有些动画受不同动物体型、速度影响可能不适用，可以调节这个倍率以控制脚的动作速率，值越大越快
挂件信息：支持预制体，示例里数字的guid是我上传到资源库后的数字id，方便大家演示使用
额外JSON：在乘骑时传递额外的信息，是结构体数据json化后的string文本，可以结合onMyCharRideSuccess.add((rideName, ExtraJSONInfo)=>{ // 在这里填写缩放视角，修改速度的方法 }) 来达到更多拓展功能

4. 实用功能方法
CID是指CharacterInstanceID，如果是玩家角色就是userid，如果是NPC就是npc的gameobjectId
4.1 功能方法
使用 MyClearRide.方法(参数) 进行调用

方法	用途	调用端	参数	类型	说明	返回值
rideNow(CID: string, rideName: string, myRideJsonString?: string)	让指定CID的角色进行骑乘，会先删除旧有的坐骑	[双端]	CID	string	角色的CID
			rideName	string	骑乘的名称，会从属性中的骑乘拿
			myRideJsonString	string	[选填]自定义骑乘JSON，会使ridename失效
delRideNow(CID: string)	让指定CID的角色移除坐骑	[双端]	CID	string	角色的CID
getRideCharByCID(CID: string): Character	通过CID获取乘骑的Character	[仅服务器]	CID	string	角色的CID	乘骑的Character对象
addRideAttachByString(CID: string, AttachInfo: string): boolean	通过AttachInfo为CID的乘骑Character添加挂件	[仅服务器]	CID	string	角色的CID	是否添加成功
	通过AttachInfo为CID的乘骑Character添加挂件	[仅服务器]	AttachInfo	string	挂件string信息	是否添加成功

4.2 事件接口
使用 MyClearRide.事件.add((参数)=>{其他方法}) 进行调用

事件	触发机制	调用端	参数	类型	说明
onCharRideSuccess	当角色成功骑乘	[仅服务器]	CID	string	角色的CID
			rideName	string	骑乘的名称，会从属性中的骑乘拿
			ExtraJSONInfo	string	额外Json信息，使用JSON.Parse(ExtraJSONInfo) 可以获取结构体里的信息
onCharDelRide	当角色被移除骑乘	[仅服务器]	CID	string	角色的CID
onMyCharRideSuccess	当当前玩家角色成功骑乘	[仅客户端]	rideName	string	骑乘的名称，会从属性中的骑乘拿
onMyCharRideSuccess	当当前玩家角色成功骑乘	[仅客户端]	ExtraJSONInfo	string	额外Json信息，使用JSON.Parse(ExtraJSONInfo) 可以获取结构体里的信息
onMyCharDelRide	当当前玩家角色被移除骑乘	[仅客户端]	/

5. 已知问题
Q：角色抬高处理怎么做的,还能正常踩到地面吗？
A：可以仔细看帖子里那个详解图，用的 https://api-docs.ark.online/classes/mw.Character.html#meshoffset 去抬高角色的mesh，实际上角色的胶囊体还在原地大小、位置没变，所以加了个extrajson 可以在乘骑的时候自己解析这个json去做胶囊体变换