[单脚本][MyClearRandomWarps] 好用的随机/定向传送管理已适配027

叽里咕噜小胡桃 · 发表于 2023-5-28 17:57:58

本帖最后由叽里咕噜小胡桃于 2023-12-15 10:20 编辑

在日常游戏脚本编写中，随机/定向传送玩家到指定的位置，一直是一个比较繁琐的部分
这需要我们非常麻烦地去取坐标、写脚本，而这一系列流程非常不直观、不方便
因此我写了一个MyClearRandomWarps，在原模块RandomSpawn的基础上进一步封装，增加了很多实用功能
一起来看看它都能做些什么吧！

1. 安装MyClearRandomWarps

MyClearRandomWarps.ts (10.9 KB, 下载次数: 76)

2023-12-15 10:18 上传

点击文件名下载附件

* 版本：v0.1.3 2023.12.03
* 更新日志：
* 1. 修整方法和事件，并给事件添加参数、回调
下载脚本，导入到工程内容中，拖一个脚本到场景里即可
在其他脚本中使用 MyClearRandomWarps.instance.方法名就可以调用方法
2. 如何添加传送地标？
2.1 编辑态在主视口中添加传送地标
在场景中想传送的地方摆放一个作为传送地标的物体(纯S端关闭碰撞)，并在tag中打上“传送点”三个字
tag中含有“传送点”的物体，会在脚本初始化三秒后被找出来，并根据物体的名字创建对应的传送点
建议使用 34675,34678,34681 这类旗帜，传送点是可以改变玩家角色的朝向的

已适配027
2.2 运行态动态创建传送地标
可以使用 MyClearRandomWarps.instance.ServerAddWarpByGobj(需要传送坐标的物体, 传送点名称) 动态创建传送地标
也可以用 MyClearRandomWarps.instance.ServerAddWarpsByLocationAndYaw(传送点的location, 传送后角色的朝向, 传送点名称) 动态创建传送地标
3. 如何随机传送/定向传送
这个脚本维护了一个 id_warps_map: Map<string, Gameplay.GameObject[]>，它储存了<传送点名称，传送点合集>的一个键值对
如果某个传送点的合集里只有一个传送点，那每次都会传送到这一个传送点，就可以实现地标的定向传送
而如果某个传送点的合集里有很多个传送点(即场景里有很多个同名的带了"传送点"tag的物体)，则在传送的时候就会随机选一个传送点进行传送
4. 如何传送玩家到传送点
可以通过调用 MyClearRandomWarps.instance.ServerWarpPlayer(player, 传送点名称) 进行传送
也可以通过调用 MyClearRandomWarps.instance.ServerWarpPlayers(player数组, 传送点名称) 批量传送玩家，不过如果传送点合集里有很多个传送点的话，大家是随机传送到不同的点，这样就能实现类似于开局随机散开玩家到游戏里各个角落的功能
5. 实战案例
5.1 定点传送

触发器里的脚本

import MyClearRandomWarps from "./MyClearRandomWarps"

@Core.Class

export default class WarpToWar extends Core.Script {

    /** 当脚本被实例后，会在第一帧更新前调用此函数 */

    protected onStart(): void {

        if (SystemUtil.isServer()) {

            let trr = this.gameObject as Gameplay.Trigger

            trr.onEnter.add((gobj) => {

                if (gobj instanceof Gameplay.Character) {

                    MyClearRandomWarps.instance.ServerWarpPlayer(gobj.player,"战场传送点")

                }

            })

        }

    }

}

5.2 阵营对抗的随机传送

就是在5.1的脚本基础上，将"战场传送点"改成对应的传送名如“红方传送点”、“蓝方传送点”
5.3 效果演示

5.4 拓展的可能
这个脚本可以理解为一个传送点管理器，动态创建坐标的方法可以拓展出像生存游戏那样，给玩家设置家，然后玩家可以传送回家
另外示例里展示的脚本，里面的传送点名可以通过脚本属性的形式暴露出来，作为一个通用的传送门，挂在触发器下时，只需要配置一下

6. 实用接口与拓展
6.1 功能方法

方法	功能	输入	返回
ServerWarpPlayer(player: Player, WarpName?: string)	[服务器] 服务器将玩家传送到指定传送点序列
ServerWarpPlayers(players: Player[], WarpName?: string)	[服务器] 将玩家组传送到指定传送点序列

6.2 事件接口

事件	描述	变量	备注
onPlayerWarped: ((eventPlayer: Player, Distance: number, lookYaw: number, WarpName?: string) => void)	[双端] 当玩家被传送