ArenaEdit API手册

Appearance

基础信息 ​

属性 ​

name ​

玩家的昵称。

定义于 #L11749

点击查看示例代码
javascript
// 在所有玩家中，通过玩家名称筛选出某一位玩家
const myPlayer = world.querySelectorAll('player').filter(e => e.player.name === '吉吉喵')[0];
javascript
// 如果'吉吉喵'和'魔术喵'加入游戏，会被缩小到0.25倍。其他玩家不受影响
const TEST_PLAYER = ['吉吉喵', '魔术喵']

world.onPlayerJoin(({ entity }) => {
    if (!TEST_PLAYER.includes(entity.player.name)) return
    entity.player.scale = 0.25;
})

userId ​

玩家的用户ID，个人中心昵称下方可见。

定义于 #L11753

boxId ​

玩家的Box ID(3-15字符)。

定义于 #L11761

信息

该属性已不推荐使用，建议使用 entity.player.userId 获取玩家ID。

userKey ​

玩家的唯一识别码(16字符)，可以用于存储玩家信息到数据库，无法控制更改。

定义于 #L11757

信息

该属性已不推荐使用，建议使用 entity.player.userId 获取玩家ID。

avatar ​

玩家的头像url直链。

定义于 #L11765

movementBounds ​

默认值：new GameBounds3(new GameVector3(-50, -50, -50), new GameVector3(178, 178, 178))

玩家的活动范围限制，如超出此范围，则传回出生点

定义于 #L11779

url ​

获取该玩家进入地图时所用的URL链接地址, 主要用于获取URL参数, 以便区别对待进来的玩家

定义于 #L11769

方法 ​

querySocial() ​

查询当前玩家的社交关系，并返回具体的玩家ID列表

  • 关注ID列表
  • 粉丝ID列表
  • 好友ID列表

输入参数

参数必填默认值类型说明
socialType是SocialType查询的方式

返回值

类型说明
Promise‹number[]›异步返回玩家 ID 列表

定义于 #L11738

querySocialStatistic() ​

查询当前玩家的社交统计信息，并返回具体的统计数

  • 关注人数
  • 粉丝人数
  • 好友人数

返回值

类型说明
Promise‹SocialStatisticType›异步返回数据统计信息

定义于 #L11775

openUserProfileDialog() ​

对当前玩家，调起指定ID玩家的个人主页。

输入参数

参数必填默认值类型说明
userId是number玩家的用户ID

定义于 #L11737

接口 ​

SocialStatisticType ​

社交统计信息的类型

参数类型说明
followingNumnumber关注人数
followerNumnumber粉丝人数
friendsNumnumber好友人数

定义于 #L9344

枚举 ​

SocialType ​

玩家的社交关系类型

属性说明
FOLLOWING关注
FOLLOWERS粉丝
FRIENDS好友

定义于 #L9336