EditionPerms
一款轻量级的 Minecraft 插件,用于在跨平台服务器中分别为 Java 版和基岩版玩家管理权限。
功能
- ? Java 和基岩版玩家拥有独立的权限
- ? 自动检测玩家身份,通过用户名前缀和 UUID 检查实现
- ? 快速重载 - 无需重启服务器即可更新权限
- ⚡ 兼容 Folia - 同时适用于 Paper 和 Folia 服务器
- ?️ 配置简单 - 易于设置的 YAML 格式
- ? 轻量级 - 对性能影响极小
为什么创建此插件?
该插件最初是为了解决跨平台服务器上的一个特定问题:赋予 Java 版玩家反作弊绕过权限,同时让基岩版玩家受到正常的反作弊保护。此后,它已演变为一个适用于任何运行 Geyser/Floodgate 的跨平台服务器的简易权限管理系统。
工作原理
-
玩家加入 → 插件检测其是 Java 版还是基岩版玩家
- 检查用户名前缀(默认:
. 代表基岩版)
- 检查 UUID 格式(基岩版的 UUID 为
00000000-0000-0000-xxxx 格式)
-
检查组匹配 → 插件根据玩家类型查找匹配的组
-
应用权限 - 所有匹配组的权限将立即授予
命令
| 命令 |
别名 |
所需权限 |
描述 |
/editionpermsreload |
/epr, /epreload, /editionreload |
editionperms.reload |
重载配置文件并重新应用所有权限 |
- 下载最新的
EditionPerms-x.x.x.jar
- 将 JAR 文件放入
plugins/ 文件夹
- 重启服务器
- 编辑
plugins/EditionPerms/config.yml 以配置权限
- 运行
/editionpermsreload 或重启服务器以应用更改
配置
插件会在 plugins/EditionPerms/ 目录下创建一个 config.yml 文件:
# ==================================================================================
# 基岩版玩家检测
# ==================================================================================
# 这些设置决定了插件如何识别基岩版玩家
detection:
# 基岩版玩家的用户名包含此前缀(默认:".")
# 示例:".PlayerName" 是基岩版玩家,"PlayerName" 是 Java 版玩家
bedrock-prefix: "."
# 同时检查 UUID 格式以检测基岩版玩家(建议:true)
# 基岩版 UUID 以 "00000000-0000-0000" 开头
bedrock-uuid-check: true
# ==================================================================================
# 权限组
# ==================================================================================
# 在识别玩家为 Java 版或基岩版后,这些组将分配相应的权限
groups:
# 赋予所有 Java 版玩家权限
default-java:
type: java
prefix: "" # 留空以应用于所有 Java 版玩家
permissions:
- minecraft.command.me
- minecraft.command.trigger
# 赋予所有基岩版玩家权限
default-bedrock:
type: bedrock
prefix: "" # 留空以应用于所有基岩版玩家
permissions:
- minecraft.command.me
- minecraft.command.trigger
示例配置
赋予 Java 版玩家反作弊绕过权限:
groups:
default-java:
type: java
prefix: ""
permissions:
- nocheatplus.shortcut.bypass
- spartan.bypass
- essentials.spawn
default-bedrock:
type: bedrock
prefix: ""
permissions:
- essentials.spawn
赋予 Java 版玩家创造模式权限:
groups:
default-java:
type: java
prefix: ""
permissions:
- worldedit.selection
- essentials.fly
- essentials.gamemode
default-bedrock:
type: bedrock
prefix: ""
permissions:
- essentials.spawn
许可证
本项目遵循 MIT 许可证开源 - 详情请参阅 LICENSE 文件。
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
-
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)
-
Groups are checked → Plugin finds matching groups based on player type
-
Permissions applied → All matching groups' permissions are granted instantly
Commands
| Command |
Aliases |
Permission |
Description |
/editionpermsreload |
/epr, /epreload, /editionreload |
editionperms.reload |
Reloads the config and reapplies all permissions |
- Download the latest
EditionPerms-x.x.x.jar
- Place the JAR file in your
plugins/ folder
- Restart your server
- Edit
plugins/EditionPerms/config.yml to configure permissions
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧