Changelog

Version 1.0.0 - Initial Release

🎉 New Features

💔 Dynamic Health System

• Health Loss on Death: Players lose 2 HP (1 heart) when they die
• Health Gain on Kill: Players gain 2 HP (1 heart) for each kill
• Smart Absorption Hearts: Properly handles temporary absorption hearts
• Configurable Limits:
  • Minimum health: 2 HP (1 heart)
  • Maximum health: 40 HP (20 hearts)
  • All values configurable in config.yml

⚔️ Judgment Night Mode (Battle Royale)

• Start Event: /smp king start - Begins server-wide PvP tournament
• Stop Event: /smp king stop - Ends the event and announces winner
• Auto Spectator: Dead players automatically switch to spectator mode
• Kill Tracking: Real-time leaderboard shows kills during event
• Portal Blocking: Prevents access to Nether and End portals during battle
• Safe Teleportation: Automatically finds safe spawn location at 0,0
• Winner Announcement: Displays top 3 players with kill counts
• Manual Control: Admins have full control over event timing

🔥 Nether Roof Protection

• Damage System: Players above Y=127 in Nether take 2 HP damage every 3 seconds
• Warning Messages: Players receive warnings when taking damage
• Smart Cooldown: 5-second message cooldown to prevent spam
• Configurable: Adjust damage amount and interval in config

💥 Explosion Control

• Blocks: TNT, Creeper explosions, TNT Minecarts
• Allows: Wither explosions, End Crystal explosions
• Build Protection: Keeps structures safe from griefing
• Boss Fights: Doesn't interfere with Wither and Dragon fights

🌍 Multi-Language Support

• 5 Languages Included:
  • 🇷🇺 Russian (Русский)
  • 🇬🇧 English
  • 🇩🇪 German (Deutsch)
  • 🇪🇸 Spanish (Español)
  • 🇫🇷 French (Français)
• Hex Color Gradients: Beautiful color transitions in messages
• Fully Customizable: Edit any message in language files
• Easy to Extend: Add your own language by copying message file

🎨 Festive New Year Theme

• Special Messages: New Year themed notifications
• Gradient Colors: Eye-catching purple-to-blue gradients
• Customizable: Change colors and messages to match your server style

🛠️ Commands

Main Command: /smp

All commands require appropriate permissions.

Reload Configuration

/smp reload

• Permission: smp.reload or smp.admin
• Reloads config.yml and all language files
• No server restart needed

Battle Royale Control

/smp king start
/smp king stop

• Permission: smp.king or smp.admin
• start: Begins Judgment Night event
  • Teleports all players to spawn (0,0)
  • Blocks portal access
  • Enables kill tracking
• stop: Ends event
  • Announces winner and top 3
  • Restores normal gameplay
  • Resets kill counters

Health Management

/smp sethp <player> <amount>
/smp addhp <player> <amount>
/smp removehp <player> <amount>
/smp resethp <player>

• Permission: smp.hp or smp.admin
• sethp: Sets player's max health to exact amount (2-40 HP)
• addhp: Adds HP to player's current max health
• removehp: Removes HP from player's current max health
• resethp: Resets player's health to default 20 HP

Examples:

/smp sethp Steve 30     # Sets Steve's max health to 15 hearts
/smp addhp Alex 4       # Adds 2 hearts to Alex
/smp removehp Bob 6     # Removes 3 hearts from Bob
/smp resethp Charlie    # Resets Charlie to 10 hearts

📋 Permissions

Admin Access

• smp.admin - Full access to all commands

Individual Permissions

• smp.reload - Reload configuration
• smp.king - Control Judgment Night events
• smp.hp - Manage player health

Permission Examples:

# Give admin full access
- smp.admin

# Or give specific permissions
- smp.reload
- smp.king
- smp.hp

⚙️ Configuration

config.yml Structure:

# Language selection
language: "ru"  # Options: ru, en, de, es, fr

# Dynamic Health System
health:
  loss-on-death: 2        # HP lost on death (1 heart = 2 HP)
  gain-on-kill: 2         # HP gained on kill
  min-health: 2           # Minimum health (1 heart)
  max-health: 40          # Maximum health (20 hearts)

# Nether Roof Protection
nether:
  damage: 2               # Damage dealt above Y=127
  damage-interval: 60     # Ticks between damage (3 seconds)
  message-cooldown: 100   # Ticks between messages (5 seconds)

# Explosion Control
explosions:
  block-tnt: true         # Block TNT explosions
  block-creeper: true     # Block Creeper explosions
  block-minecart: true    # Block TNT Minecart explosions
  allow-wither: true      # Allow Wither explosions
  allow-end-crystal: true # Allow End Crystal explosions

🎯 Use Cases

Hardcore SMP Servers

• Adds permanent consequences to death
• Rewards skilled PvP players
• Creates high-stakes gameplay

PvP Servers

• Health advantage for top players
• Encourages competitive play
• Built-in tournament system

Event Servers

• Easy-to-run battle royale events
• Automatic spectator management
• Winner announcements

Survival Servers

• Protects builds from explosions
• Prevents Nether roof exploits
• Maintains vanilla boss fights

International Servers

• Multi-language support out of the box
• Easy to add more languages
• Professional localization

🚀 Technical Details

Performance

• Lightweight and optimized
• Minimal server impact
• Efficient event handling

Compatibility

• Paper 1.21+ (recommended)
• Spigot 1.21+
• Purpur 1.21+
• Java 21+

Dependencies

• None! Standalone plugin

File Structure

plugins/SMP/
├── config.yml
├── messages_ru.yml
├── messages_en.yml
├── messages_de.yml
├── messages_es.yml
└── messages_fr.yml

📦 Installation

1. Download SMP-1.0.0.jar
2. Place in server's plugins folder
3. Restart server
4. Plugin generates default config
5. Edit config.yml to your preferences
6. Use /smp reload to apply changes
7. Enjoy!

🔧 Configuration Tips

For Hardcore Servers:

health:
  loss-on-death: 4      # Lose 2 hearts per death
  gain-on-kill: 2       # Gain 1 heart per kill
  min-health: 2         # Can go down to 1 heart

For Casual Servers:

health:
  loss-on-death: 2      # Lose 1 heart per death
  gain-on-kill: 4       # Gain 2 hearts per kill
  min-health: 10        # Minimum 5 hearts

Disable Nether Damage:

nether:
  damage: 0             # Set to 0 to disable

Allow All Explosions:

explosions:
  block-tnt: false
  block-creeper: false
  block-minecart: false

📝 Notes

• Health values are in HP (1 heart = 2 HP)
• All timings are in ticks (20 ticks = 1 second)
• Language files support hex colors: &#RRGGBB
• Config changes require /smp reload or restart
• Player data persists across restarts

🐛 Known Issues

None! This is the stable initial release.

🔮 Future Plans

• More language support
• Additional game modes
• Custom event scheduling
• Statistics tracking
• Database support

---

Thank you for using SMP! 🎉

For support, bug reports, or feature requests, please open an issue on GitHub.