xfinity World Locker Logo

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

Download the XFWorldLocker.jar file
Place it in your server's plugins folder
Restart your server
Configure worlds in config.yml
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.

XFWorldLocker