# ScamScreener<\/p>\n
ScamScreener is a client-side Fabric mod that analyzes incoming chat, highlights scam-like behavior patterns, and gives you a structured review workflow for safer decisions.<\/p>\n
## At A Glance<\/p>\n
– Realtime chat risk analysis with a multi-stage detection pipeline
\n– In-game review queue with case-level message tagging
\n– Whitelist and blacklist tools with command + GUI support
\n– Optional auto `\/p leave` on blacklist alerts
\n– Canonical training export (`training-cases-v2.jsonl`) for later tuning
\n– Public API entrypoint for integrations (`scamscreener-api`)<\/p>\n
## Supported Versions And Requirements<\/p>\n
– Minecraft: `1.21.10` (EOL), `1.21.11` (EOL), `26.1`
\n– Mod loader: Fabric Loader `>= 0.17`
\n– Dependency: Fabric API
\n– Environment: client-only<\/p>\n
## Installation<\/p>\n
1. Install Fabric Loader for your Minecraft version.
\n2. Put `ScamScreener` and `Fabric API` into your `mods` folder.
\n3. Launch the game.
\n4. Open settings with `\/scamscreener settings` (or `\/ss settings`).<\/p>\n
## Quick Start<\/p>\n
1. Set your risk threshold (`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`). Note that `LOW` might warn you way often when on large public islands!
\n2. Play as usual and let ScamScreener monitor inbound chat.
\n3. Open review queue (`\/scamscreener review`) for flagged cases.
\n4. Mark cases as `RISK`, `SAFE`, or `DISMISSED`.
\n5. Export reviewed data with `\/scamscreener review export` if needed.<\/p>\n
## How Detection Works<\/p>\n
ScamScreener evaluates each inbound message through a staged pipeline:<\/p>\n
– Player list stage (whitelist\/blacklist hard matches)
\n– Deterministic rule stage (links, urgency, platform redirects, payment\/account signals)
\n– Similarity stage (fuzzy phrase matching)
\n– Behavior stage (sender-local repetition\/burst patterns)
\n– Trend stage (cross-sender wave detection)
\n– Funnel stage (multi-step trust -> redirect -> payment\/account patterns)
\n– Context stage (signal blend across recent same-sender messages)
\n– Mute stage \/ bypass logic<\/p>\n
Pipeline outcomes can include `IGNORE`, `REVIEW`, `BLOCK`, `WHITELISTED`, `BLACKLISTED`, or `MUTED`.<\/p>\n
## In-Game Commands<\/p>\n
Root commands:<\/p>\n
– `\/scamscreener …`
\n– `\/ss …` (alias)<\/p>\n
Main command groups:<\/p>\n
– `settings`, `rules`, `runtime`, `messages`, `metrics` ## GUI Overview<\/p>\n Main settings screen includes:<\/p>\n – Alert threshold and auto-capture settings ## Case Review And Training Export<\/p>\n Review flow:<\/p>\n 1. Open queue and pick a case. Export:<\/p>\n – Command: `\/scamscreener review export` Important status:<\/p>\n – Training Hub is currently not live. ## Configuration Files<\/p>\n ScamScreener stores its data in `config\/scamscreener\/`:<\/p>\n – `runtime.json` (runtime and output behavior) ## Privacy And Data Handling<\/p>\n – ScamScreener runs client-side. ## v1 To v2 Migration<\/p>\n On first start of v2, ScamScreener performs a one-time migration:<\/p>\n – Migrates legacy whitelist\/blacklist files into v2 config files Existing v2 target files are never overwritten.<\/p>\n ## API For Other Mods<\/p>\n Get the API through the Fabric entrypoint:<\/p>\n “`java import java.util.List;<\/p>\n List if (!apis.isEmpty()) { Then use shared list access and events:<\/p>\n “`java WhitelistAccess whitelist = api.whitelist(); PipelineDecisionEvent.EVENT.register((chatEvent, decision) -> { WhitelistEvent.EVENT.register((changeType, entry) -> { BlacklistEvent.EVENT.register((changeType, entry) -> { Monitors the chat and warns you about potentonal scammers<\/p>\n","protected":false},"featured_media":135970,"template":"","meta":{"_minecraft_slug":"scamscreener","_minecraft_project_id":"XTB0bgAW","_minecraft_author":"Pankraz01","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":251142,"_minecraft_follows":3,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"scamscreener.zip","_minecraft_size_bytes":53536175,"_minecraft_version_count":118,"_minecraft_updated_at":"2026-05-16T15:56:54.060669Z","_minecraft_date_created":"2026-02-09T05:50:43.325087Z","_minecraft_date_modified":"2026-05-14T16:49:39.242943Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/scamscreener","_minecraft_icon_attachment_id":135970,"_minecraft_imported_at":"2026-06-08T00:44:22+00:00","_minecraft_import_hash":"64da9308e89c8edd714c7edef375ce66","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,867,92],"mod_loader":[99],"minecraft_version":[40,41,82,83,167,163],"class_list":["post-135969","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_category-social","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `whitelist add\/remove\/clear`
\n– `blacklist add\/remove\/clear`
\n– `review`, `review player`, `review manage`, `review info`, `review export`
\n– `alertlevel`
\n– `autoleave on\/off`
\n– `mute`, `mute
\n– `debug`
\n– `version`, `help`<\/p>\n
\n– Auto-leave and mute filter toggles
\n– Whitelist \/ blacklist management
\n– Review queue and review settings
\n– Rules, runtime, metrics, and message settings<\/p>\n
\n2. Tag each message as `Exclude`, `Context`, or `Signal`.
\n3. Save verdict as `Risk`, `Safe`, or `Dismiss`.<\/p>\n
\n– Output file: `config\/scamscreener\/training-cases-v2.jsonl`<\/p>\n
\n– `Contribute Training Data` buttons are intentionally disabled in GUI for now.
\n– Local export is still available and stable.<\/p>\n
\n– `rules.json` (pipeline rule configuration)
\n– `review.json` (review queue state)
\n– `whitelist.json` (trusted players)
\n– `blacklist.json` (blocked players)
\n– `training-cases-v2.jsonl` (manual export artifact)<\/p>\n
\n– No automatic training upload is performed by the mod.
\n– Review\/training payloads are sanitized and do not persist sender UUID identity.
\n– UUID-based persistence is intentionally limited to whitelist\/blacklist management.<\/p>\n
\n– Writes migration marker `.v1-to-v2-migration.done`
\n– Cleans up legacy v1 config folder artifacts after migration<\/p>\n
\nimport eu.tango.scamscreener.api.ScamScreenerApi;
\nimport net.fabricmc.loader.api.FabricLoader;<\/p>\n
\n .getEntrypoints(ScamScreenerApi.ENTRYPOINT_KEY, ScamScreenerApi.class);<\/p>\n
\n ScamScreenerApi api = apis.get(0);
\n}
\n“`<\/p>\n
\nimport eu.tango.scamscreener.api.BlacklistAccess;
\nimport eu.tango.scamscreener.api.WhitelistAccess;
\nimport eu.tango.scamscreener.api.event.BlacklistEvent;
\nimport eu.tango.scamscreener.api.event.PipelineDecisionEvent;
\nimport eu.tango.scamscreener.api.event.WhitelistEvent;<\/p>\n
\nBlacklistAccess blacklist = api.blacklist();<\/p>\n
\n \/\/ react to pipeline decisions
\n});<\/p>\n
\n \/\/ entry is null when the list is cleared
\n});<\/p>\n
\n \/\/ entry is null when the list is cleared
\n});
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"