!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

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.