Skip to content

Releases: DeadEndReece/ProFilter

ProFilterV1.1

22 Mar 00:13
@DeadEndReece DeadEndReece
V1.1
f77d23f

Choose a tag to compare

View all tags
ProFilterV1.1 Latest
Latest

-V1.1- Updated to include /pf.lookup for live ID fetching and profile verification.
-V1.1- Now uses BeamMP ID for admin authentication instead of username for improved security and reliability. (Suggested By Titch)

Assets 3
Loading

ProFilter V1

14 Mar 04:50
@DeadEndReece DeadEndReece
V1
178b1bd

Choose a tag to compare

View all tags
ProFilter V1

ProFilter - Advanced Chat Filter for BeamMP

Made by DeadEndReece (UkDrifter) & help of AI "People judge, but hey, if it does what you want thats all that matters right? - Reece 2026"

ProFilter is a highly customizable, server-side profanity filter for BeamMP. It intercepts chat messages before they are broadcasted to the server, actively preventing toxicity while giving server owners complete control over how rule-breakers are handled.

✨ Features

First Launch Setup Wizard - Get your filter up and running in minutes with an interactive console setup. (With options to load a default wordlist, enable censoring, logging, and more right from the start!)

Customizable Messages - Tailor the messages sent to players when they trigger the filter or join the server.

Adaptive Detection - Catches common obfuscation techniques like leetspeak (e.g., "4" for "a", "0" for "o") and ignores harmless punctuation to ensure bad words are still caught.

Censor Mode - Replace bad words with a character of your choice instead of blocking the whole message.

Replace Mode - Swap out bad words for a custom replacement (e.g., [REDACTED], Meow).

Action Logging - Optionally save intercepted messages, player IDs, and timestamps to a log file for moderation review.

Dynamic Word Management - Add or remove forbidden words on the fly via console or in-game commands.

Admin Management - Authorize specific players to use ProFilter commands in-game.

📥 Installation

  1. Download the ProFilter zip file.
  2. Extract the folder into your server's main directory. (It should create a Resources/Server/ProFilter/ folder with the necessary files inside.)
  3. Start your BeamMP server.
  4. Look at your server console! After starting the server, an interactive Setup Wizard will guide you through the first-time setup.

🛠️ Commands

Commands can be used in the server console (e.g., pf.aw word) or in-game by admins using a forward slash (e.g., /pf.aw word).

  • pf.help (pf.h): View all ProFilter commands and usage instructions. (In-game and Console)
  • pf.menu: Open the interactive settings menu in the console. (Console only)
  • pf.status (pf.st): View current filter configuration and stats. (In-game and Console)
  • pf.list (pf.l): List all words currently in the filter. (In-game and Console)
  • pf.addstrict (pf.as) <w1,w2>: Add heavy swear(s) (In-game and Console)
  • pf.remstrict (pf.rs) <w1,w2>: Remove heavy swear(s) (In-game and Console)
  • pf.addword (pf.aw) <w1,w2>: Add short swear(s) (In-game and Console)
  • pf.removeword (pf.rw) <w1,w2>: Remove short swear(s) (In-game and Console)
  • pf.clearwords (pf.cw): Clear all words from the filter (use with caution!)

🛡️ Admin Setup

To use in-game commands, you must first authorize yourself via the server console:

  1. Type pf.au YourInGameName in the server console. (Replace YourInGameName with your actual in-game name. Case-sensitive!)
  2. You can now use /pf.h in the BeamMP chat To see the available commands and manage the Wordlist directly from the game.

📂 Data Management

  • data.txt - Stores the wordlist, admin list, and configuration settings. Do not edit this file manually unless you know what you're doing. Use the provided commands to make changes. (Note: if you edit this file while the server is running, you must restart the server for changes to take effect.
  • logs.txt - If logging is enabled, this file will contain a record of all intercepted messages, including player IDs, names, original messages, and timestamps.

⚠️ Important Notes

  • ProFilter is designed to catch common profanity and obfuscation techniques, but no filter can guarantee 100% effectiveness. Regularly review and update your wordlist as needed.
  • Always keep backups of your data.txt file, especially before making bulk changes or using the factory reset command.
  • If you encounter any issues or have suggestions for improvement, please reach out to my github or the BeamMP community forums.
Loading