# PotionSteal
PotionSteal is a dynamic Minecraft plugin designed for PvP servers, adding a thrilling twist to combat by allowing players to steal potion effects from their opponents upon kills. With robust anti-alt detection, persistent IP storage, and powerful admin controls, PotionSteal ensures fair gameplay and seamless management. Fully configurable and optimized for performance, this plugin is perfect for servers looking to enhance their PvP experience.
---
## Features
## Commands
| Command | Description | Permission | Usage |
|---------|-------------|------------|-------|
|
|
|
|
|
|
|
|
---
## Permissions
| Permission | Description | Default |
|------------|-------------|---------|
|
|
---
## Configuration
The plugin is fully configurable via
### Configuration Options
---
## Installation
1. Download the Plugin:
- Purchase and download
2. Install the Plugin:
- Place
3. Start the Server:
- Start or restart your server to generate
4. Configure the Plugin:
- Edit
- Use
5. Set Permissions:
- Grant
- Optionally grant
6. Test the Plugin:
- Join with multiple accounts to test anti-alt detection.
- Use
---
## Support
For issues, suggestions, or questions, please contact us via:
---
PotionSteal brings strategic depth to PvP with its unique effect-stealing mechanic and robust anti-alt system. Download now and elevate your server’s gameplay!
PotionSteal is a dynamic Minecraft plugin designed for PvP servers, adding a thrilling twist to combat by allowing players to steal potion effects from their opponents upon kills. With robust anti-alt detection, persistent IP storage, and powerful admin controls, PotionSteal ensures fair gameplay and seamless management. Fully configurable and optimized for performance, this plugin is perfect for servers looking to enhance their PvP experience.
---
## Features
- Effect Stealing on Kills: Players gain positive effects or lose negative effects when killing others, while victims lose positive effects or gain negative ones.
- Anti-Alt Detection: Prevents alternate accounts from abusing the system by tracking IPs, with persistent storage for offline checks.
- Persistent IP Storage: Stores player IPs in
ips.ymlto detect alts even when players are offline. - Admin Commands: Comprehensive tools to manage effects, check alt status, clear alt flags, save data, and reload configurations.
- Asynchronous Operations: Data loading, saving, and alt checks run async to minimize server lag.
- Dynamic Thread Pool: Scales threads based on player count (1 thread per 15 players, max 6) for optimal performance.
- Highly Configurable: Customize effect lists, limits, messages, and anti-alt settings via
config.yml. - Effect Protection: Blocks external
/effectcommands and unauthorized effect removals. - Milk Cooldown: Prevents effect loss from milk consumption with a 1-second cooldown.
- Paper Compatibility: Supports paper 1.21+ with modern potion effect APIs.
## Commands
| Command | Description | Permission | Usage |
|---------|-------------|------------|-------|
|
/potionsteal add <player> <positive|negative> <effect> | Adds a specific potion effect to a player. | potionsteal.admin | /potionsteal add Steve positive STRENGTH ||
/potionsteal remove <player> <positive|negative> <effect> | Removes a specific potion effect from a player. | potionsteal.admin | /potionsteal remove Steve negative WEAKNESS ||
/potionsteal clear <player> <positive|negative|all> | Clears specified or all potion effects from a player. | potionsteal.admin | /potionsteal clear Steve all ||
/potionsteal view <player> | Views a player’s current potion effects. | potionsteal.view | /potionsteal view Steve ||
/potionsteal save | Saves all player effect data to disk. | potionsteal.admin | /potionsteal save ||
/potionsteal checkalt <player> | Checks if a player is flagged as an alternate account. | potionsteal.admin | /potionsteal checkalt Steve ||
/potionsteal clearalt <player> | Clears a player’s alt status and IP from storage. | potionsteal.admin | /potionsteal clearalt Steve ||
/potionsteal reload | Reloads the plugin’s configuration from config.yml. | potionsteal.admin | /potionsteal reload |---
## Permissions
| Permission | Description | Default |
|------------|-------------|---------|
|
potionsteal.admin | Grants access to manage potion effects, save data, check/clear alt status, reload configuration, and receive admin notifications for alt attempts. | op ||
potionsteal.view | Allows viewing a player’s potion effects using /potionsteal view. | false |---
## Configuration
The plugin is fully configurable via
config.yml, located in the plugins/PotionSteal folder. Below is a sample configuration with key options:
YAML:
max-positive-effects-per-player: 3
max-negative-effects-per-player: 2
anti-alt-enabled: true
positive-effects:
- STRENGTH
- SPEED
- HASTE
- FIRE_RESISTANCE
- HEALTH_BOOST
- DOLPHINS_GRACE
- LUCK
- WATER_BREATHING
negative-effects:
- WEAKNESS
- SLOWNESS
- MINING_FATIGUE
- JUMP_BOOST
- SLOW_FALLING
- GLOWING
- BAD_LUCK
- HUNGER
messages:
positive: "&aYou gained the positive effect: &l{effect}"
negative: "&cYou received the negative effect: &l{effect}"
remove-positive: "&ePositive effect removed: &l{effect}"
remove-negative: "&eNegative effect removed: &l{effect}"
max-limit: "&cYou have reached the maximum potion effect limit!"
anti-alt-warning: "&cWarning: Your IP matches {player}'s. Alternate accounts are not allowed!"
alt-effect-denied: "&cEffect changes denied: You are detected as an alternate account."
alt-effect-admin-notify: "&cAlt account {player} attempted effect change as {role}!"
alt-kick-message: "&cYou were kicked: Alternate accounts are not allowed."
check-alt-is-alt: "&c{player} is flagged as an alternate account."
check-alt-not-alt: "&a{player} is not flagged as an alternate account."
clear-alt-success: "&aCleared alt status for {player}."
clear-alt-not-found: "&c{player} is not flagged as an alternate account."
command-reload-success: "&aConfiguration reloaded."
command-no-permission: "&cYou do not have permission."
command-invalid-usage: "&cInvalid usage."
command-data-saved: "&aData saved."
command-effect-added: "&aAdded {effect} to {player}"
command-effect-removed: "&aRemoved {effect} from {player}"
command-effects-cleared: "&aCleared {category} effects for {player}"
effect-command-disabled: "&cEffect commands are disabled."
external-effect-removed: "&cExternal effect {effect} was removed."
view-effects-header: "&6=== {player}'s Effects ==="
view-positive-effects: "&aPositive: {effects}"
view-negative-effects: "&cNegative: {effects}"- max-positive-effects-per-player: Maximum positive effects a player can have (default: 3).
- max-negative-effects-per-player: Maximum negative effects a player can have (default: 2).
- anti-alt-enabled: Enable/disable anti-alt detection (default: true).
- positive-effects: List of positive potion effects available for stealing.
- negative-effects: List of negative potion effects that can be applied.
- messages: Customizable messages with color codes and placeholders (e.g.,
{player},{effect}).
/potionsteal reload to apply changes to config.yml without restarting the server.---
## Installation
1. Download the Plugin:
- Purchase and download
PotionSteal.jar from BuiltByBit.2. Install the Plugin:
- Place
PotionSteal.jar in your server’s plugins folder.3. Start the Server:
- Start or restart your server to generate
plugins/PotionSteal/config.yml and ips.yml.4. Configure the Plugin:
- Edit
config.yml to customize effect lists, limits, and messages.- Use
/potionsteal reload to apply changes.5. Set Permissions:
- Grant
potionsteal.admin to admins (default: ops).- Optionally grant
potionsteal.view to staff for viewing effects.6. Test the Plugin:
- Join with multiple accounts to test anti-alt detection.
- Use
/potionsteal commands to manage effects and verify functionality.---
## Support
For issues, suggestions, or questions, please contact us via:
- BuiltByBit Profile: CLICK HERE
- Discord: CLICK HERE
---
PotionSteal brings strategic depth to PvP with its unique effect-stealing mechanic and robust anti-alt system. Download now and elevate your server’s gameplay!
