Code (Text):
# StaffPunch Plugin Configuration
# This plugin allows players to punch staff members with fun effects!
# Compatible with Minecraft versions 1.8-1.21.6
# Launch velocity for punched staff members (higher = more launch)
launch-velocity: 4
# Cooldown in seconds before a player can punch again
cooldown-seconds: 60
# Sound to play when punching (automatically converted for your server version)
# Modern versions (1.13+): ENTITY_SLIME_JUMP, ENTITY_EXPERIENCE_ORB_PICKUP, BLOCK_NOTE_BLOCK_PLING
# Legacy versions (1.8-1.12): SLIME_WALK, ORB_PICKUP, NOTE_PLING
sound: ENTITY_SLIME_JUMP
# Particle effect to spawn (automatically converted for your server version)
# Modern versions (1.13+): CLOUD, EXPLOSION_NORMAL, FIREWORKS_SPARK, HEART
# Legacy versions (1.8-1.12): CLOUD, EXPLOSION, FIREWORKS_SPARK, HEART
particle: CLOUD
# Number of particles to spawn
particle-count: 20
# Whether to broadcast a message when someone punches a staff member
broadcast-message: true
# Messages configuration
messages:
# Message shown when someone punches a staff member
# Placeholders: %puncher% = name of player who punched, %punched% = name of staff member
punch: "&a%puncher% &7punched &c%punched% &7into the air!"
# Message shown when a player is on cooldown
# Placeholders: %time% = remaining cooldown time in seconds
cooldown: "&cYou must wait &e%time% &cseconds before punching again!"
# Message shown when a player doesn't have permission to punch
no-permission: "&cYou don't have permission to punch staff!"
# Message shown when a player tries to punch themselves
self-punch: "&cYou can't punch yourself!"
# Version compatibility information:
# The plugin automatically detects your server version and adjusts:
# - Particle effects (Effect enum for 1.8-1.12, Particle enum for 1.13+)
# - Sound names (legacy names for 1.8-1.12, modern names for 1.13+)
# - API calls (reflection-based for maximum compatibility)
# Permission nodes:
# - staffpunch.punch: Allows players to punch staff members (default: true)
# - staffpunch.punchable: Makes a player punchable by others (default: op)
# - staffpunch.admin: Admin commands (default: op)
# List of world names where punching and the GUI are allowed
whitelisted-worlds:
- world
- world_lobby
- staff_lounge