How to use JustLFG

JustLFG puts your raids and game nights right in Discord. You post an event, people tap a button to join, and everyone gets a reminder before it starts. This guide covers everything it does, one task at a time.

Get started

1. Add JustLFG to your server. Use the button below and pick your server. It asks for the permissions it needs. If you skip some, you can add the bot again later with the same button to fill them in; nothing gets reset.
2. Set your time zone. Type /lfg timezone and start typing your city. Now when you type "8pm", JustLFG knows you mean your 8pm. Everyone sees event times in their own zone automatically.
3. Post your first event. Type /lfg create on its own and a step-by-step panel opens. Fill in what and when, then press Post event.

＋ Add to Discord

Joining events

Every event post has buttons. Here's what each one does.

Just for you

• Reminders. If you're Going, JustLFG sends you a DM a day before, an hour before, 15 minutes before, and at the start. You also get a DM if the event is cancelled or moved. Don't want them? /lfg reminders mute:true turns yours off.
• Your calendar. /lfg list shows upcoming events and gives you a private calendar link. Add it to Google Calendar, Apple Calendar or Outlook once, and every event you're going to shows up there and stays up to date, across all your servers. Every event post also has an Add to calendar link.
• When you're free. /lfg availability set lets you pick the days and times you usually play and the roles you like. Hosts use this to find the best time. /lfg availability show shows the group's best times.
• Your track record. /lfg reliability shows how often you turned up to events you said yes to, once hosts have marked attendance.
• Delete your data. /lfg forget-me removes everything JustLFG has about you, in every server: RSVPs, votes, notes, time zone, saved answers and settings. It asks you to confirm first.

Hosting events

Two ways to post

• The panel (easiest). Type /lfg create on its own. Press Edit details to fill in the name, time, description, game and how many people. The panel shows the time it understood, so you can catch a wrong time zone before posting. It also warns you if the bot is missing a permission it needs. Press Post event when it looks right.
• One line. /lfg create what:Vault of Glass when:Friday 8pm posts straight away. You can even type it all in one go: /lfg create what:Raid Night Friday 8pm.

Times you can type

• Friday 8pm · tomorrow 9:30pm · tonight · in 2 hours
• Aug 30 8pm · 8/30 8pm · next Tuesday 7pm
• Fri 8pm EST · 8pm Central · 8pm London: add a zone and it's read in that zone instead of yours. "EST" follows daylight saving, so "8pm EST" in July means 8 PM New York time.

"Tuesday" means the coming Tuesday, or today if it's Tuesday. "Next Tuesday" skips a week.

Extras you can add

All of these are optional. Most are buttons in the panel; the name in brackets is the option for the one-line version.

After it's posted

Press ⚙️ Manage on your event. Only you, your co-hosts and the server's admins can open it.

• ✏️ Edit reopens the panel with everything filled in. If you move the time, everyone going gets a DM, and the event's chat gets a "Time changed" message.
• 🔔 Remind team DMs everyone who's going, right now.
• ❌ Cancel asks you to confirm, then lets everyone going know.
• ✅ Mark attendance appears after the event so you can record who showed up.

A few commands help too: /lfg cohost lets someone else manage your event with you, /lfg clone copies an event so you just pick a new time, and /lfg template save stores a setup you run often so /lfg template use can post it in one step.

Repeating events Premium

Set 🔁 Repeat in the panel (daily, weekly or monthly), or add repeat:weekly to the one-line version. Add every:2 for every other week, every 3 days, and so on. JustLFG posts the next date by itself.

• Regulars stay signed up. People tap 🔁 Weekly on the event to be marked Going for every new date. They only need to drop the ones they'll miss.
• ✋ Ask me first. Turn this on in the panel and JustLFG DMs you before each date: "Post the next one?" with Post it, Skip this one and Stop the series. Nothing posts until you say so. If you don't answer by the start time, that date is skipped.
• Skip or stop. In ⚙️ Manage: ⏭️ Skip next skips the next date that hasn't been posted yet. ❌ Cancel this one cancels one date and the rest carry on. 🔁 Stop repeating ends the series but keeps dates already posted. 🛑 Cancel series cancels every upcoming date and ends it.
• How far ahead. By default JustLFG keeps a week of dates posted. Admins can change this with /lfgconfig lookahead; 0 posts the next date only once the current one starts.
• Server rule. Admins can allow repeating events, require every host to confirm each date, or turn them off, with /lfgconfig recurring. This setting is free.

Who's it for Premium

Keep an event's sign-ups to some roles, like a raid team or members only, without picking roles on every event. An admin sets up rules once, and hosts pick one when they post.

1. Set up a rule. On the web dashboard, open your server's Manage tab, then Settings, and find Event rules under New features. Give it a name, pick the roles that can sign up, a role to ping if you want one, and where its events post.
2. Pick it when you post. In the /lfg create panel, press 🔒 For: and choose the rule. Creating from the dashboard has a Who's it for choice. Run /lfg create inside a rule's own channel and that rule is picked for you.

• Its own channel, or the regular one. Give a rule its own channel and its events post there, hidden from anyone without the roles: on the board, in /lfg list and on the web events page. Lock that channel to the same roles in Discord too, and make sure JustLFG can post in it. Or use the regular events channel: everyone sees the event, marked "🔒 Who's it for", and only those roles can sign up.
• Who can post under a rule. Anyone with one of its roles, anyone with a role ranked above the highest of them, and admins.
• Who can sign up. Only people with one of the rule's roles, whether they use the Discord buttons, bring guests, pick a role slot or answer on the web events page. The host can always sign up.
• Kept in your server. Rule events don't appear on your public events page or calendar feed, and aren't shared to linked servers, since their members don't have your roles. A repeating event keeps its rule on every date.
• Limits. Up to 10 rules per server, with up to 10 roles each. An event's rule is set when it's posted and can't be changed afterwards, and templates don't save a rule yet.
• Removing a rule, or leaving Premium. Removing a rule opens its events to everyone. If your server leaves Premium, events already under a rule stay locked, but new events can't use one.

Fireteams

For groups with a fixed size, like a 6-person raid. Set a fireteam size with 👥 Fireteams in the panel (off, 3, 4, 5, 6 or 8), fireteam:6 in the one-line version, or a game setup.

• Teams fill up and grow. Going fills Fireteam 1. Once it's full, Fireteam 2 starts, and so on, so a popular raid becomes two or three full teams by itself. The post shows each team and how many it still needs, like Fireteam 2 (2/6) · needs 4.
• Want exactly one team? Also set Max going to the same number. Everyone after that waits as a sub and moves in when a spot opens.
• ⚖️ Balance fireteams Premium. People who join are asked, privately and only once per game (for Destiny 2, once per raid or dungeon, since clears differ from one to the next), how much they've played it: 🌱 first time, 🔹 1–4 runs, 🔷 5–19, or ⭐ 20+. The host presses ⚙️ Manage → Balance fireteams to spread experienced and new players evenly. Full teams stay full, and anyone joining later fills the open spots.
• Fireteams and roles can't be used on the same event yet.

Polls

Not sure when to play? Type /lfg poll on its own to open a panel, or list the times in one line: /lfg poll what:Raid night times:Fri 8pm, Sat 8pm, Sun 3pm.

• People vote for every time they can make. The winning time becomes an event.
• Add closes:in 24 hours and the poll closes and posts the winner by itself.
• To close it early or cancel it, press ⚙️ Manage on the poll. Only the person who made it, or the server's admins, can.
• Add network:True to run the poll across your linked servers. Votes from every server count together.
• A poll can offer up to 6 times, or 8 with Premium.

Linking servers

If your community is spread over several Discord servers, link them so one event, and one signup list, covers everyone.

1. One server creates the link. An admin types /lfg network create name:… and gets a join code.
2. Others join with the code. Their admin types /lfg network join code:… and picks the channel where shared events should appear.
3. Share an event. In the panel, pick the network to share to (or add network:True). The event appears in every linked server with a "Hosted in" label, and signups from all servers land on one list.

• Talk across servers. Press 💬 Discuss on a shared event, or right-click a message in the event's chat and choose Apps → Share to the network. The message appears in each server's chat for that event. This needs event chats turned on (/lfgconfig eventspace).
• Other tools for admins. /lfg network info shows your links and join codes, /lfg network announce posts a message to every linked server, /lfg network channel moves where shared events post, and /lfg network leave unlinks. When a server leaves, shared posts of upcoming events come down on both sides; signups stay.
• Managing a link. The server that owns a link gets a Manage button in /lfg network info, and a Network tab on its page in the web dashboard. From either one its admins can rename the link, get a new join code, remove a server, choose whether every server or only the owner can send announcements, and hand the link over to another server, which accepts within 7 days. The server's Discord owner can also appoint people to manage it. To leave a link you own, hand it over first, or disband it.
• Choosing what comes in. Each linked server decides what it takes from a link: in /lfg network info, press What we receive, or use the New features section of the dashboard's Settings tab. You can take only certain games, mute a server so its events and polls stop posting here, or turn shared polls off. It applies to new posts; ones already here stay until their events end. A member you've blocked also can't sign up for partner events shown in your channels.
• Pings for shared events (Premium). Linked servers' events arrive quietly unless you choose a role to mention. On Premium, pick it under What we receive in /lfg network info, or in the dashboard's New features, where you can also pick a different role for each game. Only the first post of each new event pings.
• Weekly digest (Premium for the link's owner). Turn it on in the dashboard's New features and pick a day and time; every linked server gets one post a week listing the coming seven days of shared events. Each server can pick its own day and time instead, like Tuesdays for a game's weekly reset. Times show in each reader's own time zone.
• Branding and a featured listing (Premium for the link's owner). Put your link's name and color on every new shared event, and list it first in the directory with a Featured badge and a longer description.
• A public page and one calendar (Premium for the link's owner). Turn on a web page at bot.justlfg.app/n/your-link listing every upcoming shared event, with one calendar link that adds them all to Google or Apple Calendar. Set it up in the dashboard's New features.
• Insights (Premium for the link's owner). On your Network tab, see the last 90 days: events per server, turnout and fill rate on shared events, the top games, and which servers' members join whose events. Only counts are shown, never names.
• When a shared event can't reach you. If a linked server's event or poll can't be posted in your server (a missing permission, a deleted channel), you can be told: pick a channel under New features in the dashboard. It's off unless you turn it on, and says at most once a day. Picking a network channel most members can't see, or one JustLFG can't post in, shows a warning but is still allowed.
• Blocking someone across a link. The server that owns a link can block a person from every linked server's shared events and polls: Manage → Blocked people in Discord, or the owner's Network tab on the dashboard. Each server's own block list still works too.
• Finding a link to join. A link's owner can list it in the directory from the New features section of the dashboard's Settings tab, with a short description. Member server names stay hidden unless the owner shows them. Admins of other servers find listed links with room in the Network tab under Find a network, pick a channel and ask to join. The owner gets the request in Discord with Approve and Decline, and has 7 days to answer. Join codes still work.
• Limits. Joining is always free. On Free, a link holds up to 3 servers and a server can be in one link at a time. Premium removes both limits.
• Who manages what. Only the host server can edit or cancel its shared events. Admins of linked servers can't.

Server setup

Admins (people with Manage Server) can set these with /lfgconfig, or on the web dashboard. /lfgconfig show lists your current settings.

Handy admin tools

• /lfg board posts one message listing what's coming up, kept current automatically. On Free it shows up to 8 of your server's events; Premium adds shared events and shows up to 12.
• /lfg check shows what JustLFG can and can't do in a channel, and /lfg reinvite gives you a button to add the bot again with any missing permissions.
• /lfg reload posts upcoming events again if their messages were deleted. Signups are kept.
• /lfg stats and /lfg history show how many events you've run, attendance, and your most-played games.

Web dashboard

Sign in with Discord at bot.justlfg.app, the same place as your events. Manage servers next to your name lists every server you manage; on a server's page, Manage this server opens just that one. bot.justlfg.app/app goes straight to the list with the same sign-in.

• Anyone can get their private calendar link there, and make a new one if the old one gets shared by mistake.
• Admins (the server owner, or anyone whose roles give Administrator or Manage Server) get a Manage tab for that server and can change every setting in plain language, plus see activity charts. If you lose Manage Server, the tab goes within 15 minutes, and straight away when you try to change something.
• Premium servers can also create, edit and cancel events from the browser, with every option on one screen, a live preview and the signup list.

Your events on the web

Any member can see every JustLFG event they can see in a server on one page, grouped by channel and day, in their own time zone. It's on in servers with Premium, and in any server linked to a Premium server through a network.

1. Get your link. Type /lfg web in the server. JustLFG sends you a private link that works once, for 10 minutes. Don't share it.
2. Open it. You're signed in on that device. Or go to bot.justlfg.app and sign in with Discord to see all your servers at once.
3. Open an event. Tap a card, or its Details button, to see everything the post shows: the description, who's going, the waitlist, Maybe, Can't and notes. Tap again to fold it.
4. Answer from there. Press Going, Maybe or Can't on any event, or open it in Discord. Events where you pick a role are answered in Discord. If an event is full, you'll see your place on the waitlist.

• Only what you can see. The page follows the server's channel permissions exactly, so events in channels your roles can't see stay hidden. If you lose a role or leave, the page catches up within 15 minutes, and straight away when you try to sign up.
• Happening now. An event stays on the page until it ends, so you can find the post while it's on.
• Your calendar (optional). At the bottom of the page, Show my calendar link gives you a private link to a calendar of every event you're going to, in any server, kept up to date. Showing it adds nothing. Open my calendar app lets your calendar app ask before it adds a separate "Your JustLFG events" calendar, which you can remove any time. Keep the link private; if you share it by mistake, replace it there, and calendars using the old one stop updating.
• If you manage the server. A Manage this server tab sits next to Events. Where the events page isn't on yet, /lfg web still gives you a link to Manage.
• Linked servers. Servers linked with yours are listed with their logos, under each network's name. A server can choose to show its public channel names and a Join server button there, from the dashboard's New features; both are off unless it turns them on.

Free and Premium

Everything you need to run events is free. Premium is for busy servers and costs $4.99 a month or $49.99 a year, with a 7-day free trial. It's per server: an admin types /lfg upgrade, and /lfg premium shows your server's plan.

Every command

Type these in any channel. Admin needs Manage Server. Premium needs a Premium server. Everything else works for everyone, on Free.

Stuck, or something not working? Email support@justlfg.app.