VilPickupV Complete Plugin Information

Overview

VilPickupV is a powerful Minecraft plugin that revolutionizes villager management. Transform how you interact with villagers by picking them up with a simple shift plus right click and placing them anywhere with beautiful custom head items that preserve all their data.

Key Features

Core Functionality

• Smart Pickup System: Shift plus right click any villager to instantly convert them into a portable item
• Perfect Data Preservation: Maintains trades, profession, level, experience, and all villager properties
• Custom Head Items: Each villager becomes a beautiful player head with profession specific textures
• Seamless Placement: Right click the head item to spawn the villager exactly where you want

Visual Features

• Profession Specific Heads: Each profession gets its own unique texture, including Librarian, Farmer, Blacksmith, and more
• Baby Villager Support: Special smaller head textures for baby villagers
• Zombie Villager Compatibility: Distinct zombie villager textures, including baby zombies
• Equipment Preservation: Zombie villager armor and weapons are fully preserved
• Descriptive Names: Items show clear names like "Librarian", "Baby Farmer", and "Zombie Villager"

Advanced Configuration

• Flexible Materials: Use player heads or any item material
• Custom Sounds: Configurable pickup and placement sound effects
• Distance Controls: Set maximum pickup distances
• Permission System: Fine grained control over who can use features
• Debug Logging: Comprehensive logging for troubleshooting

Database Support

• MySQL Integration: Optional database storage for villager data
• HikariCP Connection Pool: Professional grade database connections
• Data Analytics: Track villager pickups and placements
• Backup and Recovery: Never lose important villager data

Supported Entities

• Regular Villagers, all professions
• Baby Villagers
• Zombie Villagers
• Baby Zombie Villagers
• Wandering Traders

Commands

/vilpickup reload

Reload configuration files. Admin only.

Permissions

• vilpickup.use Default: true Allows picking up villagers

• vilpickup.admin Default: op Allows admin commands

Configuration

config.yml

trade-preview:
  enabled: true

villager-naming:
  enabled: true

settings:
  require-shift: true
  require-sneak: false
  require-permission: false
  permission-node: "vilpickup.use"
  allowed-entities:
    - VILLAGER
    - WANDERING_TRADER
    - ZOMBIE_VILLAGER
  pickup-sound: true
  sound-type: "ENTITY_ITEM_PICKUP"
  sound-volume: 1.0
  sound-pitch: 1.0

restrictions:
  max-pickup-distance: 5.0
  cooldown-seconds: 0
  prevent-pickup-in-combat: false
  combat-time-seconds: 10

item:
  material: "PLAYER_HEAD"
  name: "&7[Villager] &f{name}"
  lore:
    - "&7Type: &e{profession}"
    - "&7Level: &a{level}"
    - "&7Right-click to place"
    - ""
    - "&8Stored with VilPickup"
  glow: true

placement:
  require-shift-place: false
  prevent-place-in-claimed: false
  place-sound: true
  place-sound-type: "ENTITY_VILLAGER_AMBIENT"

database:
  enabled: false
  host: "localhost"
  port: 3306
  database: "vilpickup"
  username: "root"
  password: "password"
  connection-timeout: 30000
  idle-timeout: 600000
  max-lifetime: 1800000
  maximum-pool-size: 10
  minimum-idle: 5

debug:
  enabled: false
  log-pickups: false
  log-placements: false

Compatibility

• Minecraft Versions: 1.21+
• Server Software: Paper recommended, Spigot, Bukkit
• Java Version: 21+
• Dependencies: None required
• Jar Size: 335 KB

Use Cases

• Server Administration: Easily relocate villagers for builds
• Trading Halls: Perfect villager positioning and organization
• Adventure Maps: Portable NPCs for custom experiences
• Multiplayer Servers: Fair villager distribution among players
• Creative Building: Precise villager placement in structures

Support and Development

• Active development and maintenance
• Regular updates for new Minecraft versions
• Community driven feature requests
• Comprehensive error logging and debugging tools

VilPickupV transforms villager management from a chore into an enjoyable, efficient experience. Whether you're building the perfect trading hall or need precise villager placement for your builds, this plugin delivers professional grade functionality with an intuitive interface.