FFACore
一款用于运行自由对战(FFA)竞技场的 Minecraft 插件。
玩家可以选择一个竞技场并直接进行战斗,无需排队匹配。可以在游戏内创建和编辑竞技场,支持配置方块交互、爆炸效果、物品掉落、方块衰变以及地图再生等功能。
功能特性
- 支持多个 FFA 竞技场
- 使用类似 WorldEdit 的魔杖选择竞技场
- 游戏内的竞技场创建与编辑菜单
- 每个竞技场拥有独立的出生点
- 带有权限控制的竞技场传送点
- 防战斗日志断开保护
- 可选的方块破坏与放置权限
- 方块衰变计时器
- 地图再生计时器
- 爆炸设置
- 物品掉落设置
- 持久的竞技场配置
- 基于 MiniMessage 的消息和 GUI 文本
依赖项
命令
/selection-wand
给予你竞技场选择工具。
选择你想要用作竞技场的区域的两个角点。
/add-arena <name>
根据当前的选择区域创建一个新的竞技场。
创建完成后,FFACore 会打开竞技场设置菜单,你可以在其中配置以下内容:
- 竞技场名称
- 方块破坏/放置
- 方块衰变
- 地图再生
- 爆炸效果
- 物品掉落
/arenas
打开竞技场管理菜单。
在此你可以编辑现有竞技场、再生地图、传送到竞技场出生点或删除竞技场。
/warp <arena>
将你传送到某个竞技场。
玩家需要拥有特定竞技场的权限才能使用:
ffa.warp.<arena>
例如:
ffa.warp.desert
当玩家处于战斗状态时,传送将被阻止。
权限
| 权限 |
描述 |
ffa.admin |
访问竞技场管理命令 |
ffa.warp.<arena> |
访问特定竞技场的权限 |
默认情况下,ffa.admin 是一个 OP(管理员)权限。
竞技场设置
设置流程如下:
- 使用
/selection-wand 命令获取选择魔杖。
- 选择竞技场的两个点。
- 运行
/add-arena <name>。
- 在 GUI 中配置竞技场。
- 保存设置。
- 通过
ffa.warp.<name> 赋予玩家访问权限。
竞技场选项
每个竞技场都可以拥有自己的规则:
方块
方块交互可以设置为:
方块衰变
已放置的方块可以在以下时间后自动衰变:
- 5 秒
- 10 秒
- 30 秒
- 1 分钟
- 3 分钟
- 永不
地图再生
竞技场地图再生可以配置为:
爆炸
爆炸支持对以下情况进行单独处理:
物品掉落
可以为每个竞技场单独启用或禁用物品掉落。
战斗
处于战斗状态的玩家直到战斗计时器结束前无法使用竞技场传送。这防止了玩家在即将输掉战斗时简单地传送逃离。默认的战斗计时器为 30 秒。
配置
大多数插件消息和 GUI 设置都保存在 config.yml 中,包括:
- 启动/关闭消息
- 权限消息
- 战斗消息
- 传送消息
- 选择消息
- GUI 标题
- GUI 物品名称和描述
- 竞技场设置标签
限制
当前实现允许最多 45 个竞技场,因为我比较懒。未来可能会添加对更多竞技场的支持。
许可证
FFACore 根据 CC0 1.0 许可证发布。我们的插件 ☭
AI 使用情况
我让 LLM 根据项目文件等为我撰写了这份说明文档。我在力所能及的地方对其进行了清理,并尝试重新格式化使其看起来尽可能美观,同时添加了解释。如果你介意 AI 的使用,欢迎贡献代码。
FFACore
A Minecraft plugin for running Free For All arenas.
Players can pick an arena and fight without having to queue for a match. Arenas can be created and edited in-game, with options for block interaction, explosions, item drops, block decay and map regeneration.
Features
- Multiple FFA arenas
- Arena selection using a WorldEdit-style wand
- In-game arena creation and editing menus
- Per-arena spawn locations
- Arena warps with per-arena permissions
- Combat logging protection
- Optional block breaking and placing
- Block decay timers
- Map regeneration timers
- Explosion settings
- Item drop settings
- Persistent arena configuration
- MiniMessage-based messages and GUI text
Dependencies
Commands
/selection-wand
Gives you the arena selection tool.
Select two corners of the area you want to use for an arena.
/add-arena <name>
Creates a new arena from the current selection.
After creating it, FFACore opens the arena setup menu where you can configure things such as:
- Arena name
- Block breaking/placing
- Block decay
- Map regeneration
- Explosions
- Item drops
/arenas
Opens the arena management menu.
From there you can edit existing arenas, regenerate maps, teleport to an arena spawn, or delete an arena.
/warp <arena>
Teleports you to an arena.
Players need permission for the specific arena:
ffa.warp.<arena>
For example:
ffa.warp.desert
Warping is also blocked while the player is in combat.
Permissions
| Permission |
Description |
ffa.admin |
Access to arena administration commands |
ffa.warp.<arena> |
Access to a specific arena |
ffa.admin is an operator permission by default.
Arena setup
The setup process looks like this:
- Get the selection wand using the
/selection-wand command.
- Select the 2 points of the arena.
- Run
/add-arena <name>.
- Configure the arena in the GUI.
- Save it.
- Give players access with
ffa.warp.<name>.
Arena options
Each arena can have its own rules:
Blocks
Block interaction can be set to:
- None
- Place only
- Break only
- Both
Block decay
Placed blocks can automatically decay after:
- 5 seconds
- 10 seconds
- 30 seconds
- 1 minute
- 3 minutes
- Never
Map regeneration
Arena regeneration can be configured for:
- 30 minutes
- 1 hour
- 6 hours
- 1 day
- Never
Explosions
Explosions support separate handling for:
- No explosion effects
- Damage only
- Block breaking only
- Both
Item drops
Item drops can be enabled or disabled per arena.
Combat
Players in combat can't use arena warps until their combat timer has expired. This prevents players from simply teleporting away when they are about to lose a fight. The default combat timer is 30 seconds.
Configuration
Most plugin messages and GUI settings are kept in config.yml, including:
- Startup/shutdown messages
- Permission messages
- Combat messages
- Teleport messages
- Selection messages
- GUI titles
- GUI item names and lore
- Arena setting labels
Limits
The current implementation allows up to 45 arenas cuz' I'm lazy. May add support for more arenas in the future.
License
FFACore is released under the CC0 1.0 license. Our plugin ☭
AI Usage
I asked an LLM to write the readme for me based on the project files etc. I cleaned it up wherever I can, and tried to reformat it to look as nice as possible, added explanations. If AI usage bothers you, feel free to contribute.
评论 0
登录后参与评分
还没有评论,来抢沙发吧