The handler is a server script that lives in your Roblox game and talks to Evalyn. Without it, Evalyn knows nothing about what happens in-game.
What it handles
- Shifts — clocking in and out, with correct durations.
- Bans and blacklists — enforced when someone joins.
- Activity tracking — including AFK detection.
- Chat logging.
- In-game commands —
/ban,/warn,/blacklist,/status.
Installing it
- Go to Developer → Scripts & Modules.
- Press Generate script.
- Download or copy it.
- Paste it into a Script in
ServerScriptService. - In Roblox Studio, open Game Settings → Security and switch on Allow HTTP Requests.
Generating rotates your secret
The script contains your workspace's API secret, which is stored hashed — Evalyn cannot show it to you again later. That has a consequence worth understanding:
Generating a script invalidates the previous one. Any place still running an older copy stops reporting until you install the new one. If you run several games, plan to update them together.
Only the workspace owner can generate a script, because the action mints that secret.
Updating it
When Evalyn adds handler features you need to regenerate and reinstall to get them — the script is a copy, not a live connection. Announcements will tell you when it is worth doing.
When it is not working
- Nothing at all arrives — check Allow HTTP Requests is on. This is the usual cause.
- It worked and then stopped — the secret was probably regenerated somewhere else. Reinstall the current script.
- Shifts but no chat logs — see below.
Chat logs specifically
Roblox has two chat systems. Older versions of the handler listened only to the legacy one, so on any modern experience the commands worked and chat logging silently did not. If your chat logs are empty while everything else works, regenerate and reinstall the script.