mLeadVillager

Allows players to leash villagers with leads, just like animals.

!example

Features

• Leash villagers with leads - Treat villagers like animals and lead them around
• Tie them to fences - Secure your villagers by tying them to fence posts
• Configurable restrictions - Control which villagers can be leashed (babies, nitwits, unemployed)
• Custom messages - Fully customizable messages in your language
• Reload command - Hot-reload configuration without server restart
• Creative mode protection - Optional restriction to prevent leashing in creative mode
• Distance checking - Configurable maximum distance for leashing
• Sneaking requirement - Optional requirement to sneak while leashing

Permissions

Permission	Description	Default
mleadvillager.leash	Allows leashing villagers	true
mleadvillager.reload	Allows reloading configuration	op

Commands

Command	Description	Usage
/mlead reload	Reloads the plugin configuration	/mlead reload

Building

mvn clean package

The compiled JAR will be in target/mLeadVillager-1.0.0.jar.

Configuration

# mLeadVillager Configuration

# Allow leashing nitwit villagers
allow-leashing-nitwits: true

# Allow leashing baby villagers
allow-leashing-babies: true

# Allow leaching unemployed villagers
allow-leashing-unemployed: true

# Allow leashing in creative mode
allow-leashing-in-creative: false

Maximum distance to leash villager (in blocks)

max-leash-distance: 5.0

Require sneaking to leash villager

require-sneaking-to-leash: false

Plugin messages

messages: leash-success: "&aВы привязали жителя на поводок!" unleash-success: "&eПоводок с жителя снят." no-permission: "&cУ вас нет права." only-players: "&cТолько игроки могут это делать." reloaded: "&aКонфигурация перезагружена." not-in-creative: "&cНельзя привязывать жителей в креативном режиме." too-far: "&cСлишком далеко от жителя. Подойдите ближе." leash-failed: "&cНе удалось привязать жителя. Попробуйте ещё раз."

## Compatibility

- **PaperMC 1.21+** - Requires Paper 1.21 or newer
- **Java 21** - Built and tested with Java 21
- **Maven** - Uses Maven for dependency management

## Installation

1. Download the latest JAR from the Releases page
2. Place the JAR file in your server's `plugins` directory
3. Restart your server or use `/reload`
4. Configure the plugin by editing `plugins/mLeadVillager/config.yml`

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

## Русская версия описания

**mLeadVillager** - плагин для Minecraft Paper 1.21+, который позволяет игрокам привязывать жителей на поводки, как обычных животных.

### Основные возможности:
- Привязывайте жителей на поводки и ведите их за собой
- Привязывайте жителей к заборам
- Настраиваемые ограничения (дети, бездельники, безработные)
- Кастомные сообщения на русском языке
- Команда `/mlead reload` для горячей перезагрузки

### Разрешения:
- `mleadvillager.leash` - разрешает привязывать жителей (по умолчанию: true)
- `mleadvillager.reload` - разрешает перезагружать конфигурацию (по умолчанию: op)

### Совместимость:
- PaperMC 1.21+
- Java 21
- Maven для сборки