XFWorldLocker

XFWorldLocker (XFWL) v1.0.0

Overview

XFWorldLocker is a professional Minecraft plugin for Paper, Spigot and Bukkit 1.21.1+ that provides advanced world protection and management features.

Features

🌍 World Area Protection

• Define rectangular areas in worlds using X1,Z1 and X2,Z2 coordinates
• Automatic teleportation when players leave defined areas
• Y-coordinate independent (full height protection)

🔒 World Restrictions

• Block Protection: Control block breaking and placing
• Interaction Control: Manage player interactions with blocks/entities
• Mob Management: Control mob spawning and cleanup
• Damage Control: Enable/disable player damage
• Explosion Protection: Prevent explosions (except in creative mode)

✨ Player Effects

• Apply custom potion effects to players in specific worlds
• Automatic effect removal when leaving the world
• Configurable effect amplifiers

🚀 Dynamic Commands

• Create custom teleportation commands for each world
• Support for command aliases
• Optional permission requirements
• Automatic command registration

📝 Multi-language Support

• Fully customizable messages via language.yml
• Support for actionbar and chat messages
• Color code support with & symbol

Installation

1. Download the XFWorldLocker.jar file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure worlds in config.yml
5. Customize messages in language.yml

Configuration

config.yml Example

settings:
  prefix: "&a[XFWL]"
  debug: false

worlds:
  world:
    enabled: true
    spawnWorld: "world"
    area:
      x1: -100
      z1: -100
      x2: 100
      z2: 100
    spawnMobs: false
    canBreakBlocks: false
    canPlaceBlocks: false
    canInteract: false
    canTakeDamage: false
    
    effects:
      SPEED:
        amplifier: 1
      JUMP:
        amplifier: 0
    
    commands:
      command: "/world"
      aliases:
        - "/worldtp"
        - "/w"
      permission: ""

language.yml

All messages can be customized in the language.yml file. Use & for color codes and {placeholder} for dynamic values.

Commands

Admin Commands

• /xfwl reload - Reload plugin configuration
• /xfwl help - Show help message
• /xfwl version - Show plugin version
• /lock <worldname> - Instantly apply default restrictions to a world

Dynamic World Commands

Custom commands are automatically registered based on your world configurations.

Permissions

• xfwl.admin - Access to all admin commands (default: op)
• xfwl.lock - Permission to use the lock command (default: op)
• xfwl.bypass - Bypass all world restrictions (default: false)

Special Features

Smart Entity Management

• Villagers and NPCs are always protected
• Armor stands and item frames are preserved
• FancyNPCs plugin integration
• Automatic mob cleanup in restricted worlds

Creative Mode Support

• Creative players can bypass block restrictions
• Explosions work near creative players
• Enhanced building capabilities for admins

Performance Optimized

• Efficient area checking algorithms
• Minimal server impact
• Asynchronous update checking

Compatibility

• Minecraft Version: 1.21.1+
• Optimal Minecraft Version: 1.21.5+
• Server Software: Paper, Spigot, Bukkit
• Java Version: 17 or higher

Support

For support, updates, or to report bugs, contact me.

License

This plugin was created by xfinity. All rights reserved.