# VillagerRepellent
\nA lightweight plugin that lets you repel villagers from using specific beds and workstations \u2014 works by logging blocks to a list of banned coordinates for villager use. Perfect for keeping villagers out of personal homes, or using workstation blocks as decoration. (No more fishermen in your barrel room!)<\/p>\n
## Features
\n– Repel villagers from any blocks at specified coordinates
\n– Works for beds, workstations, bells
\n– Commands to both blacklist and whitelist blocks
\n– 100% vanilla-friendly
\n– Supports Paper 1.21.x
\n– Extremely lightweight<\/p>\n
## How It Works<\/p>\n
### \u274c Repellent Mode (\/villagerrepel, \/vr)
\nWhen you repel a block:
\n– The block\u2019s position that you are targetting is added to a banned list
\n– Every 10 seconds, the plugin checks all villagers’ memories for that block position
\n – If their HOME or JOB_SITE matches a banned block, their memory is nulled
\n– Villagers immediately ignore that block and seek a new one<\/p>\n
### \u2714\ufe0f Allow Mode (\/villagerallow, \/va)
\nWhen you allow a block:
\n– The block you are targetting is removed from the banned list
\n– The plugin replaces the block with itself, triggering a vanilla POI refresh
\n (same effect as breaking and placing the block)
\n– Villagers reconsider it during the next work cycle<\/p>\n
## Installation
\n1. Download the latest release JAR
\n2. Place it in your Paper server\u2019s `plugins\/` folder
\n3. Restart the server <\/p>\n
Supports Paper 1.21.x. <\/p>\n
## Permissions
\n– villagerrepellent.repel:
\n – description: Allows repelling villagers from POI blocks.
\n – default: op
\n– villagerrepellent.allow:
\n – description: Allows allowing villagers to use POI blocks again.
\n – default: op<\/p>\n
## Compatibilities\/Conflicts
\nI’m relatively new to this, so feel free to let me know if this plugin conflicts with any popular plugins and I’ll look to correct it!<\/p>\n
## Config
\n`config.yml`:
\n“`yaml
\nbanned-positions: []<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight plugin that lets you repel villagers from using specific beds and workstations.<\/p>\n","protected":false},"featured_media":166405,"template":"","meta":{"_minecraft_slug":"villager-repellent","_minecraft_project_id":"ZtA3NbQH","_minecraft_author":"ropher","_minecraft_license":"MIT","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"villager-repellent.zip","_minecraft_size_bytes":9806,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:50:39.941843Z","_minecraft_date_created":"2025-12-14T01:26:48.997123Z","_minecraft_date_modified":"2025-12-09T20:32:56.345933Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/villager-repellent","_minecraft_icon_attachment_id":166405,"_minecraft_imported_at":"2026-06-09T18:22:16+00:00","_minecraft_import_hash":"711d9c7fc69bd401b2a114b94ad4eb95","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,137,127,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-166404","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n