How to use AFKify

Getting started

From download to your first macro in about five minutes.

Install AFKify

The public beta opens on 19 December 2026. Until then, beta testers get the installer in our Discord; after that, it’s on the download page. AFKify runs on Windows 10 and 11. It doesn’t need administrator rights, and it keeps itself up to date: it asks before installing a new version, and never in the middle of a macro.

If Windows says “Windows protected your PC”, click More info, then Run anyway. The download page explains why.

Open Roblox

Start Roblox the normal way, from the Roblox website or app, and join your game. AFKify works with the Roblox app for Windows. It doesn’t work with the Microsoft Store version of Roblox.

Roblox in a window works best. Press F11 in Roblox to switch between a window and full screen (see windowed or full screen?).

The AFKify window

1. Menus. File opens, saves, imports and publishes packs. Edit has Undo, Record steps in Roblox… and Settings…. Account is for signing in and your packs. Help has this guide and the debug report.
2. Toolbar. Import a pack by its code, Browse packs other players shared, Publish yours, and Settings.
3. Your pack. Its Name, the Game it’s for, and About (what it does).
4. Editing. Which macro you’re working on. A pack can hold several. This is also where you find the interrupts and the watchdog.
5. Add step and Record…, then Duplicate, Delete, ▲ ▼ to move, Turn off, Undo and Redo.
6. The step list. Your macro, top to bottom. Click a step to change it.
7. Step settings. Everything about the step you clicked.
8. Test shows the game live and whether a check finds what it looks for. Run starts and stops your macro and shows what it’s doing.

How AFKify finds Roblox

You don’t have to pick a window. AFKify finds the Roblox game window by itself. If more than one Roblox window is open, it uses the one in front.

AFKify sees the game the way you do: by looking at the window. To click and press keys for you, Roblox has to be the window in front while a macro runs, and it can’t be minimised. Settings → Game window shows how AFKify is seeing Roblox right now.

Your first macro in 5 steps

Example: claim a reward as soon as the Claim button shows up.

1. In Roblox, go to where the Claim button appears, so AFKify can see it.
2. In AFKify, click Add step → Wait & check → Wait until something appears.
3. In its settings, press Capture image. You get a screenshot of the game: drag a box tightly around the Claim button and press Enter.
4. Click Add step → Mouse → Click. It’s already set to click on What the last check found, so it clicks the Claim button the step before found.
5. Save with File → Save (Ctrl+S). Your pack is saved as an .afkpack file.

Run it, and stop it

1. Open the Run tab, pick the macro and press Start.
2. You get 3 seconds to click into Roblox. It says “Starting in 3… switch to Roblox”.
3. Press F8 to stop, even while you’re in the game. Or press Stop in AFKify. Your mouse and keyboard are yours again.

To keep it going, add a Repeat steps step and drag your other steps onto it. Add a Wait a moment inside too, so it doesn’t spam. You can change F8 in Settings → Hotkeys.

Handy editing tips

• A new step goes after the step you selected, or inside it if it holds steps (like Repeat steps).
• Drag steps to move them. Drop one onto a Repeat or an If to put it inside.
• Right-click a step for Copy, Paste, Duplicate, Delete and more.
• Turn off (Ctrl+E) skips a step without deleting it. Great for testing.
• Shortcuts: Ctrl+Z undo, Ctrl+Y redo, Ctrl+D duplicate, Del delete, Ctrl+↑/↓ move.
• A step with a problem gets a warning sign, and its settings say what’s wrong (like “Choose where to click.”).

Steps, one by one

A macro is a list of steps. AFKify does them in order, top to bottom. Click Add step to pick one from six groups.

Every step also has two settings at the bottom:

Note

Optional: a name to show in the list, like “Claim reward”. Makes long macros easy to read.

Turned on

Untick it to skip the step without deleting it.

Some steps hold other steps: Repeat steps, If something is on screen… and If a counter is…. An If has two parts in the list, Then and Otherwise. Drag steps into them, or select one and use Add step.

Looking at the screen

Wait until, If, Repeat (“Stop when something is on screen”) and interrupts all look at the game. Their What to look for box sets what they look for.

Choose a kind under Look for:

The search area

The search area is the part of the game window to look in, set as Left, Top, Width and Height (in % of the window). Press Pick area on screen to drag a box on a screenshot, or Whole window to look everywhere.

A smaller area is faster and finds the wrong thing less often. If the thing can appear anywhere, use the whole window.

How sure it must be

• Images: Match. Lower finds it more easily but may find the wrong thing. Higher is pickier. Try between 75% and 90%.
• Pixel colours: Colour match. Exact means exactly that colour. Move it towards Loose if the game’s lighting changes the colour a little.
• Screen changes: Change needed. A little reacts to small movements. A lot needs a big change, like a menu opening.

Test it in the Test tab

Click any step that looks at the screen and open the Test tab. It shows the game a few times a second, with the search area and what it found drawn on it, plus a line like:

• “Found · 93% match”: it works.
• “Not found · best 61% (needs 85%)”: the closest thing on screen only matched 61%. Capture the picture again, or lower Match a little if the best is close.

Pause stops refreshing. Test once grabs one new frame and tests it.

Tips for good pictures

• Box tightly around one button or icon. Big boxes are slow and stop matching when anything inside them changes.
• Include edges or text. A box of one plain colour can’t be found, so use a pixel colour check for that.
• Leave out things that move or change, like timers, numbers, your character or the sky.
• Keep Search only near here ticked if the thing is always in the same place. Untick it if it can appear anywhere.
• Tick Colours matter when the same shape comes in different colours, like a grey and a green button.
• Capture at the window size you’ll run at. AFKify gives Roblox your pack’s size (Resize Roblox when starting in the Run tab, 1280×720 for new packs) before each picture, and again every run (see game window size).
• Changed your graphics or UI scale in Roblox? Capture the pictures again.

Macros, interrupts and the watchdog

A pack can do more than one list of steps. Pick what you’re editing in the Editing list at the top.

Macros calling macros

A pack holds one or more macros for a game. The Main macro is always there. New macro… adds another, and Rename… and Delete… change it.

• Description: what the macro does. Players see it when they pick it in the Run tab and on the hub.
• Players can start this macro: untick it for a helper that only other macros run.

Use a Run another macro step to run one macro from another. Example: a main macro that mines, and an “Auto sell” helper it runs when the backpack is full. Change the helper once, and every macro that runs it gets the change.

Interrupts

An interrupt is something to watch for between steps, like a “Disconnected” box. AFKify checks for it between steps and while waiting. When it’s found, the macro pauses, the interrupt’s own steps run, then the macro restarts or carries on.

Click New interrupt, or choose Interrupts in the Editing list to see them all.

Name

What to call it, like “Disconnected”.

When this is found

What to look for (see Looking at the screen).

Afterwards

Restart the main macro from the top, or Carry on where it left off.

Cooldown

Wait at least this long before this interrupt can happen again. Starts at 10 s.

Turned on

Interrupts that are turned off are never checked.

Example “Disconnected”: when the Disconnected box shows, open your private server link, wait 30 s, then restart the main macro from the top.

The watchdog

The watchdog rescues a macro when the game looks frozen. Choose Watchdog in the Editing list and tick Watchdog on: if the screen doesn’t change for the time you set (120 s at first), it runs the steps you put there, then restarts the main macro from the top.

Example Press Esc, then open your private server link to rejoin.

Counters

Counters are numbers your macro remembers (see the Counters steps). They start at 0 when you press Start, keep counting when an interrupt or the watchdog restarts the macro, and show in the Run tab while it runs. Put one in a Discord message with curly brackets, like {fish}.

Game window size

In the Run tab, Resize Roblox when starting makes Roblox’s game area exactly the same size each time the macro starts: Off, 1280×720 (recommended), 1600×900, 1920×1080, Current size or Custom…. It’s saved with the pack, so everyone who imports it sees the game at the size it was made at, and its clicks and pictures line up.

New packs start at 1280×720. Nearly every screen fits it, so nearly every player sees the game just as you did. Packs you open, import or fork keep their own size, and packs from before sizes existed stay Off.

When you take a picture for a check, or press Record…, AFKify first gives Roblox your pack’s size, so what you make matches the size the pack runs at. A note says so: “Roblox is now 1280×720, this pack’s size”. If Roblox can’t be resized (it’s in full screen, say), the note says why and AFKify carries on at the size Roblox is. With Off, Roblox is left alone.

On a screen too small for the pack’s size, like 1280×720 on a 1366×768 laptop once the taskbar and Roblox’s title bar take their share, AFKify uses the biggest size of the same shape that fits and tells you once per run: “This pack was made at 1280×720. Your screen fits 1216×684, so AFKify scales everything to match.” Pictures and click spots are scaled with the window, so most games work like this. Some games keep their buttons the same size in pixels whatever the window’s size; if clicks miss, try a bigger screen.

Choosing a size bigger than 1920×1080 (with Custom…, or Current size on a big monitor) shows a warning: most players’ screens can’t fit it, so their game would be scaled down. 1280×720 works for nearly everyone.

Sizes are real screen pixels. With Windows display scaling at 125% or 150%, 1280×720 looks smaller on your screen, but it’s the same picture of the game, so the pack works the same for everyone.

Recording

Don’t want to add steps one by one? Play the game and let AFKify write the steps for you.

1. Open Roblox and join your game.
2. In AFKify, press Record… (next to Add step), or Edit → Record steps in Roblox…
3. A small box in the corner says “Recording in 3… switch to Roblox”. Click into Roblox.
4. Play. The box shows “Recording · F9 to stop” and how many steps it has so far.
5. Press F9 to stop. Then choose which steps to keep.

You can change F9 in Settings → Hotkeys. It can’t be the same key as the one that stops a macro.

What becomes what

Left out: the stop key, the countdown, Alt+Tab and Alt+F4. The recorder only picks up what you do while Roblox is the window in front.

The review screen

When you stop, Recorded steps lists everything it made, all ticked. Clicks show a picture of what you clicked.

• Untick anything you don’t want. Open a row to tick its steps one by one. Tick all and Untick all do them all at once.
• For each click with a picture, choose:
  • Find it by picture: waits until it sees what you clicked, wherever it is. Best for buttons and menus.
  • Same spot every time: clicks the same place in the window. Best for the game world, where things look different each time.
  The recorder picks Same spot by itself when what you clicked was moving just before the click.
• Insert adds the ticked steps after the step you selected. Discard throws the recording away.

Recorded steps are normal steps, with notes like “(recorded)”. Change them like any other.

Running a macro

Everything about running is in the Run tab.

Starting and stopping

• Macro: which of the pack’s macros to run.
• Start in 3 s: gives you time to click into Roblox. Change the seconds in Settings → General.
• Start: during the countdown it says “Starting in 3… switch to Roblox” and the button becomes Cancel.
• Stop (F8): stops the macro. Pressing F8 in the game does the same.

While it runs, keep Roblox in front and don’t minimise it. AFKify presses keys and clicks like you would, so it needs the game window.

What the Run tab shows

Status

Ready, Running, then the result: Completed, Stopped, Stopped by step or Failed with the reason.

Step

The step running right now.

Elapsed, Loops, Restarts, Interrupts, Watchdog, Steps

How long it’s been running, how many times it went round, how often it restarted, and so on.

Log

Everything that happened, with times. Problems show in colour.

Counters

Your counters and their values.

Show detections

Shows the last picture of the game it checked, with what it looked for drawn on it.

Game window

Resize Roblox when starting (see game window size).

Under it, a line sums up your settings, like “Stop hotkey F8 · 3 s countdown · Discord on”. Settings… changes them.

Discord pings

AFKify can message you on Discord, so you know what’s happening while you’re away. Set it up once:

1. In your own Discord server: Server Settings → Integrations → Webhooks → New Webhook → Copy Webhook URL.
2. In AFKify: Settings → Notifications, paste it into Discord webhook, and press Send test.
3. Choose what you want: a message when a macro finishes, when it fails, or both.

Add Send a Discord message steps for your own pings, like “Rare fish caught!”. Keep your webhook link private: anyone who has it can post in that channel.

When a run stops because something wasn’t found

If a “Wait until” step gives up, the run stops with a line like “Failed: timed out after 30s waiting for image”, and the Run tab shows which step it was on. To fix it:

1. Get the game to where that step runs, click the step, and open the Test tab.
2. If it says “Not found”, press Capture again and box the same thing on your screen. If the best match is close, lower Match a little.
3. If it’s a recorded click on the game world, switch it to a fixed spot: turn off the “Wait until” step just above the click, set the Click to A spot I choose and press Pick on screen. Or record it again and choose Same spot every time.
4. If the thing just takes a while to show up, make Give up after longer.
5. If it’s fine for it to be missing sometimes, set If it never appears to Carry on with the next step.

More ideas in a picture is never found.

Packs and sharing

A pack holds one or more macros for a game. Share yours, or import one someone else made.

Share codes and pack files

• Hub codes look like AFK-7KQ2-XP9F. You get one when you publish a pack to the hub.
• Pack files end in .afkpack. File → Save makes one, and you can send it to a friend.
• Text codes start with AFK1: and hold a whole small pack. File → Copy text code makes one, if the pack’s pictures are small enough.

Importing a pack

1. Press Import in the toolbar (or File → Import pack…, Ctrl+I).
2. Paste the code and press Import. Or find a pack in Browse packs.
3. Read what the pack will do, check its pictures on your screen, then press Import.

Importing needs a free account: you sign in with Discord. Other players’ packs count as imports. The free plan has 3 imports a month, and the count resets on the 1st. Pro has unlimited imports. The Account menu shows how many you have left. These never count: reopening a pack you already imported, updates, and your own packs. Opening someone else’s .afkpack file counts like importing their code. See pricing for Pro.

“This pack will…”

Before anything is imported, AFKify tells you what the pack does, in a list like:

• Click on things it finds on the screen
• Press keys: E, W (and hold some down)
• Keep running until you stop it
• Send alerts to your Discord webhook
• Resize the game window to 1280 × 720

Two things stand out because they reach outside the game’s controls: Type text into the game (for example, in chat) and Open Roblox links (to join or rejoin a game or server). If a farming pack wants to type in chat and you don’t know why, don’t import it.

Then Check this macro on your screen tests the pack’s pictures on your screen. Open the game, get to where it runs and press Re-test all. If a picture isn’t found, press Re-capture… and drag a box around the same thing on your screen.

Browsing packs

Browse packs searches the hub. Search by words or game, and sort by Newest, Most downloaded or Top rated. Pick a pack to see its macros, ratings, forks and what it will do. From there you can:

• Import it.
• Fork… it: make your own copy to change and publish as a new pack. The hub shows it as a fork of the original.
• Copy code to share it.
• Rate it 👍 or 👎, once you’ve imported it and tried it.
• Report… it (see reporting a pack).

Updates from the creator

When the creator publishes a new version of a pack you imported, a bar appears at the top of AFKify, like “Update available for Night Fishing: version 2 → 3”. It shows their notes and what the new version does differently. Then:

• Update downloads it and checks it on your screen, like an import. It doesn’t use an import. Save afterwards to keep it.
• What changed? shows all the notes.
• Not now hides it until you start AFKify again. Skip this version hides it for good.

If a creator stops working on a pack, the bar says “The creator has discontinued this pack”, and may offer a pack they recommend instead.

Publishing your pack

1. Press Publish in the toolbar (or File → Publish pack to hub…).
2. Check its Name, Game and Description. Say what it does, where players should stand and which settings it needs.
3. Press Publish. You get a code: Copy code, or Copy a message for Discord.

Free accounts can have up to 3 packs on the hub. Pro can publish as many as you like. Publishing needs a Discord account that’s at least 30 days old. Names and descriptions can’t have rude words or contact details like links or Discord invites.

Updating your pack: publish it again and choose Update AFK-…. Write What’s new? so players know what changed. Everyone who has it is offered the new version. Publish as a new pack gives it its own new code instead.

Hiding, unpublishing and discontinuing

• Account → My packs… lists your packs. Edit details… changes their name, game and description on the hub.
• Unpublish takes a pack out of search and stops new players importing it. Players who have it keep it, and forks still credit you. It also frees one of your 3 free spaces. Publish again brings it back.
• Discontinue… (on your pack in Browse packs) tells players you’ve stopped working on it, and lets you recommend another pack instead.
• Moderators can hide packs that break the rules. My packs shows it, like “Hidden while moderators look at reports”.

Reporting a pack

Found a pack that steals items, scams, breaks Roblox rules or has a rude name? In Browse packs, pick it and press Report…. Choose what’s wrong, add details if you like, and press Send report. Reports go to the hub’s moderators, who hide packs that break the rules. You need to be signed in, and reports from players who imported the pack count.

Settings

Open them with the Settings gear, Edit → Settings… or Ctrl+,. Changes are saved as you make them.

General

Countdown before a macro starts

Time to click into Roblox after you press Start. 3 s at first. Off starts straight away.

Ask before closing while a macro runs

So closing AFKify by accident doesn’t stop your macro.

Hotkeys

Stop a macro

Press it in the game to stop the macro that’s running. F8 at first.

Stop recording

Press it to finish recording your clicks and keys. F9 at first.

Pick two different keys. Don’t use a key your macro presses.

Notifications

Discord webhook

Where Discord messages go (see Discord pings). Send test checks it. Send a Discord message steps post here too.

Message me when a macro finishes

After runs longer than a minute, or when you stop one.

Message me when a macro fails

Says what went wrong, so you can fix it when you’re back.

Play a sound when a macro ends

When it finishes or fails on its own.

Game window

Capture method

How AFKify sees Roblox. Auto (recommended) is right for almost everyone. Window capture sees Roblox even when other windows are on top of it. Screen capture copies the part of the screen where Roblox is, so keep Roblox uncovered. Under it, “Now using:” says which one is working.

Resize Roblox when starting

Saved in each pack, so you set it in the Run tab (see game window size).

Roblox camera

Camera sensitivity

Set it to the number in Roblox’s own settings (Esc → Settings → Camera Sensitivity), so Turn the camera steps turn the right amount.

Test: turn all the way round

Turns the camera one full circle in Roblox. If the view turned too far, raise the number. If it didn’t turn far enough, lower it.

Updates

Check for updates automatically

AFKify looks for a new version when it starts. Help → Check for updates… looks now.

Update channel

Beta gets new features first. Stable gets them once they’ve been tried out.

Account

Your free account on the AFKify hub: Sign in with Discord, Sign out, or Upgrade to Pro…. Building, saving and running your own macros never needs an account. Signing in lets you import packs from the hub and share your own.

Advanced

Logs folder

What AFKify wrote down while it ran. Handy when asking for help.

Data folder

Where AFKify keeps its own files.

Show the welcome again

The quick tour you saw the first time you opened AFKify.

Reset all settings

Puts everything in Settings back to how it started. Your packs and your sign-in stay.

Troubleshooting and help

Something not working? Start here.

Getting help

1. In AFKify, choose Help → Copy debug report. It copies what support needs to know: versions, your screens, the last run and the log. Your webhook and email are hidden, and nothing is sent.
2. Paste it in #support on our Discord. Say what you expected and what happened.
3. Seeing something odd? Help → Save screenshot of the game… saves what AFKify sees, so you can attach it too.