Skip to content

FAQ / Troubleshooting

Is this bot free?

Yes. I originally made PingMan for my friends and me, and it grew into a hobby project. I don't make any money from it - it's just a side hobby.

Notifications aren't firing - what should I check?

Work through these in order; one of them is almost always the cause:

  1. Is the subscription active? Run /status and look for a ❌ next to the channel. If it's disabled, open it with /setup-channel and click Enable Notifications.
  2. Are server-wide notifications paused? The top of /status shows whether Global Subscriptions are on. If they're off, run /global enable:True.
  3. Does the joiner actually match the trigger? If the trigger is set to specific users or roles, only those joining fires a notification.
  4. Is it still on cooldown? After a notification fires, the channel stays quiet for the cooldown period (anywhere from 15 seconds up to 1 minute). During a join wave, that's expected.
  5. Per-join setting. If it's set to First join only, no further notifications fire until everyone who triggers it has left the channel and someone triggering joins again.
  6. Does PingMan have permission? See the next question.

PingMan says it's missing permissions

For notifications to send, PingMan needs access to the destination channel:

  • Voice channel chat: View Channel, Send Messages, Connect
  • A redirect text channel: View Channel, Send Messages, Embed Links

If a notification fails because of permissions, PingMan will DM the member who joined to flag it, and ask a server admin to grant access. Fix it by giving PingMan those permissions on the channel, then test by re-joining.

Info

When you set a redirect channel in /setup-channel, PingMan checks for the required permissions up front and won't let you save the channel if they're missing.

A user or role in my subscription was deleted

Nothing breaks, and the subscription isn't deleted. PingMan scrubs the stale reference and flags the subscription with a ⚠️ in /status and on the /setup-channel View screen. Open it with /setup-channel, review the settings, and re-save to clear the warning.

Why am I getting pinged after enabling "Pause Notifications"?

Pausing notifications (/settings) only stops PingMan from mentioning you specifically. It can't suppress a notification that pings @everyone, @here, or a role you have - those mentions aren't tied to your user data. To stop those, speak with your server admin.

Can I stop admins from adding me to subscriptions?

Yes. Run /settings edit and turn Subscribable off. You won't be added to new subscriptions, though you'll remain in any you're already part of, and you can still add yourself. See User Settings.

How do I let non-admins manage subscriptions?

Use /access grant /setup-channel <role> to give a specific role access without granting full Manage Server. See Server Management.

What happens to my data if I use /wipemydata?

Your personal user record and settings are removed. Using PingMan again regenerates your record with default settings. It does not remove you from subscriptions an admin set up, and it doesn't affect @everyone/@here/role pings. See /wipemydata.

I have a question or found a bug

Send it straight to the developer with /feedback <message>, or join the support server.