[单脚本][MyClearCamp] 简易的阵营管理系统 已适配027

在制作含有阵营、队伍相关逻辑的游戏时， 总是缺少一个开盒即用的阵营、得分管理系统
于是就写了个MyClearCamp，用于默认分配阵营，封装了自定义加入阵营、队伍等功能
懒得写阵营管理的同学可以试试MyClearCamp咯！
1. 安装MyClearCamp
MyClearCamp.ts (31.88 KB, 下载次数: 111)

2024-6-16 19:04 上传

点击文件名下载附件
* 更新日志：
* 版本：v0.1.6 2024.6.16
* 1. 将阵营信息同步改为RPC和不可靠RPC
* 2. 删除默认的阵营最后一个离开时分数归零的设定

* 历史版本：
* 版本：v0.1.5 2024.1.24
* 1. 对getCharacterCamp用到的map做判空处理，减少报错
* 版本：v0.1.4 2024.1.14
* 1. 修整方法和事件，并给事件添加参数、回调
* 2. 将事件和方法改成静态，减少时序问题
* 3. 新增支持Gameobject的阵营
下载脚本，导入到工程内容中，拖一个脚本到场景里即可
在其他脚本中使用 MyClearCamp.方法名 就可以调用方法
2. 默认阵营设定
PlayerID_CampID_Map: Map<string, string> 维护了PlayerID和CampID的map
CampID = 0 的时候，为默认阵营，默认阵营与其他所有阵营都为友好关系
可以在onPlayerJoin()方法里，设置玩家进游戏时是要加入默认阵营、随机阵营、人最少的阵营
3. 玩家加入阵营
这里的玩家id用的是 player.getUserId()
3.1 加入指定阵营
这样会加入指定id的阵营
服务器调用 MyClearCamp.PlayerJoinCamp(指定玩家id, 阵营id)
3.2 加入随机阵营
这样会加入除0号默认阵营以外的阵营
服务器调用 MyClearCamp.PlayerJoinRandomCamp(指定玩家id)
3.3 加入人最少的阵营
这样会加入除0号默认阵营以外的、人数最少阵营，一般用于战地之类的双方对决时的补位
服务器调用 MyClearCamp.PlayerJoinWeakCamp(指定玩家id)
3.4 阵营改变时触发客户端方法
如果玩家的阵营改变了，对应玩家客户端会触发 onMyCampChanged(旧ID，新ID) 方法
UI或其他C端脚本里可以写

MyClearCamp.onMyCampChanged.push((OldCampID,NewCampID)=>{

    // 这里填阵营改变后的处理

    if(NewCampID=="2"){

        // 修改UI或者其他

    }

})

这里就可以添加自己的一些逻辑，如本地UI的改变、得分的改变等等
4. 判断玩家间友好/敌对关系
双端调用MyClearCamp.isFriendly(玩家1的id, 玩家2id)的回调值，可以知道是否为友好、敌对
当 CampID = 0 的时候，为默认阵营，默认阵营与其他所有阵营都为友好关系
5. 可能的拓展方向
阵营、公会、门派、小队等，本质上都可以从这个MyClearCamp的基础逻辑中进行魔改
公会、门派： 需要离线存储，还有各种职务、门派人数设定、申请、审批、任职等相关逻辑
小队：需要设定UI、队长、邀请、加入、退队等逻辑
也希望有同学可以在这个MyClearCamp的基础上进行魔改，添加自己的逻辑，创建出更多阵营like的功能脚本、分享出来！~
6. 实用接口与拓展
这里还提供了一些实用的接口，方便大家进行接入和二创~
6.1. 功能方法

方法名	调用端	注释	参数	返回值
isFriendly	双端	[双端] 检查两个ID是否为友军	charInstanceID1: string charInstanceID2: string	是否为友军
CharcterJoinCamp	服务器端	[仅服务器] 指定NPC或玩家角色加入指定阵营	charInstanceID: string CampID: string	-
CharcterJoinRandomCamp	服务器端	[仅服务器] 指定NPC或玩家角色加入随机阵营，但不会加入0这个保留位阵营	charInstanceID: string	-
CharcterJoinWeakCamp	服务器端	[仅服务器] 指定NPC或玩家角色加入人最少的阵营，不含0号保留位	charInstanceID: string	-
CharcterJoinANewCamp	服务器端	[仅服务器] 指定NPC或玩家角色无视最大阵营数，加入一个新阵营，但不会加入0这个保留位阵营，并返回加入的阵营id	charInstanceID: string	返回加入的阵营id
dispartCamp	服务器端	[仅服务器] 解散一个阵营，返回原阵营的角色实例IDList，并将原阵营的NPC或玩家角色遣返至0号阵营	CampID: string	返回原阵营的CharcterList
getCamps	服务器端	获取所有阵营id列表，从charInstanceID-campid获取	-	返回阵营id的数组
getCampMembers	服务器端	获取指定阵营下的所有NPC或玩家角色id	CampID: string	返回所有NPC或玩家角色id的数组
getCampMembersNum	服务器端	获取指定阵营下的NPC或玩家角色数量	CampID: string	返回指定阵营的NPC或玩家角色数量
getCampScore	服务器端	获取指定阵营得分	CampID: string	返回阵营的得分
getCharcterCamp	服务器端	获取指定NPC或玩家角色的阵营id	charInstanceID: string	返回该NPC或玩家角色的阵营id
setCampScore	服务器端	[仅服务器] 设置指定阵营得分	CampID: string NewScore: number	-
addCampScore	服务器端	[仅服务器] 给指定阵营增加得分	CampID: string AddScore: number	-
getInstanceIDByChar	双端	[双端] 获取角色的实例id	char: Character	返回角色实例id
getCharByInstanceID	双端	[双端] 获取实例id对应的角色	instanceID: string	返回角色
checkIfNPC	双端	[双端] 检查ID或者角色是否为NPC	IDorChar: string||Character	返回是否为NPC的布尔值

6.2. 事件接口

事件名称	调用端	参数	描述
onMyCampChanged	仅客户端	OldCampID: string	当前客户端NPC或玩家角色的旧阵营ID
	仅客户端	NewCampID: string	当前客户端NPC或玩家角色的新阵营ID
onCampScoreChanged	双端	CampID: string	阵营ID
		NewScore: number	新的阵营得分
		oldScore?: number	旧的阵营得分，如果是新阵营则不传递
onCharcterCampChanged	双端	charInstanceID: string	NPC或玩家角色ID
		OldCampID: string	旧的阵营ID
		NewCampID: string	新的阵营ID

666

当前使用此单脚本会由于Map为空值报错。根据game.js定位到此处代码。
建议在forEach之前，先进行if判断。

  /** 获取指定NPC或玩家角色的阵营id

   * @param charInstanceID 指定NPC或玩家角色的id

   * @returns 该NPC或玩家角色的阵营id

   */

  public static getCharcterCamp(charInstanceID: string): string {

    let myCamp = "";

    // 遍历charInstanceID_CampID_Map，取出符合charInstanceID的CampID

    // if (MyClearCamp.instance.charInstanceID_CampID_Map.size > 0) {

    MyClearCamp.instance.charInstanceID_CampID_Map.forEach((value, key) => {

      if (key == charInstanceID) {

        myCamp = value;

      }

    });

    // }

    // 返回符合charInstanceID的CampID

    return myCamp;

  }

躲猫猫作者_思想的鱼 发表于 2024-1-23 23:03
当前使用此单脚本会由于Map为空值报错。根据game.js定位到此处代码。
建议在forEach之前，先进行if判断。
...

已更新 感谢反馈！