🧠 KarmaCore
Turn your PvP actions into power.
KarmaCore adds a dynamic Karma system where killing and being killed directly changes your Karma — and your Karma changes how powerful you are.
⚔️ Karma System
Every player has a configurable Karma value.
When you kill another player:
- 🟢 Your Karma increases
- 🔴 The victim's Karma decreases
Example:
pvp:
killer-karma: 10
victim-karma: -10
The Karma range is completely configurable:
karma:
minimum: -100
maximum: 100
starting: 0
🟢 Positive Karma
Players with high Karma can receive positive effects.
For example:
positive-karma:
threshold: 50
effects:
SPEED:
amplifier: 0
duration: permanent
You can configure:
- Speed
- Strength
- Regeneration
- Resistance
- Custom rewards
- Custom effects
The server owner decides exactly how strong the bonuses are.
🔴 Negative Karma
Low Karma can make a player weaker.
Example:
negative-karma:
threshold: -50
effects:
SLOWNESS:
amplifier: 0
duration: permanent
You can configure:
- Slowness
- Weakness
- Mining Fatigue
- Other potion effects
- Custom penalties
⚖️ Karma Levels
Create your own Karma levels.
Example:
levels:
cursed:
min: -100
max: -51
bad:
min: -50
max: -1
neutral:
min: 0
max: 49
good:
min: 50
max: 99
blessed:
min: 100
max: 100
Each level can have its own effects, rewards, messages and permissions.
🔥 Revenge System
KarmaCore remembers who killed you.
If Player A kills Player B:
- Player A gains Karma
- Player B loses Karma
- Player B remembers Player A as their killer
When they meet again in PvP, configurable Revenge mechanics can activate.
You can configure:
- Revenge duration
- Revenge bonus
- Special effects
- Messages
- Sounds
- Particles
- Rewards
🎁 Karma Items
Create special items connected to the Karma system.
Example:
items:
karma-crystal:
material: AMETHYST_SHARD
name: "&dKarma Crystal"
lore:
- "&7Right-click to gain Karma."
karma: 10
You can customize:
- Material
- Name
- Lore
- Enchantments
- Karma value
- Effects
- Sounds
- Particles
📊 Karma GUI
Use:
/karma
The GUI displays:
- Current Karma
- Karma level
- Progress
- Active effects
- Recent Karma changes
- Revenge information
The entire GUI is configurable.
🛠️ Commands
/karma
/karma <player>
/karma top
/karma set <player> <amount>
/karma add <player> <amount>
/karma remove <player> <amount>
/karma reset <player>
/karma reload
Administrative commands require permissions.
⚙️ Configuration
Almost everything can be customized through config.yml.
Example:
karma:
minimum: -100
maximum: 100
starting: 0
pvp:
killer-karma: 10
victim-karma: -10
positive-karma:
threshold: 50
negative-karma:
threshold: -50
settings:
sounds: true
particles: true
revenge: true
Customize:
- Karma limits
- Starting Karma
- PvP values
- Karma thresholds
- Effects
- Effect levels
- Rewards
- Items
- Revenge
- GUI
- Messages
- Sounds
- Particles
- Cooldowns
- Permissions
🔐 Security
KarmaCore is designed to prevent abuse and exploits.
- Anti-Karma farming
- Kill cooldowns
- Duplicate event protection
- Server-side validation
- UUID-based player tracking
- Permission checks
- GUI exploit protection
- Item duplication protection
- Safe handling of disconnects
- Safe handling of restarts
- No unsafe player-input commands
⚡ Performance
KarmaCore is designed for near-zero performance impact.
- No unnecessary permanent loops
- Event-based architecture
- No constant player scanning
- Optimized memory usage
- SQLite persistence
- Asynchronous database operations when safe
- Configurable particle and sound limits
- No unnecessary entity spawning
The plugin is designed to remain lightweight even on servers with many players.
💾 Data Storage
Karma data is stored persistently using SQLite.
Player data includes:
- UUID
- Karma
- Karma history
- Karma level
- Revenge information
- Cooldowns
Your Karma remains after server restarts.
🧩 Compatibility
Minecraft 1.21.x
Paper
KarmaCore uses the official Paper/Bukkit API whenever possible and avoids unnecessary NMS.
Karma changes. Power follows. Choose your actions wisely.
