Random Dialogue v1.03a

じ☆ve冰风

Random Dialogue v1.03a
Author: Michael Morris @Blue Booth Studios
Demo thanks to Anthony Xue: http://ancient-architects.com/files/Conversation Demo.zip

Introduction
    Sometimes you just need NPCs to say random stuff.  Not completely random, per say, but for example, let's say you have an NPC who shares rumors with the player.  As long as said rumor is unlocked, you don't care which rumor the NPC cares to share.  Likewise, you may have a series of lines kids can say "you look funny!", "Mister, where do babies come from?" or something else inane.  You might even have the kids say smart things.  But again, you simply care that one intelligent option is chosen, not which specific line activates.  While you can do all of this manually using conditional branches... you can also use this script and not have that nasty conditional mess to check every time something goes wonky.  This script takes care of all the issues above for you, so you can spend less time checking random kid 36b says the right thing.  In fact, this can even be used to improve world immersion, as your NPCs will now say different, but appropriate things!

Features

• Select a dialogue line at random from a series of dialogue lines.  This has many uses, but for example, allows you to easily replicate Fi's "rumors" system from Skyward Sword.
  
• Dialogue lines can be limited based on real-time conditions - for example, "I know where the cave is" will only show if a game switch is active, which indicates the player has heard about the cave.
  
• Dialogue lines separated into categories and topics.  This means you can have rumors, game tips, and a whole bunch of other stuff in rumors.json, and select "rumors" to only choose from rumor dialogue lines.
  
• Random dialogue lines use the message box without additional modification, so any changes to the message box you make before calling the Plugin Command (position, windowskin, etc.) will carry over to affect the appearance of the dialogue lines.
  
• Dialogue lines can be restricted by a further condition - "available" is intended to track when a line is unlocked (for example, if the player kills a bandit, dialogue about that bandit being dangerous won't show).  "restriction" is intended to further restrict dialogue lines to be appropriate to a speaker.  For example, you can use a game variable with a manually tracked index (ie. Widow = 1, Guard = 2, Veteran = 3), so that an NPC will not say a random line that would be out of character.
  
• Random will now avoid consecutive repetition of a given dialogue line, provided more than one random dialogue line is available to choose from.
  
• Faceset support!
  
• NPCs will not resume movement while a random dialogue line is displayed.
  
• Plugin now displays user-friendly error messages for an incorrect number of parameters, misspelling of command, etc.
  
• Plugin now supports case insensitive checks (requires rumors.json having all Category and Topic values in lower-case).
  

Screenshots
    None.


How to Use

• Copy script into your game js/plugins directory.
  
• Create a Rumors.json file in your game data directory.
  
• Import this script into your project and set all two parameters.
  
• Use the Plugin Command to get a random dialogue line output into message box.
  

Demo
    Thanks to Anthony Xue, a demo is available here:
http://ancient-architects.com/files/Conversation Demo.zip

    Create a new project, and then extract this archive into that new project.


Script
Spoiler                Code:       

1. //=============================================================================
2. // Bluebooth Plugins - Random Conversations
3. // BBS_RandomConversations.js
4. //=============================================================================
6. //=============================================================================
7. /*:
8. * @title Random Conversations Plugin
9. * @author Michael Morris (https://www.patreon.com/bluebooth)
10. * @date Feb 19, 2016
11. * @filename BBS_RandomConversations.js
12. * If you enjoy/benefit from my work, please support me on Patreon!
13. *
14. * https://www.patreon.com/bluebooth
15. *
16. * @plugindesc v1.03a Add random dialogue for a specific topic to your game.
17. * This allows you to pick a random (unlocked) rumor to share, pick a hint at random, given
18. * general dialogue on a specific point, etc.  There's a lot of exciting things you can
19. * do with this!  Original design was merged with elements of Iavra's Achievements
20. * file parsing and then new enhancements / reworkings were added on top of that.
21. * Special Thanks to Tsukihime for all the help.
22. * Special Thanks to Anthony Xue for bug fixes and documentation help.
23. * Special Thanks to Iavra, the file parse handling is modified from his own (awesome) Achievements plugin.
24. *  You should pick it up, it's really well done.
25. *
26. * ============================================================================
27. * Terms of Use
28. * ============================================================================
29. *   - Free for use in non-commercial projects with credits
30. *   - Contact me for commercial use
31. *
32. * ============================================================================
33. * Parameters
34. * ============================================================================
35. * @param Configuration File
36. * @desc Name of an external configuration file to load at game start. Default: data/Rumors.json
37. * @default data/Rumors.json
38. *
39. * @param Case Insensitive
40. * @desc Enable to use case insensitive string comparisons.  You will need to manually
41. * convert Rumors.json Categories and Topics values to lower case.
42. * @default false
43. *
44. * @param Debug Mode
45. * @desc Enable to activate console variable logging.  Use for debugging odd behaviour.
46. * true to enable console variable logging.
47. * @default false
48. *
49. * @help
50. * ============================================================================
51. * Description
52. * ============================================================================
53. * Add random dialogue for a specific topic to your game.  This allows you to pick a random (unlocked) rumor to share,
54. * pick a hint at random, given general dialogue on a specific point, etc.  There's a lot of exciting things you can
55. * do with this!  Original design was merged with elements of Iavra's Achievements file parsing and then new
56. * enhancements / reworkings were added on top of that.
57. *
58. * To add random dialogue to your game, create a txt file in your data directory called rumors.json.  This is
59. * a very flexible system that can be used from anything to random dialogue to selecting one random rumor from a series of many,
60. * to doing the same for hints, and so on.  To support having multiple topics (each with an item that can be selected at random),
61. * these dialogue items are split into both Topics (ie. "The Temple Puzzle") and "Categories" (ie. "Puzzles").  Each dialogue
62. * entry consists of multiple properties:
63. *
64. * id           A unique numeric id, that may not contain commas or whitespaces.
65. * topic        Topic name.
66. * category        Category name.
67. * dialogue        Dialogue box contents associated with this topic.  To add \c[], \v[], \i... or other message shortcuts, you must use two slashes \\ in JSON.  See examples below.
68. * available    Eval condition as string.  If true, this dialogue item is available.
69. * restriction  Eval condition as string.  If false, this dialogue item is available.  Used to restrict random conversation items
70. *                for specific NPCs (ie. "adventurer only", "widow only", etc.)
71. *
72. * This is a sample file, containing one of each achievement types:
73. *
74. * [
75. *    {
76. *         "id":0,
77. *         "topic":"SantaCompana",
78. *            "category":"Toledo",
79. *         "dialogue":"They say the \\c[3]Santa Compana\\c[0] has been spotted near the \\c[3]Old Monastery\\c[0].  I hope it doesn't get any closer to town.",
80. *         "available":"$gameSwitches.value(297) === false",
81. *         "restriction":"false"
82. *    },
83. *    {
84. *         "id":1,
85. *         "topic":"SantaCompana",
86. *             "category":"Toledo",
87. *         "dialogue":"I haven't heard any news about \\c[3]Santa Compana\\c[0] sightings.  Maybe the reaper has moved on?",
88. *         "available":"$gameSwitches.value(297) === true",
89. *         "restriction":"false"
90. *    },
91. *    {
92. *         "id":2,
93. *         "topic":"Culebre",
94. *             "category":"Toledo",
95. *         "dialogue":"I don't know how my family is going to stay fed with that damned \\c[3]Culebre\\c[0] at large.",
96. *         "available":"$gameSwitches.value(126) === false",
97. *         "restriction":"$gameVariables.value(77) === 2"
98. *    }
99. * ]
100. *
101. * ============================================================================
102. * Plugin Commands
103. * ============================================================================
104. * Use the following plugin commands to manipulate custom controls.
105. *
106. * Plugin Commands:
107. *
108. *     RandomConversation getRandomMsg category topic faceset faceNum        # Get a random dialogue entry with corresponding category, and topic.  Optional faceset and faceNum may be specified.
109. *
110. * ============================================================================
111. * Change Log
112. * ============================================================================
113. * 1.03a - Fixed short-list bug.
114. * 1.03  - Category and Topic search now has added case insensitivity mode for more user-friendly usage.
115. * 1.02a - Fixed some typos and bugs courtesy of Steffen (Anthony Xue).  Thanks man!  User friendly check added for # args.
116. * 1.02  - Added in lastconv check to avoid repeating random dialogue when other entries can be played instead.
117. * 1.01a - Common mispelling now detected to be more dev friendly.
118. *         - Finally found out and documented how to add \... codes as in native Messagebox.
119. * 1.01  - Faceset and faceNum are now optional parameters.
120. * 1.00a - Fixed references to bad element in help.
121. * 1.00  - Plugin finished.
122. *
123. */
124. //=============================================================================
126. //=============================================================================
127. var Imported = Imported || {} ;
128. var BBS = BBS || {};
129. Imported.RandomConversations = 1;
130. BBS.RandomConversations = BBS.RandomConversations || {};
132. (function() {
134.     // Stores all rumors.
135.     var _rumors;
136.     var curCategory;
137.     var curTopic;
138.     var lastConv;
140.     //=============================================================================
141.     // Parameter Variables
142.     //=============================================================================
143.     var parameters = PluginManager.parameters('BBS_RandomConversations');
144.     var pConfiguration      = String(parameters['Configuration File'] || 'data/Rumors.json');
145.     var pLowerCaseChecks  = eval(String(parameters['Case Insensitive'] || 'false'));
146.     var pDebugging          = eval(String(parameters['Debug Mode'] || 'false'));
148.     //=============================================================================
149.     // Rumor Class
150.     //=============================================================================
151.     function Rumor() {
152.         this.initialize.apply(this, arguments);
153.     };
155.     Rumor.prototype.initialize = function(data) {
156.         this._id = Number(data.id);
157.         this._topic = String(data.topic);
158.         this._category = String(data.category);
159.         this._dialogue = String(data.dialogue);
160.         this._availableStr = String(data.available);
161.         this._restrictionStr = String(data.restriction);
162.     };
164.     Rumor.prototype._isUnlocked = function() {
165.         return eval(this._availableStr);
166.     };
168.     Rumor.prototype._isRestricted = function() {
169.         return eval(this._restrictionStr);
170.     };
172.     Rumor.prototype.isAvailable = function() {
173.         return (this._isUnlocked() && !this._isRestricted());
174.     };
176.     Rumor.prototype = Object.create(Rumor.prototype);
177.     Rumor.prototype.constructor = Rumor;
179.     /**
180.      * Creates rumors from the given data and loads their current state, afterwards.
181.      */
182.     var _create = function(data) {
183.         var temp = [];
184.         for(var i = 0, max = data.length; i < max; ++i) {
185.             entry = data[i];
186.             temp.push(new Rumor(entry));
187.         }
188.   
189.         _rumors = temp;
190.         curCategory = '';
191.         curTopic = '';
192.         lastConv = -1;
193.   
194.         if (pDebugging) {
195.             console.log(_rumors);
196.         }
197.     };
199.     //=============================================================================
200.     // Game_Interpreter
201.     //=============================================================================
202.     var BBS_RC_Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
203.     Game_Interpreter.prototype.pluginCommand = function(command, args) {
204.         // User friendly correction
205.         if (command === 'RandomConversation') {
206.             console.log("BBS_RandomConversations plugin command not called correctly.  Did you mean RandomConversations?");
207.         }
208.   
209.         if (command === 'RandomConversations')
210.         {
211.             switch (args[0]) {
212.                 case 'getRandomMsg':
213.                     SceneManager._scene.getRandomDialogue(args);
214.                     break;
215.             };
216.         }
217.         else {
218.             BBS_RC_Game_Interpreter_pluginCommand.call(this, command, args);
219.         }
220.     };
222.     //=============================================================================
223.     // Game_Temp
224.     //=============================================================================
226.     /* Tsukihime - Generates a random number from the given interval.
227.      You can customize the algorithm used to generate a
228.      random number if needed */
229.     Game_Temp.prototype._generateRandomValue = function(min, max) {
230.         if (min === max) {
231.           return min;
232.         }
233.         else {
234.           // Maybe you can customize this
235.           return Math.floor(Math.random() * (max - min + 1)) + min
236.         }
237.     };
239.     //=============================================================================
240.     // Scene_Map
241.     //=============================================================================
242.     Scene_Map.prototype._createShortlist = function(category, topic) {
243.         var temp = [];
244.         this.shortlist = [];
245.         lastConv = -1;
246.   
247.         for (var i = 0; i < _rumors.length; i++)
248.         {
249.             if (_rumors[i]._category === category && _rumors[i]._topic === topic)
250.             {
251.                 if (_rumors[i].isAvailable()) {
252.                     temp.push(_rumors[i]);
253.                 }
254.             }
255.         }
256.   
257.         if (temp.length > 1) {
258.             // Remove last conversation entry, only if there are sufficient entries to remove it.
259.             for (var j = 0; j < temp.length; j++) {
260.                 if (temp[j]._id != lastConv) {
261.                     this.shortlist.push(temp[j]);
262.                 }
263.             }
264.         }
265.         else {
266.             this.shortlist = temp;
267.         }
268.   
269.         // For debugging sake.
270.         if (this.shortlist.length <= 0) {
271.             console.log("ERROR: No random conversations options for Category: '" + category + "' ; Topic: '" + topic + "'");
272.         }
274.         curCategory = category;
275.         curTopic = topic;
276.     };
278.     Scene_Map.prototype.getRandomDialogue = function(args) {
279.         if (args.length < 2) {
280.             console.log("ERROR: Too few parameters passed into getRandomMsg(...).  Minimum args: 2.");
281.         }
282.   
283.         var category = String(args[1]);
284.         var topic = String(args[2]);
285.   
286.         // User sanity; remove need for matching capitalization.
287.         if (pLowerCaseChecks === true) {
288.             category = category.toLowerCase();
289.             topic = topic.toLowerCase();
290.         }
291.   
292.         this._createShortlist(category, topic);
293.         if (this.shortlist.length <= 0) return;
294.   
295.         var randomIndex = $gameTemp._generateRandomValue(0, (this.shortlist.length - 1));
296.   
297.         $gameMap._interpreter.setWaitMode('message');
298.   
299.         if (args.length > 3) {
300.             var faceFile = String(args[3]);
301.       
302.             var faceNum = 0;
303.             if (args.length > 4) {
304.                 faceNum = Number(args[4]);
305.             }
306.       
307.             $gameMessage.setFaceImage(faceFile, faceNum);
308.         }
309.   
310.         $gameMessage.addText(this.shortlist[randomIndex]._dialogue);
311.         lastConv = this.shortlist[randomIndex]._id;
312.     };
314.     //=============================================================================
315.     // class Scene_Boot
316.     //=============================================================================
317.     var BBS_RC_Scene_Boot_create = Scene_Boot.prototype.create;
318.     Scene_Boot.prototype.create = function() {
319.         BBS_RC_Scene_Boot_create.call(this);
320.         this._loadFile(pConfiguration, _create);
321.     };
323.     Scene_Boot.prototype._loadFile = function(url, callback) {
324.         var request = new XMLHttpRequest();
325.         request.open('GET', url);
326.         request.overrideMimeType('application/json');
327.         request.onload = function() { callback(JSON.parse(request.responseText)); }
328.         request.onerror = function() { throw new Error('There was an error loading the file ' + url); }
329.         request.send();
330.     };
332.     var BBS_RC_Scene_Boot_isReady = Scene_Boot.prototype.isReady;
333.     Scene_Boot.prototype.isReady = function() {
334.         return !!_rumors && BBS_RC_Scene_Boot_isReady.call(this);
335.     };
336.   
337. })(BBS.RandomConversations);
338. //=============================================================================
339. // End of File
340. //=============================================================================

复制代码

Known Bugs / TODO
Make your suggestions or report bugs here!

Requirements

• Yanfly's Message Core plugin - YEP_MessageCore.js.  Set the "Word Wrap" plugin parameter to true.
  

History
Spoilerv1.03a
   - Fixed bug with availability and restriction conditions due to shortlist caching.
v1.03
   - Category and Topic search now has added case insensitivity mode for more user-friendly usage.
v1.02a
   - Fixed typos and bugs courtesy of Steffen (Anthony Xue).  Thanks man!  User friendly check added for # args.
v1.02
   - Added in lastconv check to avoid repeating random dialogue when other entries can be played instead.
v1.01a
  - Finally found out and documented how to add \... codes as in native Messagebox.
  - Common misspelling now detected to be more developer friendly.
v1.01
  - Faceset and faceNum are now optional parameters.
  - Squashed some bugs.
  - Fixed the last few documentation errors.
v1.00a
  - Fixed documentation errors.
v1.00
  - Plugin released.




Suggestions, bug reports, and feature requests are welcomed!

Compatibility Issues
None known.  Compatible with Klaus Map Overlays, Terrax Lighting System, and most (if not all) of Yanfly's plugins.

FAQ
Q: The demo won't open, how to open it?
    A: Download Winrar and try again.

Credit and Thanks

• Micheal Morris @Blue Booth Studios
  
• Credit to Tsukihime for continuing to be so helpful!
  
• Special Thanks to Anthony Xue for bug fixes and documentation help.
  
• Iavra for the JSON handling code, based on that from achievements.js.
  

Author's Notes
Free for non-commercial usage as long as credit is given, contact me for commercial use.



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