permabanapp | Reddit for Developers

Readme

Overview

PermaBanApp is a highly powerful Reddit moderation tool that allows subreddit moderators to set specific words (both strings and regex) as well as corresponding ban durations across three tiers: Low, Mid, and High. This app helps streamline moderation efforts by automatically applying bans when users use flagged words.

Installation & Setup

How to Install

  1. Go to Reddit Developer Apps.
  2. Find and click on "PermaBanApp" (or navigate directly to developers.reddit.com/apps/permabanapp/).
  3. Click on "+ Add to Community" to install the app in your subreddit.

How to Configure

  1. Go to your subreddit and open Mod Tools (top-right corner).
  2. Scroll down the left sidebar to the COMMUNITY APPS category.
  3. Click on "Installed Apps" and locate PermaBanApp.
  4. Click on "Settings" to open the configuration panel.

Setting Up Ban Rules

In the Installation Settings panel:

  • You will see three sections: Low-Tier Violations, Mid-Tier Violations, and High-Tier Violations.
  • Each section has:
    • "Banned Words" (comma-separated) → Example: word1,word2
    • "Regex Patterns" (one per line) → Example: \b(cat|catr)\b
    • "Ban Duration (in days)" → Example: 3 (Maximum: 365 days)

Finalizing the Setup

  • Once you have added words and ban durations, click the "Save Changes" button.
  • The app will now be active, and moderators can modify settings at any time.

Important Notes

  • Moderators should use good judgment when setting up word bans.
  • Avoid banning large user groups for unnecessary reasons.
  • Ensure that ban durations are fair and appropriate to maintain subreddit engagement.
  • Do NOT set ban durations to 0 days, as this will result in a permanent ban instead of just removing the comment. A fix is being worked on to properly handle 0-day durations.

Changelog

Version 0.0.3

  • Added regex support: Moderators can now enter regex patterns in a separate section below the word list for each violation tier.
  • Ongoing fix for 0-day bans: A fix is in the works currently for the 0 day ban problem. Please DO NOT set bans to 0 days while this is being worked out.

Version 0.0.2

  • Initial release of PermaBanApp.
  • Added support for three-tiered word bans with adjustable durations.
  • Fix incoming: Currently, setting a ban duration to 0 days will permanently ban the user. Please avoid using 0 days for now while a solution is being developed.

About this app