常用命令

普通的值和命令

普通的值和命令是不一样的。属性.金钱是一个普通的值,而玩家.发送未读消息('新消息!')是一个命令。
命令的特点在于,它接收一个或多个参数,格式为某某命令(参数),并进行某些操作(例如向玩家发送未读消息、生成随机数、刷新侧边栏等)。有些命令还会返回一个值。
这是一个执行命令的示例,示例中的“某某命令”可以是之后介绍的任意一个命令,它们可能会需要传入参数,或返回一个值。
某某命令('你好'); // 向 某某命令 传入一个文本参数 '你好',并使其执行
某某命令2('你好', 123); // 向 某某命令2 传入一个文本参数 '你好' 和数字参数 123,不同参数之间用英文逗号隔开

// 执行命令时,一定要在它的后面加上括号,即使这个命令没有参数。
某某命令3() // 执行 某某命令3,同时不传入参数。
某某命令3 // 错误的方法,由于没有加括号,某某命令3 没有执行

var a = 某某命令4();  // 执行 某某命令4,并将其返回值赋值给临时变量 a

随机取值

随机的签到奖励

使用随机数([值1, 值2, 值3])从一些值中随机挑选一个值。这个命令需要传入一个数组,并返回数组中的一个值。
有关数组的介绍,可以查看 数组 章节,这里只需要知道数组是被中括号包起来、用英文逗号分隔的含有很多值的一个值。
属性.签到奖励 = 随机数([10, 20, 25, 25, 30, 30, 35, 35, 40]);
属性.金钱 = 属性.金钱 + 属性.签到奖励;
让签到奖励等于随机从 10 20 25 25 30 30 35 35 40 中取出的一个数

抽奖系统

当代码执行到return时,将会提前结束当前脚本,不再继续执行。
var 编号 = 随机数([0, 1, 2, 3]);
if (编号 === 0) {
  物品.兔子 = 物品.兔子 + 1;
  属性.提示 = '你获得了一只兔子!';
  return;
}
if (编号 === 1) {
  物品.老鼠 = 物品.老鼠 + 2;
  属性.提示 = '你获得了两只老鼠!';
  return;
}
if (编号 === 2) {
  属性.金钱 = 属性.金钱 - 50;
  属性.提示 = '你丢失了 50 金钱!';
  return;
}
if (编号 === 3) {
  属性.经验 = 属性.经验 + 5;
  属性.提示 = '你获得了 5 个经验!';
  return;
}
抽奖系统,玩家将随机获得一只兔子、两只老鼠、 5 个经验或丢失 50 金钱。
在语句中插入『提示』属性,即可将抽奖内容显示给玩家。

拼接文本

属性.签到奖励 = 随机数([10, 20, 25, 25, 30, 30, 35, 35, 40]);
属性.金钱 = 属性.金钱 + 属性.签到奖励;
属性.显示文本 = '签到成功!奖励' + 属性.签到奖励 + '个金钱。你当前共有' + 属性.金钱 + '个金钱';
在语句内容中输入[属性:显示文本],即可将签到内容显示给玩家。

获得和修改玩家的名字、位置、介绍

var 名字 = 玩家.名字; //获得玩家的名字
var 位置 = 玩家.位置; //获得玩家的位置
var 介绍 = 玩家.介绍;
玩家.名字 = '新名字'; //设置玩家的名字为『新名字』
玩家.位置 = '地图2'; //设置玩家的位置为『地图2』
玩家.介绍 = '你好,我是' + 玩家.名字 + '。'; //设置玩家的介绍设置为『你好,我是XXX。』

向玩家发送未读消息

通过玩家.发送未读消息(文本),可以向玩家发送未读消息,玩家可以点击未读消息进入领域。
你可以通过这个功能,提醒玩家回到领域继续操作。
玩家.发送未读消息('你有一条新的消息!');

向玩家发送提示和弹窗

使用提示(文本)玩家.提示(文本)向玩家发送一条提示,提示会在界面顶部居中显示并自动消失,不会打断玩家操作。
使用弹窗(文本)玩家.弹窗(文本)向玩家发送一条弹窗,弹窗会在屏幕中央显示并需要玩家手动关闭。
提示和弹窗都只有在玩家处于这个领域时才能收到。如果希望玩家不在线时也能收到提示,需要使用发送未读消息
提示('操作成功!');

玩家.弹窗('改名成功!这是你的新名字:' + 玩家.名字 + '!');

刷新侧边栏

使用页面.刷新侧边栏()刷新用户页面的侧边栏。当页面的可见条件发生变化时,可以通过该命令让玩家看到新的侧边栏,而不需要刷新整个页面。
页面.刷新侧边栏();

让玩家属性等于玩家自己

属性.玩家属性 = 玩家.id;
让玩家类型的属性等于玩家的 id。
玩家属性就是一段文本,写着这个玩家的 id,这个 id 是系统自动生成的,长得像这样:'61ebcb6424423f4f4d58320d'

含有特殊字符的中括号写法

//让金钱等于100,下面这三种写法是等价的
物品.金钱 = 100;

物品['金钱'] = 100;

var 临时变量 = '金钱';
物品[临时变量] = 100;
aa.bb 相当于 aa['bb']
例如:属性.xxx有另一种等价写法,是属性['xxx'],这两种写法基本上是一样的。
只不过,如果属性名称中含有特殊符号,例如空格,则必须使用属性['含 有 空 格 的属性']这种写法。
为了动态的改变玩家物品,原来写着物品名称的位置可以用临时变量替换,例如上述第三种写法:物品['金钱']变为物品[临时变量]