EditionPerms

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper purpur spigot

标签： management utility

EditionPerms

A lightweight Minecraft plugin for managing permissions separately for Java Edition and Bedrock Edition players on crossplay servers.

Features

• ? Separate permissions for Java and Bedrock players
• ? Automatic player detection via username prefix and UUID checking
• ? Fast reload - Update permissions without restarting the server
• ⚡ Folia compatible - Works on both Paper and Folia servers
• ?️ Simple configuration - Easy YAML setup
• ? Lightweight - Minimal performance impact

Why was this plugin created?

This plugin was originally created to solve a specific problem on crossplay servers: giving Java Edition players anticheat bypass permissions while keeping Bedrock Edition players under normal anticheat protection. It has since evolved into a simple permission management system for any crossplay server running Geyser/Floodgate.

How It Works

1. Player joins → Plugin detects if they're Java or Bedrock

   • Checks username prefix (default: . for Bedrock)
   • Checks UUID format (00000000-0000-0000-xxxx for Bedrock)

2. Groups are checked → Plugin finds matching groups based on player type

3. Permissions applied → All matching groups' permissions are granted instantly

Commands

1. Download the latest EditionPerms-x.x.x.jar
2. Place the JAR file in your plugins/ folder
3. Restart your server
4. Edit plugins/EditionPerms/config.yml to configure permissions
5. Run /editionpermsreload or restart to apply changes

Configuration

The plugin creates a config.yml file in plugins/EditionPerms/:

# ==================================================================================
# BEDROCK PLAYER DETECTION
# ==================================================================================
# These settings determine HOW the plugin identifies Bedrock players
detection:
  # Bedrock players have this prefix in their username (default: ".")
  # Example: ".PlayerName" is a Bedrock player, "PlayerName" is Java
  bedrock-prefix: "."

  # Also check UUID format to detect Bedrock players (recommended: true)
  # Bedrock UUIDs start with "00000000-0000-0000"
  bedrock-uuid-check: true

# ==================================================================================
# PERMISSION GROUPS
# ==================================================================================
# After a player is identified as Java or Bedrock, these groups assign permissions

groups:
  # Give permissions to ALL Java players
  default-java:
    type: java
    prefix: ""  # LEAVE EMPTY to apply to ALL Java players
    permissions:
      - minecraft.command.me
      - minecraft.command.trigger

  # Give permissions to ALL Bedrock players
  default-bedrock:
    type: bedrock
    prefix: ""  # LEAVE EMPTY to apply to ALL Bedrock players
    permissions:
      - minecraft.command.me
      - minecraft.command.trigger

Example Configurations

Give Java players anticheat bypass:

groups:
  default-java:
    type: java
    prefix: ""
    permissions:
      - nocheatplus.shortcut.bypass
      - spartan.bypass
      - essentials.spawn

  default-bedrock:
    type: bedrock
    prefix: ""
    permissions:
      - essentials.spawn

Give Java players creative permissions:

groups:
  default-java:
    type: java
    prefix: ""
    permissions:
      - worldedit.selection
      - essentials.fly
      - essentials.gamemode

  default-bedrock:
    type: bedrock
    prefix: ""
    permissions:
      - essentials.spawn

License

This project is licensed under the MIT License - see the LICENSE file for details.