Marketing
Write a post once, pick when it goes, and let Modbot send it to your Discord server, your VRChat group and Bluesky at that time, with a preview of exactly what goes out.
The Marketing page is where you write posts for your community and send them at a time you pick: an announcement, a reminder, news. You write a post once, tick where it goes, and Modbot sends it at its time.
In this version a post can go to a Discord channel, to your VRChat group's posts and to your group's Bluesky account, once it is set up. The VRChat page's own Posts tab stays: it posts in your group right away, and posts sent from Marketing show up there like any others.
Who can use it
| To do this | You need |
|---|---|
| See the Marketing page, every post, where each one goes and how it went | See posts |
| Write, schedule, change, cancel and send posts, and Try again | Manage posts and See posts |
| Put calendar events into a post's text with Add event and What's on | Manage posts, See posts and See calendar |
| Edit a post on Discord or VRChat, or Delete one on Discord, VRChat or Bluesky, after it went out | Manage posts and See posts |
| Turn Pause all posting, Discord posts, VRChat posts and Bluesky posts on or off, and set up the Bluesky account | Change settings |
| See the Posts card on Health | See posts and See the operational log |
Neither permission is in the built-in Moderator or Viewer roles. Administrator holds both. Give them on purpose: a post goes out in your group's name, in public.
Manage group posts, the permission for the VRChat page's Posts tab, does not open this page.
The page
Marketing is in the sidebar under Community, after World lists. g then q goes there.
The page has four lists, each with how many posts are in it:
- Scheduled: posts waiting for their time, or on their way, soonest first.
- Sent: posts that went out, newest first.
- Drafts: posts saved without a time.
- Failed: posts that did not go out somewhere. A post that went to one place and failed on another is here as well as in the list it would otherwise be in.
Each list has its own address, such as /marketing/sent, so you can send a link to one.
Cancelled at the top shows the posts that were called off instead.
Each post shows:
- when it goes, in your own time, with the time zone it was written in after it when that is another;
- its title, or the first line of its text;
- who wrote it;
- a badge for each place it goes, with how it stands there:
| Badge | What it means |
|---|---|
| Waiting | Not its time yet. |
| Paused | Pause all posting is on, so nothing is sent. |
| Off | Discord posts, VRChat posts or Bluesky posts is off in Settings. |
| Not set up | Discord: Modbot has no Discord server id, or the bot is not connected. VRChat: no group is picked, or Modbot has no VRChat login. Bluesky: no account has passed Check, or Bluesky refused its app password or ended its sign-in since. |
| Sending… | On its way, or Modbot is checking whether the site took it. |
| Posted | On the site. Open opens it there: the message on Discord, the group's posts on VRChat, the post on Bluesky. |
| Not published | In the channel, but publishing it to followers did not go through. |
| Failed | Not on the site, with the site's own words, or Modbot's. |
| Deleted | Was on the site and was deleted from Modbot. |
| Skipped | Never went: the post was cancelled first. |
A VRChat badge also says who sees the post: Everyone, Group, or the roles it is for.
The page updates by itself when a post is sent or fails, so Sending… turns into Posted without reloading.
Writing a post
New post opens the form. It has two tabs, Write and Preview, and its buttons stay at the bottom.
- Title is shown in bold on the first line on Discord, and as the post's title on VRChat. Discord does without one; VRChat needs one.
- Text is what the post says. Under it a counter for each place ticked shows how long the post will be, such as Discord 212 / 2000, VRChat 212 and Bluesky 212 / 300. Discord takes at most 2000 characters, and its counter turns red past that; the title and a mentioned role count too. VRChat documents no limit for a group post, so its counter shows none; it turns red only past 8000 characters, which is as much as Modbot will send there. Bluesky takes at most 300 characters, counted the way a reader sees them (an emoji with its skin tone is one), and the title counts too. Every counter counts what that site is sent, not what you see in the box: an event list counts as the words it becomes there, so a long list of dates is never refused because of the marks Modbot keeps in the text.
- A title is at most 200 characters; the box stops there.
- Add event and What's on, under the text, put calendar events into the post. They show only if you hold See calendar as well. Add event offers the published events, soonest first; pick one and Add. What's on offers This week (Monday to Sunday), Next month, Next 30 days and Pick dates, counted in the post's time zone, up to 62 days; it lists every published event that starts in them. Drafts, cancelled events, and a date cancelled on its own are left out. Each event goes in as its name, its time and a link: the Discord event's link when Discord made the event for that date, otherwise Modbot's join link, otherwise none. A range with no events says Nothing is planned yet. What you add shows as a card with Remove, with your own words in the boxes above and below it. The text of the card is not edited in place: remove it and add it again, or write around it. It is ordinary text after that: it is scheduled, previewed, counted and sent like the rest. On Discord each time shows in the reader's own time zone; on VRChat and Bluesky it shows in the event's own zone, such as "Sun 18 Oct, 20:00 BST". Nothing posts by itself: a monthly post is one you write and schedule.
- Keep updated shows under the text once the post has an event list. Off, each post stands alone, as it was sent. On, after the post has gone out Modbot edits it when an event in a list is published, changed, moved or cancelled: it writes the list again and leaves your words around it alone. Only Discord and VRChat are edited, with the same rules as Edit under After it goes: nobody is pinged or notified again. Bluesky cannot edit a post, so it keeps the first version. A burst of calendar changes makes one edit, then Modbot leaves the post alone for five minutes; a site that turns an edit away (VRChat when it is busy, Discord when the bot is not connected) is asked again after that. Nothing is edited while Pause all posting is on, and a site whose own switch (Discord posts or VRChat posts) is off is not edited either; it is edited once the switch is back on. An Add event list for an event that was cancelled says Nothing is planned yet. A What's on list stops changing after its last day, and an Add event list once the date it shows has started. A list you changed by hand on a site is left as it is there. Updated and the time show beside the post when Modbot last did.
- Picture: Choose picture to pick one on your computer, or paste a Picture link. It
opens in a crop box. Pick its shape: 16:9, 1:1, or As it is for the whole picture.
Move and size the box, then Upload. A picture up to 8 MB is kept by Modbot and sent to Discord
as a file with the post. Modbot fetches a picture link from your server, so the website it points
at sees a request from your server; it fetches only
https://links on public websites. - Where it goes: a chip for each place a post can go: Discord, VRChat and Bluesky. Each is off every time you open the form for a new post. A post goes nowhere unless you tick it. A chip that is on but cannot send says Off or Not set up, linking to where you fix that. VRChat says Needs a title until the post, or VRChat's own title, has one.
- When: Now sends it as soon as you press Post now. Later sends it at the date and time you pick. The time zone is your browser's to start with; pick another and the time is that zone's.
Then:
- Schedule saves it to go at its time. With Now picked, the button says Post now.
- Save draft keeps it in Drafts, with nothing sent.
- Cancel closes the form without saving.
If something is wrong, the form lists every problem at once, such as "Pick a channel.", "VRChat needs a title.", "The Discord text is longer than 2000 characters.", "The VRChat text is longer than 8000 characters." or "The Bluesky text is longer than 300 characters.". With Bluesky ticked before Modbot has found the account, it says "Bluesky is off." while Posting is off in Settings, and "Bluesky is not set up." otherwise, as the chip does.
Discord
With Discord ticked:
- Channel: the one channel the post goes to. A channel where the bot lacks something it needs is marked with what is missing.
- Mention role: one role to mention on the first line. It is pinged once, when the post first goes out, never on an edit. The bot cannot mention @everyone. A role marked Bot cannot mention will not be pinged unless you let anyone mention it in Discord, or give the bot Mention @everyone, @here and All Roles.
- Publish to followers: only for an Announcement channel. Once the post is in, Modbot publishes it to the servers that follow the channel.
- Own text: tick it to give Discord words of its own. It starts as the post's text, with any event list as a card (no time codes are shown), has its own counter, and Reset puts the post's text back.
VRChat
With VRChat ticked, the post goes to your group's posts on VRChat, from the VRChat account Modbot signs in as:
- Who sees it: Group (your group's members) or Everyone (anyone on vrchat.com). It starts as Group.
- Roles: with Group, tick roles to show it only to them. None ticked is every member. The roles are your group's as Modbot last read them.
- Notify members: has VRChat tell the members about it, once, when it first goes out. It starts unticked, every time.
- Own title and Own text: tick them to give VRChat words of its own. Each starts as the post's, and Reset puts the post's back.
The picture goes to VRChat only while uploads are on: Settings, Modbot's VRChat login, Pictures, Upload VRChat pictures. Then, when you tick VRChat on a post with a picture, the picture is uploaded to VRChat (it must be a PNG or JPEG), on the VRChat account Modbot signs in as, which needs VRChat+. VRChat takes one upload a minute. If VRChat turns it down, the VRChat section says why, and VRChat gets the text only. While uploads are off, VRChat gets the text only, and its preview shows no picture. While Modbot knows its VRChat account has no VRChat+ (Settings shows VRChat+: No), it does not send the picture at all: the VRChat section says Modbot's VRChat account needs VRChat+ to use pictures. with a Get VRChat+ link. A post that already has a VRChat picture keeps sending it.
Bluesky
With Bluesky ticked, the post goes to your group's Bluesky account, as set up in Settings, Bluesky (how):
- Bluesky has no title, so it gets the title on its own line, then the text.
- Own text: tick it to give Bluesky words of its own, every word, title included. It starts as the title and text, has its own counter, and Reset puts them back.
- Links and tags: a
https://link and a#tagin the text are links on Bluesky. An@handlestays plain text: Modbot never mentions anyone, because a mention notifies that person. - The picture: a post with a picture carries it in full under the text, with the post's title as its description, and no link card; a link in the text stays clickable. The form makes a JPEG copy of the picture in your browser, at most 2000 pixels on its longer side and under 1 MB, and keeps it beside the post.
- The link card: a post with no picture, but a link in the text, gets a card for the first link, with the post's title (or the link's website when there is no title).
Bluesky cannot edit a post. Once one is on Bluesky it can only be deleted.
Preview
Preview shows each place the post goes, the way that site shows it:
- Discord: the message the way the channel will show it: the role, the title in bold, the text with its links, and the picture.
- VRChat: the group post: its title, who sees it, the picture if VRChat is sent one, and the text.
- Bluesky: the account's name and handle, the text with its links and tags coloured, the link card if there is one, and the counter.
It is built by the same code that sends the post, so it is exactly what goes out. If something would stop the post being scheduled, it is listed above.
Before it goes
Each post in Scheduled or Drafts has buttons:
- Edit opens the form to change the whole post. A post that is on its way cannot be changed: it says "This post is being sent.".
- Post now sends it now, whatever time it had.
- Cancel post asks first, then calls it off. Nothing more is sent, and it moves to Cancelled.
- Delete draft asks first, then deletes a draft.
- Duplicate starts a new draft from the post: the same words, picture and each place's choices, with every place unticked again and Notify members unticked.
There is no repeat. For a post every week, Duplicate it. For reminders about an event, the calendar will make them in a later version.
After it goes
A post that went out shows Open, Edit and Delete beside its badge (a Bluesky post has no Edit):
- Edit changes its title and text there. On Discord the picture stays, and nobody is pinged again. On VRChat the picture and who sees it stay, nobody is notified again, and it needs a title. The box shows an event list as a card, the same as the form does, and the counter under it counts what that site is sent.
- Delete asks "Delete this post on Discord?" (or on VRChat, or on Bluesky), then deletes it there. A post already gone from the site counts as deleted. A Bluesky post is deleted from the account in Settings; deleting removes it from Bluesky, not from copies other services already took.
A Bluesky post that went out also shows its likes, reposts and replies beside its badge, once Modbot has counted them. A post from the last 30 days is counted again every 30 minutes; an older one keeps its last numbers. See Bluesky.
Both happen at once: on Discord the bot has to be connected; on VRChat and Bluesky each is one request, never sent again, and if the site is busy it says so and you try again later.
When a post fails
A failed post shows why, and Try again.
| What it says | What happened | What Try again does |
|---|---|---|
| Discord's own words, such as "Missing Permissions" | Discord refused it. Nothing was posted. | Sends it again. Fix what Discord said first. |
| Not sent on time. | It was more than an hour late, because Modbot was off, posting was paused or Discord was not set up. It was not sent. | Sends it now. Post now does the same. |
| Discord did not take the post. | Discord gave no clear answer, and the post was not in the channel a minute later. | Looks in the channel once more, and sends it only if it is not there. |
| Could not check the channel. | Discord gave no clear answer, and Modbot could not read the channel to look. | Looks again first, the same way. |
A post that is in the channel but was not published to followers shows Not published, and Try again publishes it.
On VRChat:
| What it says | What happened | What Try again does |
|---|---|---|
| VRChat's own words, with Needs Manage Group Announcement when Modbot's VRChat account lacks it | VRChat refused it. Nothing was posted. | Sends it again. Give the permission first, in VRChat, under the group's Roles. |
| VRChat needs a title. | The post had no title for VRChat. Nothing was sent. | Sends it again. Edit the post to give it a title first. |
| Not sent on time. | It was more than an hour late. It was not sent. | Sends it now. Post now does the same. |
| VRChat did not add the post. | VRChat gave no clear answer, and the post was not in the group's posts two minutes later. | Looks in the group's posts once more, and sends it only if it is not there. |
| Could not check the group's posts. | VRChat gave no clear answer, and Modbot could not read the group's posts to look. | Looks again first, the same way. |
On Bluesky:
| What it says | What happened | What Try again does |
|---|---|---|
| Bluesky's own words | Bluesky refused it. Nothing was posted. | Sends it again. |
| The Bluesky text is longer than 300 characters. | The text was too long for Bluesky. Nothing was sent. | Sends it again. Edit the post first. |
| That Bluesky account is not the one in Settings. | The account in Settings changed after the post was saved. Nothing was sent. | Sends it again. Edit the post first, so it is for the account in Settings. |
| Not sent on time. | It was more than an hour late. It was not sent. | Sends it now. Post now does the same. |
| Could not reach Bluesky. | Bluesky gave no clear answer, and Modbot could not find out for an hour whether the post was made. | Reads it back first, and sends it only if it is not there. |
| Bluesky says this post is already there, but could not show it. | Bluesky said the post's place was taken, then could not show the post. It may well be on Bluesky. | Reads it back, and shows it as Posted if Bluesky shows it now. It is never sent again: Duplicate it for a new post. |
Never posted twice
Modbot writes down that it is sending a post, and exactly what, before it asks Discord. It asks Discord with the library's own retries turned off, so nothing is sent twice behind its back.
When Discord gives no clear answer (no answer, a timeout, a Discord error), the post shows Sending… and Modbot does not send it again. A minute later it reads the channel for a message by the bot with the same text and the same picture, sent from a minute before the attempt. If it finds one, that message is the post: it shows Posted with an Open link. It reads on, page by page, until it has seen the few minutes after the attempt, or the channel's newest message once those minutes are over; only then is a post it did not find Failed with "Discord did not take the post.". If Modbot cannot read the channel, or the channel is so busy that it cannot read those minutes in one look, it tries again every 15 minutes for an hour, then shows "Could not check the channel.". Modbot never sends a post again by itself. Only Try again does, and it looks first: it sends only after a look that read the whole few minutes and did not find the post.
When Discord turns a post away without making anything (it is rate limiting the bot, or the channel could not be looked up), the post waits two minutes before it is tried again, so the posts behind it still go.
VRChat works the same way, with its own look. VRChat has answered with an error and posted all the same, so when it gives no clear answer (an error on its side, no answer, a timeout) the post shows Sending… and Modbot does not send it again. Two minutes later it reads the group's posts, newest first, for a post by Modbot's VRChat account with the same title and text, made no earlier than two minutes before the attempt. VRChat changes some characters it is sent, so the two are compared by their letters and digits only. If it finds one, that post is the post: it shows Posted. It reads on until it has seen a post older than the attempt, or the end of the list; only then is a post it did not find Failed with "VRChat did not add the post.". The group's audit log counts too: when Modbot's audit-log reading sees VRChat's own record of that post being made, even up to a day late, the post shows Posted.
When VRChat rate limits Modbot, or Modbot is not signed in yet, nothing was made: the post waits, and is tried again only once VRChat's own wait is over. Modbot never sends a rate-limited request again by itself.
Bluesky lets Modbot choose a post's id itself, so Bluesky is kept to once more simply. Modbot makes the id once, writes it down before it sends anything, and sends every try under that same id, asking Bluesky to make the post only if nothing has that id yet. A second try can therefore never make a second post. When Bluesky gives no clear answer, the post shows Sending…, and a minute later Modbot asks Bluesky for the post by its id: there, it shows Posted; not there, it is sent again under the same id, with the time of that send, because Bluesky sorts posts by it. When Bluesky rate limits Modbot, nothing more goes to Bluesky until the time Bluesky names.
What the bot needs in Discord
In the post's channel the bot needs:
- View Channels and Send Messages, to post;
- Attach Files, for a post with a picture;
- Read Message History, to look for a post Discord gave no clear answer to.
What the Bluesky account needs
An app password, saved in Settings, Bluesky, and a Check that passed, or, when your
Modbot has a public https:// address, a sign-in with Bluesky. See Bluesky.
What Modbot's VRChat account needs
In your group, Modbot's VRChat account needs Manage Group Announcement, the permission for the group's posts. A post refused for lacking it says so on the post and on Health.
Settings
Settings, Posts has four switches:
- Pause all posting: while it is on, no post is sent anywhere. Posts wait and show Paused; one more than an hour late is not sent and shows "Not sent on time." with Post now. It does not stop the calendar's own Discord event, channel card or VRChat calendar entry.
- Discord posts: off, no post goes to Discord; Discord posts wait and show Off. It is on to start with, because nothing goes out unless somebody ticks Discord on a post.
- VRChat posts: off, no post goes to the VRChat group; VRChat posts wait and show Off. It is on to start with, for the same reason.
- Bluesky posts: the same switch as Posting in Settings, Bluesky. It is off to start with, and goes on only once the Bluesky account has passed Check.
Each change is written to the audit log with who made it.
A We're live on Twitch post made by Twitch shows in the lists like any other, with no writer. It follows these switches, and one more than 15 minutes late is not sent.
Modbot sends at most one post a pass to each site, every 20 seconds or so for Discord, every 15 for VRChat and every 30 for Bluesky, and at most 10 posts an hour to each, so a mistake cannot flood a channel, a group or an account.
Live posts
Settings, Posts, Live posts makes a "We're live" post in your VRChat group when somebody is in one of its instances. Instances picks which ones:
- Off: none. It is off to start with.
- Calendar events: an instance Modbot opened for a calendar event, and one in the world of an event that is on.
- Any group instance: every instance of your group.
- Opened from Modbot: only an instance Modbot opened itself, on time or with Open now.
Only an instance first seen after you chose a setting, and less than two hours ago, gets a post, and each instance gets one. The post is the instance's name, ... has started. and its join link, for the group, with Notify members off.
By default the post is a draft in Drafts, and the host is told on Discord with a link that opens it in the form. The host is the event's host, else the person who pressed Open now; if neither can manage posts, everyone who can is told, as their notification settings allow. Edit it or Post now.
Post without a draft posts at once instead, with no draft and no message.
An event with Announce in VRChat when the first person joins ticked posts for itself, and gets no second post from here. An event with Announce on Bluesky when the first person joins ticked has its reply under the date's Bluesky post listed here as a post of its own.
Health
The Posts card on Health shows:
- Paused while all posting is paused;
- Discord, VRChat or Bluesky, when posts are waiting on it and it is Off or Not set up;
- posts that failed in the last 7 days, each leading to Failed, with the VRChat permission Modbot's account needs when that is why;
- posts Modbot has been looking for on the site for more than 15 minutes.
When there is nothing to say, the card is not shown.
The audit log
Everything done to a post is written to the audit log, under the operational log: who wrote, changed, cancelled or sent it now, each post Modbot sent with its link and exactly what it said, each post that failed with the reason, each edit and delete on a site with who did it (an edit made by Keep updated has no person), and each picture uploaded to VRChat for a post, with who chose it.
What leaves your server
A post goes only where it is ticked, and every place starts unticked.
- Discord: the bot sends the post's title, text and picture to the channel, mentions the role if one was picked, and publishes it to the channel's followers if that was ticked. The channel's readers see it, and so do the following servers' readers.
- VRChat: Modbot's VRChat account posts the title and text in your group, for who was picked (the group, some of its roles, or everyone on vrchat.com), and has VRChat notify the members only if Notify members was ticked. The picture goes only while Upload VRChat pictures is on; it is then uploaded to that VRChat account and stays there as a file on it.
- Bluesky: the post's text, and either a small copy of the picture with the post's title as its description or, with no picture and a link, a card with the post's title and that link, go to the account's own server, and from there are public on Bluesky and copied by other services. Nobody is mentioned.
Nothing about your members goes in a post: no names, no ids, no counts. See Privacy.
World lists
Keep lists of worlds in Modbot, let an event pick its world from one, and use Next game during a game night to pick the next world that fits how many people are there.
Bluesky
Connecting Modbot to your group's Bluesky account, with an app password or by signing in with Bluesky, so posts from the Marketing page can go to Bluesky too.