排行榜

排行榜可用于给玩家建立目标，激励玩家不断挑战更高的成绩，如财富/积分/时间等类型的排行榜；

还可以根据作品设定分为日榜、周榜和总榜等，掌握排行榜可以提升作品的完整性

常见的其他激励功能还有：等级系统、荣誉称号系统、装备/皮肤奖励系统等等

（点击->高清B站视频） (opens new window)

// 当玩家进入游戏时
world.onPlayerJoin(({ entity }) => {
    // 设置刚进入游戏的玩家持有金币(coin)数量为0
    entity.player.coin = 0
    
    // 当玩家按下按键时，触发交互
    entity.player.onPress(({ button }) => {
        if (button === Box3ButtonType.ACTION0) {
            entity.player.dialog({
                type: Box3DialogType.TEXT,
                title: "金币排行榜",
                content: dialogContent(),
            })
        }
    })
});

// 找到世界中的"AT M"机器模型
const atm = world.querySelector(`#ATM`)

// 设置AM机器可互动
atm.enableInteract = true

// 设置ATM机器互动距离为5
atm.interactRadius = 5;

// 监听世界中的互动事件
world.onInteract(({ entity, targetEntity }) => {
    // 判断被"互动"的实体，
    if (targetEntity.id === "ATM") {
        entity.player.coin = entity.player.coin + 1;
        world.say(`${entity.player.name}获得了1金币！`);
    }
})

// 对话框内容
function dialogContent() {
    // 首先获取当前世界中的所有玩家
    const allPlayerEntities = world.querySelectorAll('player');
    
    // 然后将所有的玩家进行排序，排序的规则是按照玩家持有的金币数量降序
    const sortedPlayerEntities = allPlayerEntities.sort((a, b)=>  b.player.coin - a.player.coin);
    
    
    // 接下来，我们将在排行榜上以: xxx 有 yyy 个金币 的格式展示，并且每一条信息换一行显示！

        // 首先声明一个content字符串，一会用来保存每一个玩家的信息
        let content = "";
    
    // 在这里需要做一个循环遍历，将刚才得到的有序的玩家数组遍历一遍
    for(const entity of sortedPlayerEntities ) {
        
        // 在遍历的过程中，每一次遍历，我们拿到当前的实体(entity)，
        // 将实体上的玩家名字(player.name)以及玩家金币数量(player.coin)拼接成排行榜上的一行信息
        // 这样就得到: xxx 有 yyy 个金币 的格式啦
        // 我们在这个文字的末尾加一个\n, 这样我们就能实现换行的效果
        // 紧接着，再把这行信息加上content，这样做是为了把每一个玩家的排行榜信息拼接起来，保存到content中
        content = content + `${entity.player.name}有${entity.player.coin}个金币\n`
    }
    
    // 最后，把得到的完整的带有玩家名称和金币数量，并且会换行的排行榜数据(content)返回出去
    return content
}