configuration.yml
The configuration.yml file defines how CrisStealCore behaves — from player hearts and bans to economy, messages, and anti-exploit protection.
This page explains each section in detail so you can customize your Lifesteal server easily.
🩸 General Settings
settings:
default-hearts: 20 # Hearts a player has the first time they join
prefix: "&8[&cCrisStealCore&8]&7 " # Chat prefix for all plugin messages
language: "EN-lang.yml" # Language file to load
economy:
use-vault: false # Disable to not use Vault for economy
use-coins: true # Enable CrisStealCore's custom coin system
hearts:
max: 50 # Maximum hearts a player can have (-1 = no limit)
clamp-non-admin: true # Prevent players from exceeding max; admins bypass this limit💀 Lives System
lives:
enabled: true # Enable or disable the lives system
max-deaths: 3 # Number of deaths allowed before a ban
reset-hearts-on-ban: true # Reset hearts when banned
ban:
use-command: true # Use a custom command for bans
command: "ban {PLAYER} {TIME} CrisSteal elimination"
duration-minutes: -1 # -1 = permanent, 0 = no ban, >0 = timed ban in minutes
kickMessage:
- ''
- '&c&lCrisLifesteal'
- ''
- '&fYou have been eliminated!'
- '&cLost all your hearts &4❤︎'
- ''
joinBannedMessage:
- ''
- '&c&lCrisLifesteal'
- ''
- '&fYou have been eliminated!'
- '&7Your ban will expire in &c{TIME}&7!'
- ''❤️ Lifesteal Mechanics
lifesteal:
steal-on-kill: 2 # Hearts stolen when killing another player
lose-on-death: 0 # Hearts lost when dying
min-hearts: 1 # Minimum number of hearts a player can have
ban-at-hearts: 0 # Hearts threshold for automatic ban
disabled-worlds: ["example_world", "example_world_2"] # Worlds where lifesteal is disabled
enable-ban: true # Disable to prevent bans from heart loss
⚰️ On-Player-Death Events
on-player-death:
enabled: true # Enable death-related effects
particles-effect: "WITCH" # Particle shown on death
disabled-worlds: ["example_world", "example_world_2"]
execute-commands:
- criscoreadmin add healt %player_name% 1
messages:
enabled: true
on-death:
- "&c❤︎ &aYou gained 1 heart on death!"
title:
message: "&c&lYou died!"
fade-in: 10
stay: 60
fade-out: 20
subtitle:
message: "&7Be careful next time..."
actionbar:
message: "&eLost items? Check your grave!"
🧠 Anti-Exploit System
anti-exploit:
enabled: true # Enable anti-exploit features
block-same-ip: true # Prevent kills between players with same IP
repeat-kill-window-seconds: 120 # Cooldown to prevent repeated kills from same IP
prevent-drops-on-exploit: true # Block custom drops when an exploit is detected
warn-message-withSameIp: "&c{player} &eentered with the same IP address as &4{player-other}&e!"
admin-bypass:
enabled: true
permission: "cris.core.bypass" # Permission to bypass anti-exploit
💎 Withdraw & Redeem Hearts
withdraw:
heart-item-id: "heart_1" # ID of the heart item from the items/ folder
redeem:
heart-item-id: "heart_1" # ID of the redeemable heart item from items/
💬 Messages and UI
messages:
enable-death-messages: true # Show death messages in chat
enable-custom-death-messages: true # Use custom messages from deaths-messages.yml
enable-welcome: true # Show welcome messages to players
first-join: |
&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
&c&lWelcome to Lifesteal SMP!
&7Your journey begins with &c20 hearts&7.
&7Fight to survive and steal hearts from others!
&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
first-join-broadcast: "&a&l+ &f{player} &7joined the Lifesteal SMP for the first time!"
welcome-back: |
&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
&c&lWelcome back to Lifesteal SMP!
&7You currently have &c{hearts} hearts&7.
&7Good luck in your battles!
&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 Chat System
chat:
enabled: true # Enable CrisStealCore's custom chat system (hover text, /msg, /tell)
# (see chat.yml)🔁 Resurrection System
resurrection:
enabled: true # Enable resurrection mechanics (see resurrection-logic.yml)Last updated