Super Farming

Super Farming

中文文档 (Chinese README)

Super Farming is a Minecraft plugin designed for Folia/Paper/Spigot servers that introduces an advanced, automated farming system. It allows players to craft special "Super Hoes" that can be used to create fully automatic farms, handling everything from tilling and planting to fertilizing and harvesting.

Features

- Multi-language Support: Craft different levels of hoes with customizable abilities. - Multi-language Support: Place a Tier 2 Super Hoe on a composter to create a farm that works automatically. - Multi-language Support: Use an anvil to upgrade your hoe's range, mode (fertilizing), and bone meal usage. - Multi-language Support: Server administrators can adjust key parameters like processing speed, farm range, and bone meal limits via `config.yml`. - Multi-language Support: Built with Folia's multi-threaded environment in mind, ensuring thread-safe operations and server stability. - Multi-language Support: Fine-grained control over who can use the plugin's features. - Multi-language Support: Comes with English and Chinese language files by default.

How to Get Started

1. Craft a Super Hoe (Tier 1)

You can craft a Tier 1 Super Hoe using the following recipe in a crafting table (this recipe can be customized):

- Top Row: Diamond, Netherite Ingot, Diamond - Middle Row: Diamond, Netherite Hoe, Diamond - Bottom Row: Air, Netherite Ingot, Air

2. Upgrade the Hoe (Optional)

You can customize your Super Hoe on an anvil:

- fertilizer mode: Give your hoe a custom name. - fertilizer mode: Increases the fertilizer mode of the hoe's farming operations. - fertilizer mode: Sets the fertilizer mode the automatic farm will use per cycle. - fertilizer mode: Toggles the fertilizer mode on or off.

3. Craft a Tier 2 Super Hoe

To create an automatic farm, you need a Tier 2 Super Hoe. Craft it using the following recipe:

- Place a Nether Star in the center of a Smithing Table. - Add a Nether Star to the upgrade slot.

4. Create an Automatic Farm

1. Place a Sneak and right-click block on the ground. This will be the center of your farm. 2. Hold the Sneak and right-click. 3. Sneak and right-click the Composter.

The hoe will be placed in an invisible armor stand, and the farm will activate, automatically farming the area around the composter.

5. Deactivate the Farm

To get your hoe back and stop the farm, simply break the Composter block. If you are the owner, the hoe will be returned to your inventory.

Commands

- `/super_farming reload` - Reloads the plugin's `config.yml` and language files. - `/super_farming give <player> <item_name>` - Gives a player a specific Super Farming item (e.g., `super_hoe_tier1`).

Permissions

- `super_farming.reload`: Allows a player to use the `/super_farming reload` command. - `super_farming.give`: Allows a player to use the `/super_farming give` command. - `super_farming.admin.bypass`: Allows a player to break or retrieve farms they do not own.

Configuration (`config.yml`)

The `config.yml` file allows you to customize various aspects of the plugin:

```yaml

How often the farm processing task runs (in ticks). 20 ticks = 1 second.

farm-processing-interval: 20

The maximum Y-level range a farm can search for blocks to farm.

This can be upgraded on a hoe using an Echo Shard.

max-y-range: 5

The maximum amount of bone meal an automatic farm can use per cycle.

This can be set on a hoe by combining it with bone meal in an anvil.

max-bonemeal-amount: 10