SoulStreak

SoulStreak Plugin for Minecraft 1.21.11 Paper

A PvP streak system with tier-based bonuses and heart management for Minecraft Paper servers.

Features

- Heart Management: Track player kills with persistent data storage - Heart Management: Unlock bonuses as you build your streak - Heart Management: Craft and withdraw hearts for health management

Streak Tiers

| Kills | Tier | Benefits | |-------|------|----------| | 0-2 | No Streak | Default health (20 hearts) | | 3-4 | Tier 1 | Entry milestone | | 5-9 | Tier 2 | +2 hearts + Fire Resistance (24 total) | | 10-14 | Tier 3 | +3 hearts + Fire Resistance + Strength 1 (26 total) | | 15+ | Tier 4 | +5 hearts + Fire Resistance + Strength 1 + Speed 1 (30 total) |

Heart Mechanics

- Persistent Storage: Craft hearts using Diamond + Redstone - Persistent Storage: Right-click hearts to gain +1 heart - Persistent Storage: Withdraw bonus hearts as items with `/streak withdraw` - Persistent Storage: Heart data survives server restarts and relogs

Commands

- `/streak` - Check your current kill streak and tier - `/streak help` - Show available commands - `/streak withdraw` - Withdraw bonus hearts as items (requires permission)

Permissions

- `soulstreak.use` - Use basic streak commands (default: true) - `soulstreak.withdraw` - Withdraw hearts as items (default: op) - `soulstreak.admin` - Use administrative commands (default: op)

Requirements:

- Minecraft 1.21.11 Paper server - Java 21 or higher

Configuration

The plugin includes configurable settings in `config.yml`: - `streak-loss-on-death`: Amount of streak lost on death (default: 3) - `lose-heart-on-no-streak-death`: Whether players lose hearts on death with no streak (default: true) - `max-hearts`: Maximum hearts players can have (default: 10) - `natural-deaths-affect-nothing`: Whether natural deaths affect streak/hearts (default: true)

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

Support

For issues or feature requests, please go to the github and add it under issues: https://github.com/nanomangotrkmnia/SoulStreak