\n
\n
\n
\n<\/p>\n
> A revolutionary villager control plugin that lets you claim, manage, and control villagers using a simple stick!<\/p>\n
## \ud83c\udf1f Features<\/p>\n
### Core Features
\n– \ud83c\udfd8\ufe0f **Stick-Based Interaction** – Right-click villagers with a STICK (no more mumbling!)
\n– \ud83c\udfaf **Villager Claiming** – Claim villagers with custom names and full control
\n– \ud83d\udeb6 **Follow System** – Make villagers follow you around the world
\n– \ud83e\uddca **Freeze System** – Freeze villagers in place when needed
\n– \ud83d\udd12 **Permission-Based Limits** – Control how many villagers players can claim (8, 16, 32, 64, or unlimited)
\n– \ud83d\udcbe **Smart Persistence** – All villager states persist across server restarts
\n– \ud83c\udfa8 **Visual Effects** – Particle effects and smooth animations
\n– \u26a1 **Performance Optimized** – Efficient tracking with smart cleanup systems<\/p>\n
### Advanced Features
\n– **Freeze-on-Look** – Villagers freeze when you look at them (configurable duration)
\n– **Cross-World Support** – Bring villagers between worlds (configurable)
\n– **Inventory System** – Access and manage villager inventories with full item storage
\n– **Auto-Despawn Protection** – Villagers despawn when too far away (performance)
\n– **Manual Despawn System** – Use `\/vc away` to make villagers disappear manually
\n– **Bring Back System** – Use `\/vc bring` to restore despawned villagers
\n– **Inventory Protection** – Villagers with items become invulnerable and can’t be unclaimed
\n– **Smart Despawn** – Villagers auto-despawn when you fly too fast with elytra
\n– **Teleportation Limits** – Prevent abuse with cooldowns and limits
\n– **World Restrictions** – Control which worlds villagers can be brought to
\n– **Command Cooldowns** – Prevent spam with configurable cooldowns
\n– **Debug System** – Comprehensive logging for troubleshooting<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
### Prerequisites
\n– Paper or Spigot server running Minecraft 1.21+
\n– Java 17 or higher installed on your server<\/p>\n
### Steps
\n1. **Download** the latest `VillagerClaim-1.0.0.jar` file
\n2. **Stop** your Minecraft server
\n3. **Place** the JAR file in your server’s `plugins` folder
\n4. **Start** your server
\n5. The plugin will create a `VillagerClaim` folder with default configuration
\n6. **Configure** the plugin by editing `plugins\/VillagerClaim\/config.yml`
\n7. **Reload** the plugin with `\/vc reload` or restart the server<\/p>\n
### Verification
\nAfter installation, verify the plugin is working:
\n“`
\n> plugins
\n[10:00:00 INFO]: Plugins (1): VillagerClaim
\n“`<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin generates a `config.yml` file in `plugins\/VillagerClaim\/` with extensive customization options.<\/p>\n
### Basic Configuration<\/p>\n
#### General Settings
\n“`yaml
\ngeneral:
\n # Maximum distance to interact with villagers
\n max-interaction-distance: 5.0<\/p>\n
# Time in seconds to freeze villager when looking at it
\n # Set to -1 for infinite duration (until player looks away)
\n freeze-on-look-duration: 3<\/p>\n
# Interaction tool – players must hold a STICK
\n interaction-tool: STICK
\n“`<\/p>\n
#### World Restrictions
\n“`yaml
\nworlds:
\n # Allow bringing villagers to specific worlds
\n allow-worlds:
\n world: true # Overworld (default world)
\n world_nether: false # Nether
\n world_the_end: false # End<\/p>\n
# Cross-world villager management
\n cross-world-teleport: true
\n“`<\/p>\n
#### Message Customization
\nAll messages support Minecraft color codes (`&` format):
\n“`yaml
\nmessages:
\n # Claim messages
\n villager-claimed: “&a&l\u2713 &aYou have claimed &e{villager_name} &aas your villager!”
\n villager-already-claimed: “&c&l\u2717 &cThis villager is already claimed by &e{owner_name}&c!”<\/p>\n
# Command messages
\n villager-following: “&a&l\u2713 &a{villager_name} &ais now following you!”
\n villager-frozen: “&b&l\u2713 &b{villager_name} &bis now frozen in place!”
\n villager-unclaimed: “&c&l\u2713 &c{villager_name} &chas been unclaimed!”
\n“`<\/p>\n
#### Feature Toggles
\n“`yaml
\nfeatures:
\n # Enable villager freezing when looking at them
\n freeze-on-look: true<\/p>\n
# Enable villager following mechanics
\n follow-mechanics: true<\/p>\n
# Enable villager freezing mechanics
\n freeze-mechanics: true<\/p>\n
# Enable command cooldowns (in seconds)
\n command-cooldown: 2<\/p>\n
# Enable villager inventory system
\n villager-inventory: true
\n“`<\/p>\n
#### Advanced Settings
\n“`yaml
\nadvanced:
\n # Auto-save villager data (in minutes)
\n auto-save-interval: 5<\/p>\n
# Maximum villager name length
\n max-name-length: 20<\/p>\n
# Teleportation limits
\n max-teleports-per-minute: 3
\n teleport-cooldown-seconds: 5<\/p>\n
# Despawn settings
\n max-follow-distance: 50
\n despawn-distance: 100
\n“`<\/p>\n
### Configuration Examples<\/p>\n
**Example 1: Basic Setup (Default)**
\n“`yaml
\ngeneral:
\n freeze-on-look-duration: 3
\n max-interaction-distance: 5.0<\/p>\n
features:
\n freeze-on-look: true
\n follow-mechanics: true
\n freeze-mechanics: true
\n“`<\/p>\n
**Example 2: Infinite Freeze on Look**
\n“`yaml
\ngeneral:
\n freeze-on-look-duration: -1 # Infinite until look away
\n“`<\/p>\n
**Example 3: No Freeze on Look**
\n“`yaml
\ngeneral:
\n freeze-on-look-duration: 0 # Disabled
\nfeatures:
\n freeze-on-look: false
\n“`<\/p>\n
**Example 4: Cross-World Disabled**
\n“`yaml
\nworlds:
\n cross-world-teleport: false
\n allow-worlds:
\n world: true
\n world_nether: false
\n world_the_end: false
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
All commands use the `\/vc` prefix (alias for `\/villagerclaim`).<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Permission | ### Admin Commands<\/p>\n | Command | Description | Permission | ### Command Details<\/p>\n #### `\/vc list` #### `\/vc follow #### `\/vc freeze #### `\/vc unclaim #### `\/vc despawned` #### `\/vc bring #### `\/vc away #### `\/vc inventory #### `\/vc worlds` —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | ### Permission Examples<\/p>\n **Give a player 16 villager limit:** **Give unlimited villagers to a VIP:** **Group permissions (in your permissions plugin):** —<\/p>\n ## \ud83d\udcd6 Usage Guide<\/p>\n ### For Players<\/p>\n #### Getting Started #### Basic Interactions #### Advanced Features ### For Admins<\/p>\n #### Monitoring Players #### Managing Limits #### Configuration Changes —<\/p>\n ## \ud83d\udcbe Data Storage<\/p>\n ### Files Created ### Villager Data Structure ### Data Persistence —<\/p>\n ## \ud83d\udd27 Troubleshooting<\/p>\n ### Common Issues<\/p>\n #### Issue: Can’t interact with villagers #### Issue: Villagers not following #### Issue: Commands not working #### Issue: Villagers disappearing #### Issue: Cross-world not working #### Issue: Villager disappeared (despawned) #### Issue: Can’t unclaim villager #### Issue: Villager inventory not saving ### Getting Help<\/p>\n If you need additional support: —<\/p>\n ## \ud83d\udcca Performance<\/p>\n ### Resource Usage A revolutionary villager control plugin that lets you claim, manage, and control villagers using a simple stick!<\/p>\n","protected":false},"featured_media":166313,"template":"","meta":{"_minecraft_slug":"villager-claim","_minecraft_project_id":"z0h5R8CP","_minecraft_author":"Yenith","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":94,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"villager-claim.zip","_minecraft_size_bytes":49668,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:49:49.403071Z","_minecraft_date_created":"2025-10-09T04:56:59.072039Z","_minecraft_date_modified":"2025-10-08T00:24:20.261941Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/villager-claim","_minecraft_icon_attachment_id":166313,"_minecraft_imported_at":"2026-06-09T18:19:06+00:00","_minecraft_import_hash":"f52b08ceb5447528b5c31d2bd54a62f5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,91,92],"mod_loader":[132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-166312","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-storage","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","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
\n|———|————-|————|
\n| `\/vc list` | Lists all your claimed villagers | `villagerclaim.use` |
\n| `\/vc despawned` | Lists your despawned villagers | `villagerclaim.use` |
\n| `\/vc follow
\n| `\/vc unfollow
\n| `\/vc freeze
\n| `\/vc unfreeze
\n| `\/vc unclaim
\n| `\/vc bring
\n| `\/vc away
\n| `\/vc inventory
\n| `\/vc inv
\n| `\/vc worlds` | Show allowed worlds for villagers | `villagerclaim.use` |<\/p>\n
\n|———|————-|————|
\n| `\/vc reload` | Reloads the configuration | `villagerclaim.admin` |
\n| `\/vc check
\n| `\/vc reset
\nShows all your claimed villagers with their status:
\n“`
\nYour Villagers:
\n– Steve (Following)
\n– Bob (Frozen)
\n– Alice (Idle)
\n“`<\/p>\n
\nMakes a villager follow you around:
\n“`
\n\u2713 Steve is now following you!
\n“`<\/p>\n
\nFreezes a villager in place:
\n“`
\n\u2713 Steve is now frozen in place!
\n“`<\/p>\n
\nReleases a villager (they become normal villagers):
\n“`
\n\u2713 Steve has been unclaimed!
\n“`<\/p>\n
\nShows all your despawned villagers:
\n“`
\nYour Despawned Villagers:
\n– Steve (Despawned)
\n– Bob (Despawned)
\n“`<\/p>\n
\nBrings back a despawned villager:
\n“`
\n\u2713 Steve has been brought back!
\n“`<\/p>\n
\nMakes a villager disappear (manual despawn):
\n“`
\n\u2713 Steve has been sent away!
\n“`<\/p>\n
\nOpens a villager’s inventory:
\n“`
\n\u2713 Opened Steve’s inventory!
\n“`<\/p>\n
\nShows allowed worlds for villagers:
\n“`
\nAllowed Worlds:
\n– world (Overworld)
\n– world_nether (Nether) – Disabled
\n– world_the_end (End) – Disabled
\n“`<\/p>\n
\n|————|————-|———|
\n| `villagerclaim.use` | Use basic villager commands | `true` (everyone) |
\n| `villagerclaim.admin` | Access admin commands | `op` (operators only) |
\n| `villagerclaim.limit.8` | Claim up to 8 villagers | `true` (default) |
\n| `villagerclaim.limit.16` | Claim up to 16 villagers | `false` |
\n| `villagerclaim.limit.32` | Claim up to 32 villagers | `false` |
\n| `villagerclaim.limit.64` | Claim up to 64 villagers | `false` |
\n| `villagerclaim.limit.unlimited` | Claim unlimited villagers | `false` |<\/p>\n
\n“`yaml
\n# Using LuckPerms
\n\/lp user Player permission set villagerclaim.limit.16 true
\n“`<\/p>\n
\n“`yaml
\n# Using LuckPerms
\n\/lp user VIP permission set villagerclaim.limit.unlimited true
\n“`<\/p>\n
\n“`yaml
\ngroups:
\n default:
\n permissions:
\n – villagerclaim.use
\n – villagerclaim.limit.8
\n vip:
\n permissions:
\n – villagerclaim.limit.32
\n admin:
\n permissions:
\n – villagerclaim.admin
\n – villagerclaim.limit.unlimited
\n“`<\/p>\n
\n1. **Hold a STICK** in your hand
\n2. **Right-click a villager** with the stick
\n3. **Type a name** when prompted
\n4. **Use commands** to control your villagers<\/p>\n
\n– **Claim a villager:** Right-click with stick \u2192 Enter name
\n– **Make follow:** `\/vc follow
\n– **Freeze in place:** `\/vc freeze
\n– **Release villager:** `\/vc unclaim
\n– **Freeze on look:** Look at your villager to freeze them
\n– **Cross-world travel:** Bring villagers to different worlds
\n– **Inventory access:** Right-click to open villager inventory or use `\/vc inventory
\n– **Auto-despawn protection:** Villagers despawn when too far away
\n– **Manual despawn:** Use `\/vc away
\n– **Bring back system:** Use `\/vc bring
\n– **Inventory protection:** Villagers with items become invulnerable
\n– **Smart despawn:** Villagers auto-despawn when you fly too fast with elytra<\/p>\n
\nCheck any player’s villagers:
\n“`
\n\/vc check PlayerName
\n“`<\/p>\n
\nSet villager limits using permissions:
\n“`
\n\/lp user Player permission set villagerclaim.limit.32 true
\n“`<\/p>\n
\n1. Edit `plugins\/VillagerClaim\/config.yml`
\n2. Run `\/vc reload`
\n3. Changes apply immediately<\/p>\n
\n“`
\nplugins\/
\n\u2514\u2500\u2500 VillagerClaim\/
\n \u251c\u2500\u2500 config.yml # Plugin configuration
\n \u251c\u2500\u2500 villagerdata.yml # Villager claim data
\n \u2514\u2500\u2500 bypass.yml # Bypass player data
\n“`<\/p>\n
\nThe `villagerdata.yml` file stores:
\n– Villager UUID and name
\n– Owner UUID and name
\n– Current status (following\/frozen\/idle)
\n– Location data
\n– Inventory contents
\n– World information<\/p>\n
\nVillager data is automatically saved:
\n– When a player disconnects
\n– Every 5 minutes (configurable)
\n– When the server stops
\n– When villager status changes<\/p>\n
\n**Solutions:**
\n1. Make sure you’re holding a STICK
\n2. Check you’re within interaction distance (5 blocks)
\n3. Verify villager isn’t already claimed by someone else
\n4. Check permissions: `\/vc list`<\/p>\n
\n**Solutions:**
\n1. Check villager is claimed by you: `\/vc list`
\n2. Verify follow command: `\/vc follow
\n3. Check if villager is frozen: `\/vc unfreeze
\n4. Ensure you’re not too far away (50 block limit)<\/p>\n
\n**Solutions:**
\n1. Verify permissions are set correctly
\n2. Check console for errors
\n3. Ensure you’re using correct command format
\n4. Try using the full command: `\/villagerclaim` instead of `\/vc`<\/p>\n
\n**Solutions:**
\n1. Check despawn distance settings
\n2. Verify world restrictions
\n3. Check if villager died (they can take damage)
\n4. Look for console errors<\/p>\n
\n**Solutions:**
\n1. Check `cross-world-teleport: true` in config
\n2. Verify world is in `allow-worlds` list
\n3. Check player permissions
\n4. Ensure villager is following you<\/p>\n
\n**Solutions:**
\n1. Check if villager is despawned: `\/vc despawned`
\n2. Bring back with: `\/vc bring
\n3. Check if you flew too fast with elytra
\n4. Verify villager wasn’t killed by mobs<\/p>\n
\n**Solutions:**
\n1. Check if villager has items: `\/vc inventory
\n2. Empty villager inventory first
\n3. Villagers with items are protected from unclaiming
\n4. Use `\/vc away
\n**Solutions:**
\n1. Check if villager is claimed by you
\n2. Ensure you’re the owner of the villager
\n3. Try closing and reopening inventory
\n4. Check console for errors<\/p>\n
\n1. Check console logs for error messages
\n2. Verify your configuration is valid YAML syntax
\n3. Join our Discord server: https:\/\/discord.gg\/cybycQ9wGp<\/p>\n
\n– **Memory:** Minimal (<10MB for typical server)\n- **CPU:** Very light (efficient tracking system)\n- **Disk:** Small data files (YAML format)\n- **Network:** No network operations\n\n### Optimization Tips\n1. Adjust `auto-save-interval` based on villager count\n2. Set appropriate `despawn-distance`\n3. Use `max-follow-distance` to reduce unnecessary checks\n4. Consider world restrictions for performance\n\n### Tested Performance\n- \u2705 Works efficiently with 100+ claimed villagers\n- \u2705 No noticeable TPS impact\n- \u2705 Fast data saving (<100ms)\n- \u2705 Minimal memory footprint\n\n---\n\n## \ud83d\ude80 Roadmap\n\nPotential features for future versions:\n- [ ] Villager trading integration\n- [ ] Villager profession management\n- [ ] Villager breeding system\n- [ ] GUI for villager management\n- [ ] Villager groups and teams\n- [ ] Advanced villager AI\n- [ ] Villager marketplace\n- [ ] Villager statistics tracking\n- [ ] Enhanced inventory management\n- [ ] Villager job assignments\n- [ ] Automated villager tasks\n\n---\n\n## \ud83e\udd1d Support\n\n### Bug Reports\nIf you find a bug, please report it with:\n- Plugin version\n- Server software and version\n- Steps to reproduce\n- Console errors (if any)\n\n### Feature Requests\nHave an idea? Share it with details about:\n- What you want to achieve\n- How it would benefit users\n- Example use cases\n\n### Discord Community\nJoin our Discord server for support, updates, and community discussion:\n**https:\/\/discord.gg\/cybycQ9wGp**\n\n---\n\n## \ud83d\udcdc License\n\nThis plugin is free to use and modify for your server.\n\n### Terms\n- \u2705 Licensed for use on any server\n- \u274c Modification for personal purposes is prohibited\n- \u274c Redistribution, even with credit, is prohibited\n- \u274c Commercial resale is prohibited\n- \u274c No warranty or guarantee is provided\n\n---\n\n## \ud83d\udc68\u200d\ud83d\udcbb Author\n\n**Yenith**\n\n---\n\n## \u2b50 Thank You!\n\nThank you for using VillagerClaim! If you enjoy this plugin:\n- Share it with other server owners\n- Leave feedback and suggestions\n- Report bugs to help improve it\n- Consider supporting future development\n- Join our Discord community: https:\/\/discord.gg\/cybycQ9wGp\n\n---\n\n**Made with \u2764\ufe0f for the Minecraft community**\n\n*Last Updated: 08 October 2025*\n<\/p>\n","protected":false},"excerpt":{"rendered":"