# FamilyFriendly Plugin<\/p>\n
A Minecraft plugin that ensures a safe and age-appropriate chat experience by filtering inappropriate words, links, and spam, with a full moderation and warning system.<\/p>\n
## Features<\/p>\n
– Age verification system (players must set age on first join)
\n– **Underage players are protected:** Only underage players have their chat filtered and are warned\/muted\/kicked\/banned for blocked words
\n– **Adults chat freely:** Adults see and send unfiltered chat, but are still subject to spam and link moderation
\n– **Private message protection:** If an adult sends a private message with blocked words to an underage player, the message is filtered for the underage recipient and the adult is warned\/escalated
\n– **Mute and shadow mute are separate:** If a player is muted, they cannot chat at all. If shadow muted, their messages are only visible to themselves.
\n– Age-based chat filtering (blocked words, links, and server IPs)
\n– Configurable blocked words list
\n– Permission-based link bypass
\n– Private message filtering (with same filtering as public chat)
\n– Automatic age prompt and movement lock on first join
\n– Configurable replacement characters and warning messages
\n– **Spam protection** with separate escalation (warn \u2192 mute \u2192 kick)
\n– **Mute, unmute, and timed mute commands** (with short aliases)
\n– **Persistent warning system** (general and spam warnings saved across restarts)
\n– **Escalation system**: warn \u2192 mute \u2192 kick \u2192 ban for severe offenses (underage only, except for private messages to underage)
\n– **Separate escalation for spam**
\n– **Admin commands to reset warnings and spam warnings**
\n– **View warnings for any player**
\n– Enhanced logging system<\/p>\n
## Requirements<\/p>\n
– Minecraft Spigot\/Paper 1.21.X<\/p>\n
## Installation<\/p>\n
1. Download the latest version of the plugin jar file
\n2. Place the jar file in your server’s `plugins` folder
\n3. Restart your server<\/p>\n
## Configuration Files<\/p>\n
– **config.yml**: All settings, thresholds, durations, and permissions
\n– **blockedwords.yml**: The list of blocked words
\n– **messages.yml**: All user-facing messages (customizable)
\n– **players.yml**: Stores player ages, warnings, and spam warnings<\/p>\n
## Main Commands<\/p>\n
– `\/age > **Tip for staff:** All moderation commands have short aliases (e.g., `\/mute`, `\/unmute`, `\/resetwarnings`, `\/resetspamwarnings`, and their `\/ff…` versions) for quick access.<\/p>\n ## How It Works<\/p>\n – **First join**: Players must set their age before chatting or moving. ## Permissions<\/p>\n All permissions are managed via LuckPerms (or your permissions plugin of choice). Assign as needed:<\/p>\n – `familyfriendly.age`: Allows players to set their age ## Example LuckPerms Usage<\/p>\n “` ## Troubleshooting<\/p>\n – If players can’t set their age: Ensure the plugin has write permissions in the plugins folder ## Logging<\/p>\n – All chat and private messages are logged to the server console ## License<\/p>\n All Rights Reserved<\/p>\n —<\/p>\n","protected":false},"excerpt":{"rendered":" A Minecraft plugin that ensures a safe and age-appropriate chat experience by filtering inappropriate words for underage players.<\/p>\n","protected":false},"featured_media":68498,"template":"","meta":{"_minecraft_slug":"familyfriendly","_minecraft_project_id":"GSGMNMcW","_minecraft_author":"WILD_DRS","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":132,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"familyfriendly.zip","_minecraft_size_bytes":56756,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T18:58:05.759841Z","_minecraft_date_created":"2025-06-18T11:16:43.485467Z","_minecraft_date_modified":"2025-07-15T12:38:57.387228Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/familyfriendly","_minecraft_icon_attachment_id":68498,"_minecraft_imported_at":"2026-06-03T21:49:32+00:00","_minecraft_import_hash":"359c0e7f0643f61cf122699e795eb9f4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,73,74,38,78,79,80],"class_list":["post-68497","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7"],"yoast_head":"\n
\n– `\/mute
\n– `\/unmute
\n– `\/resetwarnings
\n– `\/resetspamwarnings
\n– `\/familyfriendly reload` or `\/ff reload` \u2014 Reload plugin configuration
\n– `\/familyfriendly viewwarn
\n– **Chat filtering**: Underage players have messages filtered for blocked words and links. Adults see and send unfiltered chat, but are still subject to spam and link moderation.
\n– **Private message protection:** If an adult sends a private message with blocked words to an underage player, the message is filtered for the underage recipient and the adult is warned\/escalated.
\n– **Mute and shadow mute:**
\n – If a player is muted, they cannot chat at all and see a mute message.
\n – If a player is shadow muted, their messages are only visible to themselves (they are not notified).
\n – The two effects never overlap or conflict; mute always takes precedence.
\n– **Spam protection**: Repeated messages trigger a separate warning\/mute\/kick system (never bans for spam).
\n– **Escalation**: General offenses (cursing, links) escalate from warning to mute, kick, and finally ban (all configurable, underage only, except for private messages to underage).
\n– **Warnings**: All warnings are saved and persist across restarts. Admins can reset or view warnings for any player.<\/p>\n
\n– `familyfriendly.reload`: Allows reloading the plugin configuration
\n– `familyfriendly.link`: Allows players to share links and server IPs
\n– `familyfriendly.op`: Bypass all FamilyFriendly restrictions
\n– `familyfriendly.mute`: Allows moderators to mute players
\n– `familyfriendly.unmute`: Allows unmuting players
\n– `familyfriendly.resetwarnings`: Allows resetting general warnings
\n– `familyfriendly.resetspamwarnings`: Allows resetting spam warnings
\n– `familyfriendly.viewwarns`: Allows viewing warning counts<\/p>\n
\nlp user
\nlp group staff permission set familyfriendly.viewwarns true
\n“`<\/p>\n
\n– If chat filtering isn’t working: Check config.yml and blockedwords.yml
\n– If private messages aren’t being filtered: Check if players have set their age
\n– If configuration changes aren’t applying: Use `\/familyfriendly reload` to reload the settings<\/p>\n
\n– Blocked and filtered messages are logged with warnings<\/p>\n