简体中文 | English
《我的世界》足球插件：球场创建与管理、实体足球物理、带球 / 传球 / 射门 / 冲刺、裁判比赛面板。
- 服务端：Paper / Folia 26.2+（
folia-supported: true） - Java 25
- 转播托管（
spec）暂不支持
- 从 Releases 下载
YuiFootball-<version>.jar。 - 放进服务端的
plugins/目录，重启服务端。 - 首次启动会生成
plugins/YuiFootball/config.yml与messages.yml。
/yf create <id>开始引导式创建，按 BossBar 提示用选点工具框出总范围、场地、红 / 蓝球门和球出生点，每步用 Shift+右键或/yf confirm确认。- 新建的球场默认停用，
/yf enable <id>启用。 /yf referee获取裁判哨，在球场内右键打开比赛面板开始比赛。/yf testball可以在面前生成一颗临时足球，用来试手感。
所有功能都在 /yuifootball（别名 /yf）下，/yf 不带参数显示帮助。
| 指令 | 说明 |
|---|---|
/yf create <id> |
开始引导式创建球场 |
/yf confirm | back | cancel |
确认、返回或取消当前创建步骤 |
/yf tool |
获取选点工具 |
/yf pos1 | pos2 |
用当前位置设置手动选区点 |
/yf settotal | setfield | setredgoal | setbluegoal <id> |
修改球场区域 |
/yf setball <id> |
把当前位置设为球出生点 |
/yf reset <id> |
把足球重置到出生点 |
/yf enable | disable | info | delete <id> |
管理球场 |
/yf skin <玩家 ID|reset> |
修改当前球场足球皮肤或恢复默认 |
/yf testball [玩家 ID] |
创建临时足球，可选使用指定玩家皮肤 |
/yf referee |
获取裁判哨，在球场内打开比赛面板 |
/yf gui |
在球场总范围内打开配置菜单 |
/yf reload |
重载配置、消息与球场文件，并取消进行中的创建与比赛 |
| 权限 | 默认 | 说明 |
|---|---|---|
yuifootball.admin |
op | 全部子命令（含 yuifootball.referee） |
yuifootball.referee |
op | /yf referee：获取裁判哨，在球场内打开比赛面板 |
路径（plugins/YuiFootball/） |
内容 |
|---|---|
config.yml |
所有球场共用的外观、物理、交互、比赛参数 |
messages.yml |
玩家可见文本（& 颜色代码） |
fields/<id>.yml |
每个球场一个文件；删除的球场归档在 fields/archive/ |
需要 JDK 25。
./gradlew build # 构建并运行测试，产物：build/libs/YuiFootball-<version>.jar
./gradlew deploy # 构建并拷贝到本地测试服的 plugins/deploy 需要先配置本地测试服目录，写在 ~/.gradle/gradle.properties（不要提交到仓库）：
yuifootball.testServerDir=/path/to/server也可以临时传参：./gradlew deploy -Pyuifootball.testServerDir=/path/to/server。