✨ sPotionSteal
A comprehensive Minecraft plugin that allows players to steal beneficial potion effects from others in SMP environments — now with full multilingual support!

Features

• Potion Effect Stealing – Sneak and right-click to steal beneficial effects from other players
  
  
• Multilingual Support – Full translations for English, 한국어 (Korean), 日本語 (Japanese), and Español (Spanish)
  
  
• ⏱️ Configurable Cooldowns – Prevent abuse with custom cooldowns and rank-based overrides
  
  
• ️ Advanced Permission System – Control who can steal, who is immune, and who has cooldown tiers
  
  
• Smart Filtering – Only positive effects can be stolen; harmful effects are immune
  
  
• Visual & Audio Feedback – Customizable particles and sounds on successful steals
  
  
• Detailed Messages – Displays exact potion effect names stolen with color-coded messages
  
  
• ️ Extensive Configuration – Customize nearly every detail to suit your server
  

How to Use

1. Activate: Sneak (shift) + right-click a player to attempt a steal
   
   
2. ✅ Permissions: Ensure you have the spotionsteal.steal permission
   
   
3. Cooldown: Wait for your cooldown to expire before trying again
   
   
4. Change Language: Use /spotionsteal lang <language> to switch your preferred language
   

Commands
Command Description
/spotionsteal help Show help message
/spotionsteal reload ♻️ Reload configs and languages (admin only)
/spotionsteal toggle Enable/disable plugin (admin only)
/spotionsteal status ⏳ Check plugin status and your cooldown
/spotionsteal lang <en/ko/ja/es> Change your preferred language
Permissions
Permission Node Description
spotionsteal.steal Allows stealing potion effects (default: true)
spotionsteal.command ️ Access to plugin commands (default: op)
spotionsteal.admin Full admin access (reload/toggle, default: op)
spotionsteal.immune ️ Immune to stealing (default: false)
spotionsteal.cooldown.vip ⚡ Reduced cooldown for VIPs
spotionsteal.cooldown.premium ⚡⚡ Reduced cooldown for Premium players
spotionsteal.cooldown.admin Minimal cooldown for Admins
Supported Languages

• English (en) – Default
  
  
• 한국어 (ko) – Korean
  
  
• 日本語 (ja) – Japanese
  
  
• Español (es) – Spanish
  

Players can use /spotionsteal lang <language> to switch anytime.

⚙️ Configuration Highlights
Customize everything in config.yml to suit your server:

Basic Settings
yaml
stealing-enabled: true
cooldown-seconds: 30
max-effects-per-steal: 2
stolen-duration-multiplier: 0.75
⚡ Permission-Based Cooldowns
yaml
cooldown-overrides:
"spotionsteal.cooldown.vip": 20
"spotionsteal.cooldown.premium": 15
"spotionsteal.cooldown.admin": 5
Language Defaults
yaml
default-language: en
You can also configure:

• Particle effects (type, count, duration)
  
  
• Sound effects (type, volume, pitch)
  
  
• ⛔ Blacklisted effects
  
  
• Message styles with placeholders
  

Installation Guide

1. ⬇️ Download the plugin .jar file
   
   
2. Place it in your server's plugins/ folder
   
   
3. Restart your Minecraft server
   
   
4. ⚙️ Configure settings in plugins/sPotionSteal/config.yml
   
   
5. Edit translation files in plugins/sPotionSteal/lang/
   
   
6. Reload the plugin using /spotionsteal reload
   

️ Build & Compilation
To compile from source:

1. ☕ Install Java 17+ and Maven
   
   
2. Run mvn clean package in the plugin directory
   
   
3. Find the built .jar in the target/ folder
   

Requirements

• Minecraft 1.20.1+
  
  
• Spigot or Paper server
  
  
• ☕ Java 17 or newer
  

⚖️ Balanced Gameplay Mechanics

• ✅ Only beneficial effects like Speed, Strength, Fire Resistance can be stolen
  
  
• ❌ Harmful effects like Poison, Slowness, and Wither are protected
  
  
• ⏳ Reduced duration for stolen effects to prevent overpowering
  
  
• ⛔ Cooldowns and permission checks prevent spamming or abuse
  
  
• ️ Configurable maximum effects per steal
  

Advanced Features

• Smart Effect Detection – Automatically filters out harmful effects
  
  
• Custom Particles – Choose your favorite particle styles and animations
  
  
• Dynamic Sounds – Set custom sound types, volume, and pitch
  
  
• Formatted Messages – Rich text formatting with placeholders
  
  
• Permission Plugin Integration – Works with any permission system
  
  
• Performance Optimized – Efficient cooldown and effect management