Amai's Anime Fight

Amai's Anime Fight

Note: Idea for this plugin is from discord community, join if you have ideas 💖

Overview

The AmaisAnimeFight plugin adds an exciting feature to your Minecraft server: the ability for players to activate a "Target Lock On" mode. This mode allows players to automatically lock onto and aim towards nearby living entities such as other players, mobs, or creatures within a configurable range.

Key Features

1. Toggleable Target Lock On

- Players can enable or disable the "Target Lock On" mode using the `/lo` command. - When activated, the plugin continuously updates the player's orientation to face towards the nearest living entity within the specified range.

2. Stabilized View

- To prevent the screen from feeling too jarring during fast movements and rotations, the plugin features a stabilization factor. This parameter controls how smoothly the player's view transitions toward the target. - The default stabilization factor is set to 0.1, which offers a balanced level of smoothness. Administrators can adjust this value in the configuration file to suit their preferences.

3. Configurable Settings

- Stabilization Factor: Specifies the maximum distance within which players can lock onto living entities. - Stabilization Factor: Determines how frequently (in ticks) the plugin updates the player's orientation towards the target, allowing for fine-tuning of responsiveness. - Stabilization Factor: Controls the smoothness of rotation transitions when locking onto a target.

How It Works

1. Activation: - Players use the `/lo` command to activate or deactivate the Target Lock On mode. - Upon activation, the plugin begins a task that periodically checks for the nearest living entity within the defined range.

2. Target Detection: - The plugin scans a spherical area around the player and identifies all living entities (excluding the player themselves). - It then determines the closest living entity to the player based on distance.

3. View Adjustment: - Once the target is identified, the plugin calculates the necessary rotation (yaw and pitch) for the player's view to face towards the target. - Using a stabilization factor, the plugin smoothly transitions the player’s orientation over time, rather than instantaneously snapping to the new direction.

4. Deactivation: - When the Target Lock On mode is deactivated, the plugin stops updating the player's orientation and cancels any ongoing tasks.

Configuration

The `config.yml` file provides easy-to-adjust settings that allow server administrators to tailor the plugin’s behavior:

- Less-Dynamic-Change: The maximum distance within which players can lock onto targets (default: 10 blocks). - Less-Dynamic-Change: The frequency of orientation updates in ticks (default: 1 tick). - Less-Dynamic-Change: The factor controlling the smoothness of rotation transitions (default: 0.1). - Less-Dynamic-Change: When Player has Target on mob/player and new mob comes closer, target changes after x seconds (0 = change instantly)

Usage Instructions

1. Install the Plugin: - Place the `AmaisAnimeFight.jar` file into your server’s `/plugins` directory. - Restart your server to enable the plugin.

2. Configure the Plugin: - Edit the `config.yml` file located in the `/plugins/AmaisAnimeFight/` directory as needed. - Save the changes and restart the server to apply them.

3. Using Target Lock On: - As a player, type `/lo` in the chat to toggle the Target Lock On mode on or off. - While activated, your view will automatically adjust to face the nearest living entity within range.