Tiller

Tiller is a plugin for your 1.21+ Minecraft Server that adds a simple and fully-configurable auto-replant function to your game.

Features

• Crops harvested by players withthe tiller.use permission will be automatically replanted
• Automatically detects new crops using the Bukkit API's Ageable block type, so custom crops added using that block type should automatically be picked up by the plugin
• Items used to harvest crops can be configured
• Can be enabled/disabled by default
• Players can toggle auto-replant on/off using /tiller toggle
• Every option and message is fully configurable
• Very lightweight, only registers one world listener

Limitations

• No way to toggle tiller for other players without something like Essentials' sudo command (TODO)
• All crops can be auto-replanted. Crops cannot be disabled (TODO)
• Messages only support in-game YAML codes (TODO)
• Players with tiller.use will always be able to toggle it on/off (TODO)
• If non-tool items (items without a durability attribute) are configured to replant crops, they will never break and can be used indefinitely.

Commands

• /tiller - Displays plugin information (configurable in config.yml/messages)
• /tiller toggle - Toggle auto-replant functionality on/off per-player
• /tiller reload - Reloads the plugin config

Permissions

• tiller.use - Automatically replants crops harvested using items defined in config.yml, also grants access to /tiller toggle
• tiller.command.reload - Grants user access to the config reload command, should be given to server admins
• tiller.bypass_item_durability - If item damage is enabled in config.yml, players with this permission will still not lose durability on their tools used to harvest crops
• tiller.ignore_tool_restrictions - Players with this permission will not be required to use a tool defined in allowed-items for their crops to automatically be replanted

Configuration

config.yml

The config is commented to be as easy-to-understand as possible.

Out of the box:

• Players (with the correct permissions) will have tiller enabled by default
• Crops being harvested will obey the fortune enchantment
• Item (Tool) damage is enabled
• Destroying partially grown crops will damage items (tools)
• Partially grown crops will still be replanted
• allowed-items is configured to use all types of Hoe item (wooden, stone, iron, etc)

All of these options can be configured to your liking.

TO-DO

• Subtract one seed/item drop from harvested crops to better reflect the usage of seeds when replanting
• Configure blacklisted crop types
• Separate tiller.use and tiller.command.toggle permissions so players can use it without being able to toggle
• only tab complete tiller command for players with any tiller.command.* permissions
• Support Minedown formatting in messages
• Allow admins to toggle auto-replant on and off for other players
• Redo command/tab complete system to make it easier to add commands and subcommands
• Allow players to reset their replant-state back to the default