ZLives

Please read the concept of this plugin

Concept :

• 1. Player A and Player B gets default 3 lives and 10 Hearts
• 2. Player A killed Player B, then Player B will lose 1 live (remaining = 2) and in exchange of the live, player B will get +5 Hearts (total = 15).
• 3. If Player A again killed Player B, then Player B will lose 1 live (remaining = 1) and in exchange of the live player B will get +5 Hearts (total = 20)
• 4. After this if Player B killed Player A, then Player B will gain 1 live and -5 Hearts.

• NOTE : The maximum hearts obtainable are 25 and maximum lives are 3, so no one can go beyond it (untill changed from config.yml)

1. Plugin Description

ZLives is a unique Minecraft plugin that introduces a lives and heart system to your server. Players start with a limited number of lives and hearts, and their actions (such as killing other players or being killed) affect their lives and hearts. Key features include:

• Lives System:
  Players start with a default number of 3 lives. When a player loses all their lives, they are eliminated and put into spectator mode.
• Heart System:
  Players have a limited number of hearts, default is 10 (20 Heart points). Hearts determine the player’s max health.
• Revival System: Eliminated players can be revived using a special Revive Book or by an admin using the /revive command.
• Elimination Animation: When a player is eliminated, a dramatic animation and sound effect play to signify their elimination.
• Customizable Config: The plugin allows server admins to configure default lives, hearts, and other settings via the config.yml file.
• Commands:
  • /lives: Check your remaining lives and hearts.
  • /revive <player>: Revive an eliminated player (admin-only).
  • /elimination-animation: Play the elimination animation on a player or at specific coordinates (admin-only).

2. Installation Guide

Follow these steps to install and set up the ZLives plugin on your Minecraft server:

Step 1: Download the Plugin

1. Download the ZLives.jar file from the provided source (e.g., SpigotMC, GitHub, or your custom build).
2. Place the ZLives.jar file in your server's plugins folder.

Step 2: Start the Server

1. Start or restart your Minecraft server.
2. The plugin will generate a default config.yml file in the plugins/ZLives folder.

Step 3: Configure the Plugin

1. Open the config.yml file located in the plugins/ZLives folder.
2. Customize the settings as needed.

Step 4: Test the Plugin

1. Join your server and test the plugin’s features.
2. Use the /lives command to check your lives and hearts.
3. Test the elimination and revival mechanics.

---

3. Screenshots

Elimination Animation

Players see a dramatic animation when they are eliminated.

Revival Animation

Players see a dramatic animation when they are eliminated.

Revive Book

The Revive Book can be crafted and used to revive eliminated players.

Note: This recipe can be changed from config.yml.

Remaining Lives message after killed by a player

+5 Hearts on every death by a player

+5 Hearts when a player is killed by other player

Elimination Message

ReviveGUI

4. Donations

Liked my Content? Want to support me?

• Support me by sending money on this UPI QR Code.
  

5. Reporting Issues

Need Help? Contact Us!
Encountered a problem or have suggestions? We’re here to assist you!

📧 Discord Support: Contact me on Discord at @iitian_69.

Step 1: Check the Logs

1. Look for error messages in the server console or logs/latest.log.
2. Copy the relevant error message.

Step 2: Provide Details

When reporting an issue, include the following information:

• Minecraft Version: The version of Minecraft your server is running.
• Server Software: The server software you’re using (e.g., Spigot, Paper).
• Plugin Version: The version of the ZLives plugin you’re using.
• Steps to Reproduce: A detailed description of how to reproduce the issue.
• Error Logs: The error message or log snippet.

Step 3: Submit the Issue

Contact me at discord username is : @iitian_69

Example Issue Report

**Minecraft Version**: 1.21.4
**Server Software**: Paper
**Plugin Version**: 1.0.0
**Issue**: Players are not losing hearts when they kill another player.
**Steps to Reproduce**:
1. Set default lives to 3 and hearts to 10 in the config.
2. Have a player with 2 lives kill another player.
3. Check the killer’s hearts after the kill.
**Error Logs**: [No errors in the logs]

Final Notes

The ZLives plugin adds a unique and engaging gameplay mechanic to your Minecraft server. If you have any questions, need further assistance, or want to suggest new features, feel free to reach out!

Happy gaming!