[LiteLoaderBDS插件编写教程] - 03 玩家对象(Player)

无情***

01.什么是玩家对象

    玩家对象储存了某一个玩家的数据(如名字 uuid IP地址等等)我们暂且将它们称为参数
     参数分为两种: 可读取参数与可修改参数
     可读取参数，就是可以读取的参数，可以把读取的数据存放在一个变量、数组等等中，有的可以被修改，而有的不能被修改
     可修改参数可以将玩家的某个参数设置为特定的值


02.代码实现
    和之前一样，把基础代码准备好(之后就不再提了)
     
     我们首先要获取一个玩家参数，于是就可以用上篇教程的事件监听
     我们以"onChat"为例(监听玩家发送聊天消息)

1. mc.listen("onChat", (pl, msg)=>{
   
2. 
   
3. })  
   
4. //pl为玩家对象，msg则为发送的文本

复制代码

      这样就获得了一个玩家对象"pl"
     在事件监听里，可以使用return false来阻止某些事件发生
     那么就可以制作出一个违禁词检测程序
   

1. let wordList = ["我是违禁词", "test"]
   
2. mc.listen("onChat", (pl, msg)=>{
   
3.     if(wordList.includes(msg)){
   
4.         pl.tell("请不要说违禁词")
   
5.         return false
   
6.     }

复制代码

     

1. 
   

复制代码

03.格式


     一般，可读取参数是 "玩家对象.参数名称" 这种格式
     比如:
     

1. pl.name //玩家名称
   
2. pl.xuid //玩家xuid

复制代码

   而可修改参数通常为 "玩家对象.函数(函数参数)" 这种格式
   如:
   

1. pl.sendToast(title,message) //在指定玩家屏幕上方显示消息(类似于成就完成)
   
2. pl.tell(msg) //向指定玩家发送消息

复制代码

   当然，也有些特殊的可读取/修改参数
   如:
   

1. pl.isOP() //判断玩家是否是OP
   
2. //乍一看像一个可修改参数，但是它是可读取参数
   

复制代码

   更多的参数可以去官方开发文档查看
   

指尖轻***

感谢分享！！！