北大侠客行Vscode版-js机器人示例讲解

wendaokoujin

我们以多个示例来讲解新版本客户端机器人代码的编写客户端核心函数其实就几个：
api.alias()
api.action()
api.send()
api.echo()
其它的都是标准的 js 开发


第一个示例：找师父学特殊内功



我们一行行来分析
1. api.loops.xuemaster = true;
[解释]：api是一个全局对象，里面包含了最基本的函数，也可以用它来记录全局变量，这里约定死循环的结束标识都记录在api.loops里，当然这不是必须的，可以随便用一个局部变量也没问题

2. api.alias('xuemaster.stop', function () { api.loops.xuemaster = false })
[解释]：这里定义一个别名，输入 xuemaster.stop 指令的时候，可以停止这个学技能的循环

3. api.alias('xuemaster', async () => {
[解释]：这里定义一个别名，输入 xuemaster 指令的时候，循环启动

4. while (api.loops.xuemaster) {
[解释]：死循环，但是如果api.loops.xuemaster=false，会结束循环

5. if (api.session.player.data.neili < 30) {
[解释]：api.session.player 是玩家的实时数据对象，里面包含了GMCP相关数据，主要是房间信息，人物属性，人物属性包含了各种血量、内力、精力、经验等等，都是实时的数据，你可以通过 api.echo(JSON.stringify(api.session.player)) 来打印详情，这句话的意思如果内力小于30就开始睡觉

6. await sys.retry('sleep', '你一觉醒来，精神抖擞地活动了几下手脚', 5, 60);
[解释]：这里的sys对象是一些工具函数的封装，第一次打开游戏的时候会自动创建 init.js ,sys对象里面包含了很多函数，可以直接在里面看源码，这个函数（sys.retry) 的意思是尝试 sleep，然后等待醒过来，会尝试60次，每隔5秒尝试一次，如果中间醒过来了，这个函数就执行结束，也就是 '你一觉醒来，精神抖擞地活动了几下手脚'触发了就表示醒过来
这里sleep 有多种可能性，比如马上睡着或者提示 刚睡过，不能再睡，我们在这里不管这么多，直接用同步等待的方式，直接不停的sleep，直到睡醒

7. if (api.session.player.data.jing < 20) {
[解释]：同样判断一下当时的精力如果小于 20 的话就吸气

8. sys.sendAndEcho("e2");
[解释]：看名称就知道，就是发送指令并打印指令到屏幕(便于调试），封装的 api.send() 和 api.echo()

9.  await sys.sleep(1);
[解释]：等待1秒


10. this.autofoodwater();
[解释]：这个是封装的一个函数，如果食物<200就吃干粮，水小于200就在剑心居drink，这个函数很多地方用的上，就封装成一个函数

11. await sys.sleep(1);
[解释]：等待1秒

14. sys.sendAndEcho('xue ding for huagong-dafa 5;xue ding for literate 5');

[解释]：真正开始学技能

总结：尽量使用同步的方式，代码看上去逻辑很清晰，如果设置多个action也能异步实现，但是不够简洁。 当然这个只是示例，还有一些特殊情况，需要处理，比如师父跑了，比如没潜能了，比如超出师父的最高等级了等等，都需要处理，不过还是尽量按照同步的方式，做不到再考虑用action 和变量来处理

wendaokoujin

示例二  api.alias 和 api.action 的基本用法,这个都是最基本的功能，但是要比一般的客户端功能更强，因为加入了函数

一. alias
1. api.alias 是设置别名
参数1是别名，参数2可以是指令，可以是函数，也可以是一个数组，数组里可以是字符串和函数，如果涉及到变量，用 $1,$2 替代变量，
  api.alias("test_alias1", "pi;hi");
  api.alias("test_alias2", () => { api.send("pi;hi"); });
  api.alias("test_alias3", ["pi","hi",() => { api.send("jump;hi");}]);

  api.alias("test_alias4", "hi $1");
  api.alias("test_alias5", function(args){
    api.send("hi " + args[0]);
  });



2. api.unalias 取消别称
api.unalias("test_alias1");

二. action
1. api.action
参数1是action的文本或正则，参数2是指令，可以是可以是函数，也可以是一个数组，数组里可以是字符串和函数

  api.action("test_action1", "pi;hi");
  api.action("test_action2", () => { api.send("pi;hi"); });
  api.action("test_action3", ["pi","hi",() => { api.send("jump;hi");}]);



这里的 @test 是用来模拟触发action的

api.action(/http:\/\/fullme\.pkuxkx\.net\/robot\.php\?filename=(.*)/, '@fullme $1')
action可以是js的正则表达式，如果不会写js的正则，AI可以帮你

api.action(["test_action4","test_action5"], "hi");
还有一个特殊的用法，就是action还可以是一个字符串数组，可以用来匹配多行文本。

wendaokoujin

示例三 完整的剑心居打坐、吐纳、学习技能、读书、领悟和练习的示例，大家可以参考修改

1. class Jianxinju {
   
2.   //剑心居机器人
   
3.   constructor(api, sys) {
   
4.     this.api = api;
   
5.     this.sys = sys;
   
6.     this.init();
   
7.   }
   
8.   init() {
   
9.     const self = this; // 保存this引用
   
10.     this.api.alias("learn_skills.stop", () => (self.api.loops.learn_skills = false));
    
11.     this.api.alias("learn_skills.start", async () => self.learn_skills());
    
12. 
    
13.     this.api.alias("read_shediao.stop", () => (self.api.loops.read_shediao = false));
    
14.     this.api.alias("read_shediao.start", async () => self.read_shediao());
    
15. 
    
16.     this.api.alias("dazuo.stop", () => (self.api.loops.dazuo = false));
    
17.     this.api.alias("dazuo.start", async () => self.dazuo());
    
18. 
    
19.     this.api.alias("tuna.stop", () => (self.api.loops.tuna = false));
    
20.     this.api.alias("tuna.start", async () => self.tuna());
    
21. 
    
22.     this.api.alias("lingwu_lianxi.stop", () => (self.api.loops.lingwu_lianxi = false));
    
23.     this.api.alias("lingwu_lianxi.start", async () => self.lingwu_lianxi());
    
24. 
    
25.     this.api.action("你的内力修为似乎已经达到了瓶颈。", "dazuo.stop");
    
26.     this.api.action("你的精力修为已经达到了瓶颈。", "tuna.stop");
    
27.     this.sys.actionOnce("你附近没有 ding 这个人，请用 id here 指令看看周围人物 id 。", "clap 3;teacher;", 60); //找师傅，60秒内只触发一次
    
28.   }
    
29.   //自动补充食物水
    
30.   async auto_food_water() {
    
31.     let food = this.api.session.player.data.food;
    
32.     let water = this.api.session.player.data.water;
    
33.     if (water < 200) {
    
34.       this.sys.sendAndEcho("drink");
    
35.       await this.sys.sleep(1);
    
36.     }
    
37.     if (food < 200) {
    
38.       this.sys.sendAndEcho("eat gan liang");
    
39.       await this.sys.sleep(1);
    
40.     }
    
41.   }
    
42.   //睡眠恢复jing去做消耗jing的动作
    
43.   async recover_jing() {
    
44.     if (this.api.session.player.data.neili < 30) {
    
45.       await this.sys.retry("sleep", "你一觉醒来，精神抖擞地活动了几下手脚", 5, 60);
    
46.     }
    
47.     if (this.api.session.player.data.jing < 50) {
    
48.       this.sys.sendAndEcho("e2");
    
49.       await this.sys.sleep(1);
    
50.     }
    
51.     this.auto_food_water();
    
52.     await this.sys.sleep(1);
    
53.   }
    
54.   async learn_skills() {
    
55.     this.api.loops.learn_skills = true;
    
56.     while (this.api.loops.learn_skills) {
    
57.       await this.recover_jing();
    
58.       this.sys.sendAndEcho("xue ding for huagong-dafa 5;xue ding for poison 5");
    
59.     }
    
60.     this.sys.log("学习技能循环结束");
    
61.   }
    
62. 
    
63.   async read_shediao() {
    
64.     this.api.loops.read_shediao = true;
    
65.     while (this.api.loops.read_shediao) {
    
66.       await this.recover_jing();
    
67.       this.sys.sendAndEcho("read shediao 5");
    
68.     }
    
69.     this.sys.log("读射雕循环结束");
    
70.   }
    
71.   async dazuo() {
    
72.     this.api.loops.dazuo = true;
    
73.     while (this.api.loops.dazuo) {
    
74.       let max_neili = this.api.session.player.data.max_neili;
    
75.       let neili = this.api.session.player.data.neili;
    
76.       let neilipercent = neili / max_neili;
    
77.       let qi = this.api.session.player.data.qi;
    
78.       if (neilipercent <= 1.2 && qi < 100) {
    
79.         await this.sys.retry("sleep", "你一觉醒来，精神抖擞地活动了几下手脚", 5, 30);
    
80.       }
    
81.       this.auto_food_water();
    
82.       if (neili > max_neili * 2 - 30) {
    
83.         await this.sys.try("dazuo 10", "你运功完毕，深深吸了口气，站了起来。", 10);
    
84.       } else {
    
85.         await this.sys.try("dazuo max", "你运功完毕，深深吸了口气，站了起来。", 60);
    
86.       }
    
87.       await this.sys.sleep(1);
    
88.     }
    
89.     this.sys.log("打坐循环结束");
    
90.   }
    
91.   async tuna() {
    
92.     this.api.loops.tuna = true;
    
93.     while (this.api.loops.tuna) {
    
94.       await this.recover_jing();
    
95.       let max_jingli = this.api.session.player.data.max_jingli;
    
96.       let jingli = this.api.session.player.data.jingli;
    
97.       if (jingli > max_jingli * 2 - 20) {
    
98.         await this.sys.try("tuna 10", '你吐纳完毕，睁开双眼，站了起来。', 10);
    
99.       } else {
    
100.         await this.sys.try("tuna max", '你吐纳完毕，睁开双眼，站了起来。', 60);
     
101.       }
     
102.     }
     
103.     this.sys.log("吐纳循环结束");
     
104.   }
     
105.   async lingwu_lianxi() {
     
106.     let self = this;
     
107.     let point = 20;
     
108.     let cmds = [
     
109.       'lian throwing ' + point, 'lingwu throwing ' + point,
     
110.       'lingwu force ' + point,
     
111.       'lian parry ' + point, 'lingwu parry ' + point,
     
112.       'lian dodge ' + point, 'lingwu dodge ' + point,
     
113.       'lian strike ' + point, 'lingwu strike ' + point]
     
114.     this.api.loops.lingwu_lianxi = true;
     
115.     this.api.vars.lingwu_lianxi = 0;
     
116.     this.api.action('你需要提高基本功，不然练得再多也没有用', () => (self.api.vars.lingwu_lianxi++));
     
117.     this.api.action('不能通过练习来提高了', () => (self.api.vars.lingwu_lianxi++));
     
118.     this.api.action('你已经达到你的技能等级极限', () => (self.api.vars.lingwu_lianxi++));
     
119.     this.api.action('你的基本功夫比你的高级功夫还高', () => (self.api.vars.lingwu_lianxi++));
     
120.     this.api.action('你需要提高基本功，不然练得再多也没有用', () => (self.api.vars.lingwu_lianxi++));
     
121.     this.api.action('受限于天资', () => (self.api.vars.lingwu_lianxi++));
     
122.     this.api.action('必须空手', 'unwield all;');
     
123.     try {
     
124.       while (this.api.loops.lingwu_lianxi) {
     
125.         this.auto_food_water();
     
126.         if (this.api.vars.lingwu_lianxi >= cmds.length) {
     
127.           this.api.vars.lingwu_lianxi = 0;
     
128.         }
     
129.         let neili = this.api.session.player.data.neili;
     
130.         let qi = this.api.session.player.data.qi;
     
131.         let jing = this.api.session.player.data.jing;
     
132.         this.sys.log('当前内力：' + neili + ' 当前气：' + qi+ ' 当前精力：' + jing)
     
133.         if (neili < 100 && (qi < 100|| jing < 100)) {
     
134.           await this.sys.retry("sleep", "你一觉醒来，精神抖擞地活动了几下手脚", 5, 30);
     
135.         }
     
136.         await this.sys.sleep(1);
     
137.         this.api.send('e1;e2;' + cmds[this.api.vars.lingwu_lianxi])
     
138.       }
     
139.       this.sys.log("领悟练习结束");
     
140.     } catch (e) {
     
141.       this.sys.log("领悟练习失败：" + e.message);
     
142.       this.api.loops.lingwu_lianxi = false;
     
143.     }
     
144.   }
     
145. }
     
146. 
     
147. module.exports = Jianxinju;
     

复制代码