bsb notetag parser

じ☆ve冰风

bsb notetag parser 1.0.0
briarsweetbriar​

Introduction
it slices, it dices, it parses notetags.

Features

• searches text for single-line, multi-line, and js notetags
  
• parses notetags into js primitives (eg strings, numbers, booleans)
  
• also parses nested data into arrays and objects
  
• adds a new function to game battlers that aggregates all instances of a tag on that battler, searching their character, class, states, and equips
  

How to Use
install plugin as usual by adding it to `/js/plugins/`. you can then access its commands w/ `BSB.NP.<command>`.

Plugin Commands / Script Calls

BSB.NP.getMultiLineTags(note, tagName)

returns an array of all instances of that multi-line tag in the note.

BSB.NP.getMultiLineTag(note, tagName)

same as `getMultiLineTags` but only returns the first instance of the tag.

BSB.NP.getTags(note, tagName)

returns an array of all instances of that single-line tag in the note.

BSB.NP.getTag(note, tagName)

same as `getTags` but only returns the first instance of the tag.

BSB.NP.getJSTags(note, tagName)

returns an array of all instances of that js tag in the note.

BSB.NP.getJSTag(note, tagName)

same as `getJSTags` but only returns the first instance of the tag.

battler.getMultiLineTags(tagName)

returns all instances of a tag on a particular battler. for actors, the tag is searched for on the character, class, equips, and states. for enemies, the tag is searched for on the enemy and states.

                JavaScript:       

1. // getMultiLineTags/getMultiLineTag
3. let note = `
4.   <Foo>
5.     boolean: true
6.     number: 8.88
7.     string: other value
8.     array: [1, 2, 3]
9.     object: { boo: 1 }
10.     nestedStuff: [{ boo: 1, baz: 2 }, { boo: 3, baz: 99 }]
11.   </Foo>
12.   <Foo>
13.     anotherVal: 123
14.   </Foo>
15.   <Bar>
16.     something: else
17.   </Bar>
18. `
20. BSB.NP.getMultiLineTags(note, "Foo");
21. => [{
22. boolean: true,
23. number: 8.88,
24. string: 'other value',
25. array: [1, 2, 3],
26. object: { boo: 1 },
27. nestedStuff: [{ boo: 1, baz: 2 }, { boo: 3, baz: 99 }]
28. }, {
29.   anotherVal: 123
30. }]
32. BSB.NP.getMultiLineTag(note, "Foo");
33. => {
34. boolean: true,
35. number: 8.88,
36. string: 'other value',
37. array: [1, 2, 3],
38. object: { boo: 1 },
39. nestedStuff: [{ boo: 1, baz: 2 }, { boo: 3, baz: 99 }]
40. }
42. // getTags/getTag
44. BSB.NP.getTags('<Foo: 1, true, bar>', "Foo");
45. => [[1, true, 'bar']]
47. BSB.NP.getTags('<Foo: 1, true, bar> <Foo: baz> <Bar>', "Foo");
48. => [[1, true, 'bar'], ['baz']]
50. BSB.NP.getTags('<Foo>', "Foo");
51. => [[]]
53. BSB.NP.getTags('<Foo>', "Bar");
54. => []
56. BSB.NP.getTag('<Foo: 1, true, bar> <Foo: baz> <Bar>', "Foo");
57. => [1, true, 'bar']
59. BSB.NP.getTag('<Foo>', "Foo");
60. => []
62. BSB.NP.getTag('<Foo>', "Bar");
63. => undefined
65. // getJSTags/getJsTag
67. let jsNote = `
68. <Foo>
69.   let a = 'foo bar';
70.   let b = 'baz';
71.   console.log([a, b].join(' '));
72. </Foo>
73. `
75. let jsTags = BSB.NP.getJSTags(jsNote, "Foo");
76. jsTags.forEach((tag) => eval(tag));
77. => foo bar baz
79. let jsTag = BSB.NP.getJSTag(jsNote, "Foo");
80. eval(jsTag);
81. => foo bar baz

复制代码

Download
https://raw.githubusercontent.com/briarsweetbriar/draw-that-circle-tight/master/js/plugins/BSB_0_NotetagParser.js

Terms and Credits
MIT license. feel free to use in commercial games, adult-themed games, whatever. feel free to use it in your own plugins too, including commercial plugins. if you use it in your plugin, please credit me and link to this thread. if you use it in your game, no need to credit.


本贴来自国际rpgmaker官方论坛作者:briarsweetbriar处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/bsb-notetag-parser.135617/