✍️How to Write a Chat Script (for Discord & Telegram)

This guide will teach you how to master the scriptwriting system. The best part? The script format you learn here is 100% universal. A single script file can be used to run missions in both your Discord and Telegram communities.

To make things easy, we've created an official script template. It's a pre-formatted Excel (.xlsx) file that includes a cheat sheet of all the commands, so you can have it open for reference while you write.

[ 📥 Download the Universal Script Template (.xlsx) ]

---

Once you have the template, here's everything you need to know about filling it out.

AICORA reads the first two columns of your Excel sheet. In our template, they are named Column A (The "Who & How") and Column B (The "What").

---

Column A: The "Who & How" Column

This is your command center. It tells AICORA who is speaking and how they are speaking (e.g., as a reply).

The core of every command is the user number, like user1, user2, etc. This number corresponds to the order of the accounts in your AICORA account list. user1 is always the first account in your list, user2 is the second, and so on.

Here are the 5 command formats you can use in this column:

1. Basic Text Message

• Format: userX

• Example: user1

• What it does: The specified user sends the text message found in Column B. This is your most-used command.

2. Basic Image Message

• Format: userX:image:

• Example: user2:image:

• What it does: The user sends an image instead of text. Column B must contain the filename of the image.

3. Replying to a Specific Line in the Script

• Format: userXreplyY:

• Example: user3reply2:

• What it does: User 3 will reply directly to the message that was sent on Row 2 of your script. This creates a predictable, perfectly threaded conversation, ideal for Q&A or specific narrative flows.

4. Replying to a Specific User's Last Message

• Format: userXreply:userY:

• Example: user4reply:user1:

• What it does: User 4 will reply to the last message that User 1 sent, no matter where it was in the script. This creates more dynamic, organic-feeling interactions.

5. Replying with an Image

• You can combine replies and images for powerful effects.

• Format (Reply to Row): userXreplyY:image:

• Format (Reply to User): userXreply:userY:image:

• What it does: These commands make a user reply to a specific row or user, but the content of their reply is an image from Column B.

⚠️ Important Note: The commands are not case-sensitive. user1 works the same as User1. However, any format that doesn't perfectly match the rules above will be ignored by the system, and you'll see a warning in the Running Logs.

---

Column B: The "What" Column (Content & Filenames)

This column contains the actual substance of the message.

• For Text Messages: Simply type the message you want the user to send.

  • Example: This project has so much potential! WAGMI.

• For Image Messages: Type the full filename of the image.

  • Supported Media Formats: AICORA can send a variety of media types. Both the Discord and Telegram modules support:

    • .jpg

    • .jpeg

    • .png

    • .webp (Great for static stickers)

    • .gif

    • .webm (Great for animated stickers)

  • Filename Tips:

    • You can include the extension (e.g., my_meme.gif) or leave it out (e.g., my_meme). If you leave it out, AICORA will automatically search for a file with that name using all the supported extensions.

    • For this to work, make sure the filename in your script exactly matches the filename in your selected "Script Image" folder.

---

Putting It All Together: An Example

Let's see how a few lines in your script would play out in your community channel.

Example Script:

(Column A) Who & How	(Column B) What
user1	Hey everyone, just joined! What's the latest alpha?
user2reply1:	Welcome! You should check out the new staking announcement.
user1reply:user2:	Awesome, thanks! I'll look for it now.
user3:image:	aicora_bullish_meme.gif

How this plays out in Discord or Telegram:

1. User 1 sends the message: "Hey everyone, just joined! What's the latest alpha?"

2. User 2 replies directly to User 1's message with: "Welcome! You should check out the new staking announcement."

3. User 1 then replies directly to User 2's message with: "Awesome, thanks! I'll look for it now."

4. User 3, acting independently, posts the aicora_bullish_meme.gif image to the channel, adding to the general atmosphere.

By mastering these simple but powerful rules, you can design incredibly complex and realistic community interactions for any platform. Now go and create your masterpiece.