Harvest (Colheita Inteligente)

This mod allows players to harvest and automatically replant crops in a single action by right-clicking a mature plant.

Description

Mod Overview
"Smart Harvest" is a quality-of-life mod for Minecraft that simplifies and streamlines the farming process. Its main function is to allow the player to harvest mature crops and instantly replant them with a single right-click. This eliminates the need to break the crop block, collect the items and seeds, and then plant the seed again, saving time and making large farms much easier to manage.

Detailed Functionality
The mod consists of three main components that work together: the configuration loader, the harvest manager, and the reload command.

1. One-Click Harvest and Replant (HarvestEventHandler.java)
This is the core mechanic of the mod.

Action: When a player right-clicks on a block, the mod checks whether that block matches a predefined "harvest rule."

Maturity Check: The rule defines a specific state for the crop, usually the fully grown stage (e.g., wheat with metadata 7).

Harvest Execution (Server-Side): If the crop is mature, the server-side logic is activated:

Harvest drops (such as wheat and seeds) are calculated and spawned in the world for the player to collect.

The crop block is immediately replaced with its "initial" version (the newly planted seed), as defined in the rule.

Player Feedback (Client-Side): To ensure an intuitive and enjoyable experience, the mod provides several visual and audio effects that occur on the client:

Arm Animation: The player's arm swings, as if performing an action.

Sound Effects: An Enderman teleport sound (mob.endermen.portal) plays to provide audible feedback of the harvest.

Particles: A portal particle visual effect is generated at the harvest location, visually confirming the action.

2. Highly Customizable Configuration (SmartHarvestMod.java)
The mod is designed to be flexible, allowing users (or server administrators) to define exactly which crops can be harvested this way.

Configuration File: The mod creates a configuration file in the Minecraft config folder.

Rule System: Users can define "transformation rules" in this file. Each rule consists of four numbers: StartID, StartGoal, EndID, EndGoal.

StartID,StartGoal: Represents the mature crop (e.g., 59.7 for grown wheat).

EndID,EndGoal: Represents the seed that will be replanted (e.g., 59.0 for wheat seed).

Multiple Rules: You can add multiple rules by separating them with a semicolon (;), allowing the mod to work with wheat, potatoes, carrots, and even crops from other mods, as long as their IDs and metadata are known.

Loading: These rules are loaded when the game starts. The mod also handles malformed or empty rules to prevent game crashes.

3. Real-Time Reload Command (ReloadCommand.java)
This is an advanced feature and very useful for server administrators and modpack creators.

Command: The mod adds the /replantreload command to the game.

Function: When you run this command, the mod reloads the configuration file and updates all harvesting rules in real time, without the need to restart the game or the server.

Permissions: The command is restricted to server operators (OPs), ensuring that only players with permission can change the mod's behavior during gameplay.

Command Feedback: The player executing the command receives a message in chat indicating whether the configuration was successfully reloaded or if an error occurred.

What is the Mod For?
In short, "Smart Harvest" serves to:

Increase Efficiency: Reduces manual farming, making it a faster and less tedious task.

Improve Quality of Life: Provides more fluid and intuitive gameplay mechanics that integrate seamlessly with Minecraft.

Be Highly Compatible and Configurable: Allows players and server administrators to adapt it to work with virtually any type of crop, whether from the base game or other mods.

Easy Server Administration: The reload command is a powerful tool for administrators who need to quickly adjust mod settings.

=========================================================================

Descrição Geral do Mod

O "Colheita Inteligente" é um mod de qualidade de vida para o Minecraft que simplifica e agiliza o processo de agricultura. Sua função principal é permitir que o jogador colha plantações maduras e as replante instantaneamente com um único clique do botão direito do mouse. Isso elimina a necessidade de quebrar o bloco da plantação, coletar os itens e sementes, e depois plantar a semente novamente, economizando tempo e tornando as grandes fazendas muito mais fáceis de gerenciar.

Funcionalidades Detalhadas

O mod é composto por três componentes principais que trabalham juntos: o carregador de configurações, o gerenciador de colheita e o comando de recarregamento.

1. Colheita e Replantio com um Clique (HarvestEventHandler.java)

Esta é a mecânica central do mod.

Ação: Quando um jogador clica com o botão direito em um bloco, o mod verifica se esse bloco corresponde a uma "regra de colheita" pré-definida.
Verificação de Maturidade: A regra define um estado específico para a colheita, geralmente o estágio totalmente crescido (por exemplo, trigo com metadados 7).
Execução da Colheita (Lado do Servidor): Se a plantação estiver madura, a lógica do servidor é ativada:
- Os drops da colheita (como trigo e sementes) são calculados e gerados no mundo para o jogador coletar.
- O bloco da plantação é imediatamente substituído por sua versão "inicial" (a semente recém-plantada), conforme definido na regra.
Feedback ao Jogador (Lado do Cliente): Para que a experiência seja intuitiva e agradável, o mod fornece vários efeitos visuais e sonoros que ocorrem no cliente:
- Animação do Braço: O braço do jogador balança, como se estivesse realizando uma ação.
- Efeitos Sonoros: Um som de teleporte de Enderman (mob.endermen.portal) é tocado para dar um feedback auditivo da colheita.
- Partículas: Um efeito visual de partículas de portal é gerado no local da colheita, confirmando visualmente a ação.

2. Configuração Altamente Customizável (ColheitaInteligenteMod.java)

O mod é projetado para ser flexível, permitindo que os usuários (ou administradores de servidores) definam exatamente quais plantações podem ser colhidas dessa maneira.

Arquivo de Configuração: O mod cria um arquivo de configuração na pasta config do Minecraft.
Sistema de Regras: Os usuários podem definir "regras de transformação" neste arquivo. Cada regra consiste em quatro números: IDInicial,MetaInicial,IDFinal,MetaFinal.
- IDInicial,MetaInicial: Representa a plantação madura (ex: 59,7 para trigo crescido).
- IDFinal,MetaFinal: Representa a semente que será replantada (ex: 59,0 para a semente de trigo).
Regras Múltiplas: É possível adicionar várias regras, separando-as por ponto e vírgula (;), o que permite que o mod funcione com trigo, batatas, cenouras, e até mesmo com plantações de outros mods, desde que seus IDs e metadados sejam conhecidos.
Carregamento: Essas regras são carregadas quando o jogo é iniciado. O mod também lida com regras malformadas ou vazias para evitar que o jogo trave.

3. Comando de Recarregamento em Tempo Real (ReloadCommand.java)

Esta é uma funcionalidade avançada e muito útil para administradores de servidores e criadores de modpacks.

Comando: O mod adiciona o comando /replantreload ao jogo.
Função: Ao executar este comando, o mod recarrega o arquivo de configuração e atualiza todas as regras de colheita em tempo real, sem a necessidade de reiniciar o jogo ou o servidor.
Permissões: O comando é restrito a operadores do servidor (OPs), garantindo que apenas jogadores com permissão possam alterar o comportamento do mod durante o jogo.
Feedback do Comando: O jogador que executa o comando recebe uma mensagem no chat indicando se a configuração foi recarregada com sucesso ou se ocorreu um erro.

Para que Serve o Mod?

Em resumo, o "Colheita Inteligente" serve para:

Aumentar a Eficiência: Reduz o trabalho manual da agricultura, tornando-a uma tarefa mais rápida e menos tediosa.
Melhorar a Qualidade de Vida: Oferece uma mecânica de jogo mais fluida e intuitiva, que se integra perfeitamente ao Minecraft.
Ser Altamente Compatível e Configurável: Permite que os jogadores e administradores de servidor o adaptem para funcionar com praticamente qualquer tipo de plantação, seja do jogo base ou de outros mods.
Facilitar a Administração de Servidores: O comando de recarregamento é uma ferramenta poderosa para administradores que precisam ajustar as configurações do mod rapidamente.