FFAStreaks
一款适用于 Paper/Spigot 服务器的全面 Free-For-All (FFA) 插件,提供击杀连击追踪、击杀回血、套装管理以及传送系统。
功能特性
核心功能
- 击杀连击追踪:追踪玩家的击杀连击数,死亡时重置
- 最高连击记录:记录每位玩家历史最高的击杀连击数
- 击杀回血:玩家获得击杀时自动恢复生命值和饥饿度
- 连击奖励:在特定的连击里程碑配置奖励(广播提示、药水效果)
- 防刷保护:防止玩家反复击杀同一目标以刷取连击
- 无掉落:死亡时不掉落物品和经验值
- 世界白名单:可在特定世界中启用或禁用该插件
套装系统
- 创建、删除和管理套装
- 简单的
/kit <name> 命令供玩家使用
- 完整支持背包、盔甲和副手栏
- 管理员套装管理命令
传送系统
- 为 FFA 竞技场设置传送点
- 将套装与传送点关联(传送时自动发放)
- 传送时完全恢复生命值和饥饿度
- 简单的
/ffago go <type> 命令
PlaceholderAPI 集成
%ffastreaks_streak% - 当前击杀连击数
%ffastreaks_highest_streak% - 历史最高击杀连击数
%ffastreaks_kills% - 总击杀数
%ffastreaks_enabled% - 当前世界是否启用了 FFA
依赖要求
- Paper 1.21.x 或兼容版本
- Java 21
- PlaceholderAPI(可选,用于占位符)
安装步骤
- 从发布页面下载最新的 JAR 文件
- 将
FFAStreaks-1.0.0.jar 放入服务器的 plugins/ 文件夹中
- 启动或重启服务器
- 根据您的偏好配置
plugins/FFAStreaks/config.yml
- 通过执行
/ffastreaks reload 或重启服务器来重载
配置说明
config.yml
enabled_worlds:
enabled: true
worlds:
- world
- arena
heal_on_kill:
enabled: true
amount: 6.0 # 1.0 = 半颗心, 20.0 = 10颗心
anti_farm:
enabled: true
same_victim_cooldown_seconds: 20
messages:
prefix: "&d[FFA]&f "
disabled_world: "&cFFAStreaks is disabled in this world."
streak_self: "&aYour current streak: &e%streak%"
streak_other: "&a%player%'s streak: &e%streak%"
top_header: "&6Top killstreaks:"
rewards:
"3":
broadcast: "&e%killer% &fhas a &a3&f kill streak!"
effects:
- "SPEED 10 0"
"5":
broadcast: "&e%killer% &fhas a &a5&f kill streak!"
effects:
- "STRENGTH 8 0"
"10":
broadcast: "&e%killer% &fis on a &c10&f kill streak!"
effects:
- "RESISTANCE 10 0"
- "REGENERATION 4 1"
配置选项
enabled_worlds
enabled: 启用世界白名单(false = 所有世界)
worlds: FFA 功能生效的世界名称列表
heal_on_kill
enabled: 启用击杀时回血和进食
amount: 恢复的生命值数量(1.0 = 半颗心)
anti_farm
enabled: 启用防刷保护
same_victim_cooldown_seconds: 再次刷取同一目标的冷却时间(秒)
rewards
- 配置特定连击里程碑的奖励
- 格式:
"streak_number": { broadcast: "message", effects: ["EFFECT seconds amplifier"] }
- 效果格式:
"EFFECT_NAME seconds amplifier"(例如:"SPEED 10 0")
命令列表
玩家命令
/streak [top|player]
- 查看您当前的击杀连击数
/streak top - 查看前 10 名击杀连击排行榜
/streak <player> - 查看其他玩家的连击数
/kit <name>
- 获取指定名称的套装
- 示例:
/kit warrior
/ffakits list
/ffakits give <name>
- 为自己获取一个套装
- 示例:
/ffakits give warrior
/ffago go <type>
- 传送到指定的传送点
- 如果已配置,会自动发放关联的套装
- 完全恢复玩家的生命值和饥饿度
- 示例:
/ffago go spawn
/ffago list
管理员命令
/ffastreaks reload
- 重载插件配置
- 权限:
ffastreaks.admin
/ffakits create <name>
- 根据您当前背包内容创建一个套装
- 权限:
ffastreaks.admin
/ffakits delete <name>
- 删除一个套装
- 权限:
ffastreaks.admin
/ffakits give <name> [player]
- 给自己或其他玩家发放套装
- 权限:
ffastreaks.admin(给他人发放时需要此权限)
/ffago set <type>
- 在当前位置设置一个传送点
- 权限:
ffastreaks.admin
/ffago link <type> <kit>
- 将套装与传送点关联
- 权限:
ffastreaks.admin
权限节点
ffastreaks.kit
- 允许玩家使用
/kit 或 /ffakits give 获取套装
- 默认:
true(所有玩家)
ffastreaks.go
- 允许玩家使用
/ffago go 和 /ffago list
- 默认:
true(所有玩家)
ffastreaks.admin
- 拥有所有 FFA 命令的完整管理员权限
- 默认:
op(仅限管理员)
使用示例
设置 FFA 竞技场
-
创建一个套装:
/ffakits create warrior
-
设置出生点:
/ffago set spawn
-
将套装与出生点关联:
/ffago link spawn warrior
-
玩家现在可以使用以下命令:
/ffago go spawn
这将传送他们,发放 warrior 套装,并完全恢复生命值和饥饿度。
创建连击奖励
编辑 config.yml 以在特定连击数添加奖励:
rewards:
"5":
broadcast: "&e%killer% &fhas a &a5&f kill streak!"
effects:
- "STRENGTH 8 0"
- "SPEED 10 0"
%killer% 占位符会自动替换为玩家的名字。
PlaceholderAPI
如果安装了 PlaceholderAPI,则可以使用以下占位符:
%ffastreaks_streak% - 当前击杀连击数
%ffastreaks_highest_streak% - 历史最高击杀连击数
%ffastreaks_kills% - 总击杀数
%ffastreaks_enabled% - 当前世界是否启用了 FFA(true/false)
计分板中的使用示例
&eKill Streak: &f%ffastreaks_streak%
&eBest Streak: &f%ffastreaks_highest_streak%
&eTotal Kills: &f%ffastreaks_kills%
工作原理
玩家死亡时
- 保留物品栏(不掉落物品)
- 保留经验等级(不掉落经验球)
- 连杀数重置为 0
- 若被玩家击杀:
- 击杀者的连杀数增加
- 击杀者恢复生命和饥饿值(如果已启用)
- 应用连杀奖励(如果已配置)
- 检查防刷机制
击杀时
- 生命值恢复至配置数值
- 饥饿值设为 20
- 饱和度设为 20.0
- 疲劳度重置为 0
- 击杀计数增加
- 连杀数增加
- 若为新纪录,则更新最高连杀数
防刷系统
- 记录每个“击杀者-受害者”对的最后一次击杀时间
- 如果在冷却时间内重复击杀同一受害者,则阻止发放奖励
- 冷却时间可按秒配置
文件结构
plugins/FFAStreaks/
├── config.yml # 主配置文件
└── kits.yml # 套装和传送存储(自动生成)
故障排除
插件在世界中无法正常工作:
- 检查
config.yml 中的 enabled_worlds
- 确保世界名称完全匹配(区分大小写)
存档未保存:
- 检查
plugins/FFAStreaks/ 目录下的文件权限
- 确保服务器具有写入权限
占位符无效:
- 安装 PlaceholderAPI 插件
- 在 FFAStreaks 安装完成后执行
/papi reload
- 检查占位符语法:
%ffastreaks_streak%
命令无效:
- 使用
/lp user <player> permission info 检查权限
- 玩家的默认权限应为
true
- 管理员命令需要
ffastreaks.admin 权限
API
公共方法
// 获取当前连杀数
int getStreak(UUID uuid)
// 获取总击杀数
int getKills(UUID uuid)
// 获取历史最高连杀数
int getHighestStreak(UUID uuid)
// 检查世界内是否启用
boolean isEnabledInWorld(World world)
版本
当前版本:1.0.0
支持
如需报告问题、提交功能请求或咨询疑问,请在项目仓库中创建 Issue。
许可
本插件按“原样”提供,供 Minecraft 服务器使用。
鸣谢
专为 Paper 1.21.x 服务器开发,支持 PlaceholderAPI 集成。
FFAStreaks
A comprehensive Free-For-All (FFA) plugin for Paper/Spigot servers that adds killstreak tracking, healing on kill, kit management, and teleport systems.
Features
Core Features
- Killstreak Tracking: Tracks player killstreaks and resets on death
- Highest Streak: Records each player's best killstreak ever
- Heal on Kill: Automatically heals and feeds players when they get a kill
- Streak Rewards: Configurable rewards (broadcasts, potion effects) at specific streak milestones
- Anti-Farm Protection: Prevents players from farming the same victim repeatedly
- No Drops: Prevents inventory and XP drops on death
- World Whitelist: Enable/disable the plugin in specific worlds
Kit System
- Create, delete, and manage kits
- Simple
/kit <name> command for players
- Full inventory, armor, and offhand support
- Admin kit management commands
Teleport System
- Set teleport points for FFA arenas
- Link kits to teleport points (auto-given on teleport)
- Full heal and feed on teleport
- Simple
/ffago go <type> command
PlaceholderAPI Integration
%ffastreaks_streak% - Current killstreak
%ffastreaks_highest_streak% - Best killstreak ever
%ffastreaks_kills% - Total kills
%ffastreaks_enabled% - Whether FFA is enabled in current world
Requirements
- Paper 1.21.x or compatible
- Java 21
- PlaceholderAPI (optional, for placeholders)
Installation
- Download the latest JAR from the releases page
- Place
FFAStreaks-1.0.0.jar in your server's plugins/ folder
- Start or restart your server
- Configure
plugins/FFAStreaks/config.yml to your preferences
- Reload with
/ffastreaks reload or restart the server
Configuration
config.yml
enabled_worlds:
enabled: true
worlds:
- world
- arena
heal_on_kill:
enabled: true
amount: 6.0 # 1.0 = half-heart, 20.0 = 10 hearts
anti_farm:
enabled: true
same_victim_cooldown_seconds: 20
messages:
prefix: "&d[FFA]&f "
disabled_world: "&cFFAStreaks is disabled in this world."
streak_self: "&aYour current streak: &e%streak%"
streak_other: "&a%player%'s streak: &e%streak%"
top_header: "&6Top killstreaks:"
rewards:
"3":
broadcast: "&e%killer% &fhas a &a3&f kill streak!"
effects:
- "SPEED 10 0"
"5":
broadcast: "&e%killer% &fhas a &a5&f kill streak!"
effects:
- "STRENGTH 8 0"
"10":
broadcast: "&e%killer% &fis on a &c10&f kill streak!"
effects:
- "RESISTANCE 10 0"
- "REGENERATION 4 1"
Configuration Options
enabled_worlds
enabled: Enable world whitelist (false = all worlds)
worlds: List of world names where FFA features are active
heal_on_kill
enabled: Enable healing and feeding on kill
amount: Health amount to restore (1.0 = half heart)
anti_farm
enabled: Enable anti-farm protection
same_victim_cooldown_seconds: Cooldown before same victim can be farmed again
rewards
- Configure rewards at specific streak milestones
- Format:
"streak_number": { broadcast: "message", effects: ["EFFECT seconds amplifier"] }
- Effects format:
"EFFECT_NAME seconds amplifier" (e.g., "SPEED 10 0")
Commands
Player Commands
/streak [top|player]
- View your current killstreak
/streak top - View top 10 killstreaks
/streak <player> - View another player's streak
/kit <name>
- Get a kit by name
- Example:
/kit warrior
/ffakits list
/ffakits give <name>
- Get a kit for yourself
- Example:
/ffakits give warrior
/ffago go <type>
- Teleport to a teleport point
- Automatically gives linked kit if configured
- Fully heals and feeds player
- Example:
/ffago go spawn
/ffago list
- List all available teleport points
Admin Commands
/ffastreaks reload
- Reload the plugin configuration
- Permission:
ffastreaks.admin
/ffakits create <name>
- Create a kit from your current inventory
- Permission:
ffastreaks.admin
/ffakits delete <name>
- Delete a kit
- Permission:
ffastreaks.admin
/ffakits give <name> [player]
- Give a kit to yourself or another player
- Permission:
ffastreaks.admin (to give to others)
/ffago set <type>
- Set a teleport point at your current location
- Permission:
ffastreaks.admin
/ffago link <type> <kit>
- Link a kit to a teleport point
- Permission:
ffastreaks.admin
Permissions
ffastreaks.kit
- Allows players to get kits using
/kit or /ffakits give
- Default:
true (all players)
ffastreaks.go
- Allows players to use
/ffago go and /ffago list
- Default:
true (all players)
ffastreaks.admin
- Full admin access to all FFA commands
- Default:
op (operators only)
Usage Examples
Setting Up an FFA Arena
-
Create a kit:
/ffakits create warrior
-
Set a spawn point:
/ffago set spawn
-
Link the kit to spawn:
/ffago link spawn warrior
-
Players can now use:
/ffago go spawn
This will teleport them, give them the warrior kit, and fully heal/feed them.
Creating Streak Rewards
Edit config.yml to add rewards at specific streaks:
rewards:
"5":
broadcast: "&e%killer% &fhas a &a5&f kill streak!"
effects:
- "STRENGTH 8 0"
- "SPEED 10 0"
The %killer% placeholder is automatically replaced with the player's name.
PlaceholderAPI
If PlaceholderAPI is installed, the following placeholders are available:
%ffastreaks_streak% - Current killstreak
%ffastreaks_highest_streak% - Highest killstreak ever achieved
%ffastreaks_kills% - Total kills
%ffastreaks_enabled% - Whether FFA is enabled in current world (true/false)
Example Usage in Scoreboards
&eKill Streak: &f%ffastreaks_streak%
&eBest Streak: &f%ffastreaks_highest_streak%
&eTotal Kills: &f%ffastreaks_kills%
How It Works
On Player Death
- Inventory is kept (no drops)
- XP level is kept (no XP drops)
- Killstreak is reset to 0
- If killed by a player:
- Killer's streak increments
- Killer is healed and fed (if enabled)
- Streak rewards are applied (if configured)
- Anti-farm protection is checked
On Kill
- Health restored by configured amount
- Food level set to 20
- Saturation set to 20.0
- Exhaustion reset to 0
- Kill count increments
- Streak increments
- Highest streak updated if new record
Anti-Farm System
- Tracks last kill time for each killer-victim pair
- Prevents rewards if same victim is killed within cooldown period
- Configurable cooldown in seconds
File Structure
plugins/FFAStreaks/
├── config.yml # Main configuration
└── kits.yml # Kit and teleport storage (auto-generated)
Troubleshooting
Plugin not working in a world:
- Check
enabled_worlds in config.yml
- Ensure world name matches exactly (case-sensitive)
Kits not saving:
- Check file permissions in
plugins/FFAStreaks/
- Ensure server has write access
Placeholders not working:
- Install PlaceholderAPI plugin
- Use
/papi reload after installing FFAStreaks
- Check placeholder syntax:
%ffastreaks_streak%
Commands not working:
- Check permissions with
/lp user <player> permission info
- Default permissions should be
true for players
- Admin commands require
ffastreaks.admin permission
API
Public Methods
// Get current streak
int getStreak(UUID uuid)
// Get total kills
int getKills(UUID uuid)
// Get highest streak ever
int getHighestStreak(UUID uuid)
// Check if enabled in world
boolean isEnabledInWorld(World world)
Version
Current Version: 1.0.0
Support
For issues, feature requests, or questions, please open an issue on the project repository.
License
This plugin is provided as-is for use on Minecraft servers.
Credits
Developed for Paper 1.21.x servers with support for PlaceholderAPI integration.
评论 0
登录后参与评分
还没有评论,来抢沙发吧