DeadlyEssence01 Immersive Dialogue - v1.01: DE_ImmersiveDialogue.js

Introduction
This plugin allows for implementation of random or sequential dialogue pulled from a txt file so you can easily create a batch text / random text. You can specify subfolders and file names, so each command can have a different text file it reads from.You can use yanfly's text codes and macros with this plugin, I have a long plugin list and have not found an incompatibility or issue yet.


Updates:
v1.01 - Random Dialogue doesn't repeat.
- Added an optional parameter to know which random message the plugin displayed.

Features
- Read a txt file of dialogue.
- Plugin command allows you to specify different files for each command / and pull text files from subfolders.
- Pull random dialogue from a list of options.
- Does support using face images.
- Is compatible with most? of Yanfly's plugins.
- Random dialogue doesn't repeat last used dialogue message.
- Show message number of displayed random dialogue

How to Use
Download the .js and put it in your plugins folder for your project.

You do not have to set the parameters if you don't want to...
If you want to know which message was displayed when using random dialogue, set a gamevariable in the parameters for "dialogue variable" the plugin will push the message number it displayed to your variable to allow for eventing checks.


1. Create a new folder in your project's data folder, name it dialogue.
2. Create a new text file, do not use spaces. The file name will be needed for the plugin command.
3. Insert your dialogue, being sure to use "//" to separate messages.

EX:  (you can copy and paste below if you need...)

Howdy
//Heyo!
//Long time no see!
//Fancy seeing you here.

Or batched text: (without word wrap that should fit in the box)

This is the very first message, that appears in the
message box. And here is some filler continuation
words. You can go beyond the four lines of text
for this, it will automatically batch the text for
you so that it shows.
//And this is message two.


Note: Pressing enter will make a new line break, or you can use Yanfly's <WordWrap>. With word wrap, you can just put the whole message on a single line.


Using Subfolders:
If you'd like to use subfolders, your filename should preface with the subfolder name and a / before the actual filename.
Ex: subfolder/EnoAmsir.txt
Ex: newfolder/HaroldDialogue.txt

Plugin Commands:

Sequential Dialogue Command
Dialogue will read the dialogue in order, for the number of lines specified.

dialogue [FILENAME.txt][lineNumber] [lineCount] [faceImage filename] [faceIndex number]

EX: dialogue NiraAmosirNeutral.txt 0 3 NiraAmosirFace 0
EX: dialogue Gossip.txt 0 3

- Filename should be the name of the .txt file you are trying to pull from the dialogue folder. Be sure to include .txt or it will not work.
- LineNumber is the line of text you want to start on. 0 is the first line!
- LineCount is the number of lines to read. 0 will only show the line specified in lineNumber. 1 will read the next line in the file too.
- Faces: If you want a face image to appear put the name of the file, without the .png. The face index is the number slot the face appears in on the png file. Remember, the left top is 0, not 1.

- If you don't want to count lines, I suggest using Notepad++ it will automatically number the lines for you. However, subtract one from the number on the left.

Random Dialogue Command:
Random dialogue will give you a random response from your text file.

randomdialogue [FILENAME.txt] [faceImage FILENAME] [faceIndex number]

EX: randomdialogue Introductions.txt
EX: randomdialogue Introductions.txt NiraAmosirFace 0
EX: randomdialogue HaroldDialogue.txt Actor1 0


- Filename should be the name of the .txt file you are trying to pull from the dialogue folder.
- Faces: If you want a face image to appear put the name of the file, without the .png. The face index is the number slot the face appears in on the png file. Remember, the left top is 0, not 1.

Script

Spoiler                Code:       






FAQ
None yet...

Q:
A:

Credit and Thanks
- DeadlyEssence01

Terms of Use
This plugin is free for both non-commercial and commercial use.
You can give me credit as DeadlyEssence01 if you'd like.
You may edit this plugin to fit your needs, but please do not redistribute it. You may make an extension plugin and link it in the forums if you'd like to share changes/alterations.

Author's Notes
This plugin comes how it is. I may not update it at all, or provide support for it I am just deciding to share a resource I made for my project. However, as for right now I am open to feedback. You can try asking questions / reporting problems in this thread first, and if I do not respond, I suggest taking it to the plugin support thread and posting there.


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