Minecraft 中最先进的防战斗挂机插件。拥有美观的 BossBar 计时器、物品冷却时间、命令拦截,以及为您的服务器 PvP 体验提供的完全自定义选项。
⚔️ 关于 OutCombatLog
OutCombatLog 不仅仅是一个普通的战斗挂机检测插件——它是为您的 Minecraft 服务器打造的完整战斗挂机防护系统。与仅仅惩罚玩家的普通插件不同,OutCombatLog 提供专业级的体验,包括精美的 BossBar 计时器、震撼的视觉反馈以及无与伦比的自定义选项。
无论您是运行小型朋友间的 PvP 服务器,还是拥有数百名玩家的大型阵营网络,OutCombatLog 都能通过其灵活的配置系统、物品冷却时间和全面的战斗保护功能来满足您的需求。
✨ 功能展示
⚔️ 核心 PvP 功能
| 功能 |
描述 |
| PvP 计时器 |
可配置的持续时间(默认:30 秒),每次受到攻击时重置 |
| BossBar 显示 |
顶部显示精美的 BossBar,包含实时计时器和自定义文本 |
| 击杀后战斗状态 |
可配置 - 击杀者在被击杀后仍保持在 PvP 状态,以防止立即下线 |
| 下线惩罚 |
在 PvP 期间下线的玩家将被杀死,掉落物品如同正常死亡一样 |
| 上线通知 |
如果玩家在 PvP 期间离开,上线时会收到通知 |
?️ 防护与安全
| 功能 |
描述 |
| 命令拦截 |
在 PvP 期间阻止所有命令,仅允许特定命令(如 msg, tell, help 等) |
| 末影箱锁定 |
防止玩家在战斗中打开末影箱 |
| 下线广播 |
当有人战斗挂机时,向指定半径内的玩家发出警报(可配置) |
| 物品冷却 |
仅在 PvP 期间对特定物品设置自定义冷却时间 |
⏱️ 物品冷却(示例)
| 物品 |
默认冷却时间 |
| ENDER_PEARL |
15 秒 |
| ENCHANTED_GOLDEN_APPLE |
60 秒 |
| GOLDEN_APPLE |
30 秒 |
| CHORUS_FRUIT |
10 秒 |
| FIREWORK_ROCKET |
10 秒 |
| ENDER_CHEST |
30 秒 |
注意: 所有冷却时间均可完全自定义,且仅在 PvP 模式下生效!
? 音频与视觉效果
| 功能 |
描述 |
| 战斗开始音效 |
进入 PvP 时可配置的音效 |
| 战斗倒计时音效 |
PvP 结束前 3 秒的滴答声 |
| 战斗结束音效 |
PvP 计时器结束时播放的胜利音效 |
| BossBar 自定义 |
支持全 RGB 颜色、自定义文本和计时器显示 |
| BossBar 样式 |
多种样式可选:PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20 |
? 管理员功能
| 功能 |
描述 |
| 配置重载 |
/ocl reload - 无需重启即可重新加载配置 |
| 物品列表 |
/ocl list - 查看所有带有冷却时间的物品 |
| 战斗状态 |
/ocl check - 检查当前 PvP 状态 |
| 插件信息 |
/ocl info - 查看插件信息和统计数据 |
| 更新检查器 |
有新版本可用时自动通知 |
? 安装指南
| 步骤 |
操作 |
| 1️⃣ |
下载 — 从 Modrinth 获取最新的 .jar 文件 |
| 2️⃣ |
安装 — 将 JAR 文件放入服务器的 plugins/ 文件夹中 |
| 3️⃣ |
重启 — 重启您的服务器(或者如果您必须的话,使用 /reload) |
| 4️⃣ |
配置 — 根据需要编辑 plugins/OutCombatLog/config.yml |
| 5️⃣ |
享受! — 玩家现在已受到防战斗挂机的保护 |
⚠️ 重要提示: 强烈建议进行完整的服务器重启,而不是使用 /reload,以获得最佳性能并避免任何插件冲突。
? bStats 指标
OutCombatLog 使用 bStats 收集匿名使用统计数据。这有助于我们基于真实的使用数据改进插件。以下是 OutCombatLog 的实时统计图表:
? 命令与权限
? 玩家命令
| 命令 |
描述 |
权限 |
默认值 |
/ocl |
插件主命令 |
outcombatlog.use |
✅ 所有玩家 |
/ocl list |
列出所有带有冷却时间的物品 |
outcombatlog.use |
✅ 所有玩家 |
/ocl check |
检查当前 PvP 状态 |
outcombatlog.use |
✅ 所有玩家 |
/outcombatlog |
主命令的别名 |
outcombatlog.use |
✅ 所有玩家 |
/combatlog |
主命令的别名 |
outcombatlog.use |
✅ 所有玩家 |
/cl |
主命令的别名 |
outcombatlog.use |
✅ 所有玩家 |
/pvp |
主命令的别名 |
outcombatlog.use |
✅ 所有玩家 |
? 管理员命令
| 命令 |
描述 |
权限 |
默认值 |
/ocl reload |
重新加载插件配置 |
outcombatlog.admin |
❌ 仅限 OP |
/ocl info |
查看详细的插件信息 |
outcombatlog.admin |
❌ 仅限 OP |
? 权限说明
| 权限 |
描述 |
默认值 |
outcombatlog.use |
使用基本插件命令 |
✅ 所有玩家 |
outcombatlog.admin |
管理员命令(重载、信息) |
❌ 仅限 OP |
outcombatlog.bypass |
绕过所有战斗限制 |
❌ 仅限 OP |
⚙️ 配置深入解析
? 核心配置
prefix: "&f[&x&E&5&4&1&E&7ᴄ&x&D&B&3&9&D&Eᴏ&x&D&1&3&1&D&5ᴍ&x&C&7&2&9&C&Cʙ&x&B&D&2&1&C&3ᴀ&x&B&3&1&8&B&Aᴛ&x&A&9&1&0&B&1ʟ&x&9&F&0&8&A&8ᴏ&x&9&5&0&0&9&Fɢ&f]"
# PvP 标签持续时间(秒)
pvp-time: 30
# PvP 中的死亡模式
# true: 受害者退出 PvP,但击杀者仍留在 PvP 中
# false: 两名玩家都退出 PvP
combat-on-death: true
# 登出广播半径(以方块为单位)
# 0 = 禁用广播
logout-broadcast-radius: 25
# 在 PvP 期间允许使用的命令
allowed-commands:
- msg
- tell
- w
- r
- reply
- whisper
- report
- help
- discord
- donate
- sites
- combatlog
- outcombatlog
- ocl
- pvp
# 所有材料列表:https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
item-cooldowns:
ENDER_PEARL: 15
ENCHANTED_GOLDEN_APPLE: 60
GOLDEN_APPLE: 30
CHORUS_FRUIT: 10
FIREWORK_ROCKET: 10
ENDER_CHEST: 30
bossbar:
# 启用/禁用 Boss 栏
enabled: true
# Boss 栏颜色
# 可用颜色:BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
color: "RED"
# Boss 栏样式
# 可用样式:
# • PROGRESS - 实心条
# • NOTCHED_6 - 分为 6 部分
# • NOTCHED_10 - 分为 10 部分
# • NOTCHED_12 - 分为 12 部分
# • NOTCHED_20 - 分为 20 部分
overlay: "PROGRESS"
text: "&5⚔ &x&E&5&4&1&E&7ᴄ&x&D&B&3&9&D&Eᴏ&x&D&1&3&1&D&5ᴍ&x&C&7&2&9&C&Cʙ&x&B&D&2&1&C&3ᴀ&x&B&3&1&8&B&Aᴛ&x&A&9&1&0&B&1ʟ&x&9&F&0&8&A&8ᴏ&x&9&5&0&0&9&Fɢ &5⚔"
# 在文本中显示剩余时间
# true - %seconds% 将被替换为数字 (15, 5)
# false - %seconds% 将被移除或保持原样
show-time: true
sounds:
# 启用/禁用所有声音
enabled: true
# 进入 PvP 时的声音
combat-start: "BLOCK_BELL_USE"
# PvP 结束前的滴答声
combat-tick: "BLOCK_NOTE_BLOCK_HAT"
# PvP 结束时的声音
combat-end: "ENTITY_PLAYER_LEVELUP"
messages-enabled:
logout-punishment: true
logout-return-message: true
command-blocked: true
combat-status: true
not-in-combat: true
config-reloaded: true
no-permission: true
enderchest-blocked: true
combat-ended: true
item-cooldown: true
plugin-info: true
cooldowns-list: true
messages:
# 当玩家在 PvP 期间登出时
logout-punishment: "&e%player% &c在 PvP 期间离开了服务器!"
# 在受到登出惩罚后返回时
logout-return-message: "&c你在 PvP 期间离开并被自动击杀..."
# 在 PvP 期间命令被阻止
command-blocked: "&c❌ 在战斗中无法使用命令!"
# 战斗状态检查
combat-status: "&6⚔ PvP 状态:\n &7└ 剩余时间: &e%time% 秒\n &7└ 对手: &c%opponent%"
# 不在战斗中
not-in-combat: "&a✓ 你未处于 PvP 模式"
# 配置已重载
config-reloaded: "&a✓ 配置已重载"
# 无权限
no-permission: "&c没有权限"
# 末影箱被阻止
enderchest-blocked: "&c❌ 在战斗中无法打开末影箱!"
# 战斗结束
combat-ended: "&a✓ PvP 模式已结束"
# 物品处于冷却中
item-cooldown: "&c❌ 物品处于冷却中: &e%.1f 秒"
# 插件信息
plugin-info: "&f插件信息:\n&7└ &f版本: &e2.3\n&7└ &f作者: &evissed studio\n&7└ &fPvP 时间: &e%pvptime% 秒\n&7└ &f死亡模式: &e%deathmode%\n&7└ &f物品: &e%itemscount%"
# 冷却列表标题
cooldowns-list: "&f带有冷却时间的物品:\n%items%"
# 冷却物品格式
cooldowns-item-format: "&7└ &f%material%: &e%cooldown% 秒"
check-updates: true
The most advanced combat logging prevention plugin for Minecraft. Beautiful BossBar timers, item cooldowns, command blocking, and complete customization for your server's PvP experience.
⚔️ About OutCombatLog
OutCombatLog is not just another combat logger — it's a complete combat logging prevention system for your Minecraft server. Unlike standard plugins that simply punish players, OutCombatLog delivers a professional experience with beautiful BossBar timers, stunning visual feedback, and unparalleled customization options.
Whether you're running a small PvP server with friends or a large factions network with hundreds of players, OutCombatLog adapts to your needs with its flexible configuration system, item cooldowns, and comprehensive combat protection.
✨ Feature Showcase
⚔️ Core PvP Features
| Feature |
Description |
| PvP Timer |
Configurable duration (default: 30 seconds) that resets with each hit |
| BossBar Display |
Beautiful BossBar on top with real-time timer and custom text |
| Combat on Death |
Configurable - killer remains in PvP after kill to prevent instant logout |
| Logout Punishment |
Players who log out during PvP are killed with item drops like normal death |
| Login Notification |
Players are notified when they log in if they left during PvP |
?️ Protection & Safety
| Feature |
Description |
| Command Blocking |
Block all commands during PvP except allowed ones (msg, tell, help, etc.) |
| Ender Chest Block |
Prevent players from opening Ender Chests during combat |
| Logout Broadcast |
Alert players in radius (configurable) when someone combat logs |
| Item Cooldowns |
Custom cooldowns for specific items during PvP only |
⏱️ Item Cooldowns (EXAMPLE)
| Item |
Default Cooldown |
| ENDER_PEARL |
15 seconds |
| ENCHANTED_GOLDEN_APPLE |
60 seconds |
| GOLDEN_APPLE |
30 seconds |
| CHORUS_FRUIT |
10 seconds |
| FIREWORK_ROCKET |
10 seconds |
| ENDER_CHEST |
30 seconds |
Note: All cooldowns are fully configurable and only apply during PvP mode!
? Audio & Visual
| Feature |
Description |
| Combat Start Sound |
Configurable sound when entering PvP |
| Combat Tick Sound |
Ticking sound 3 seconds before PvP ends |
| Combat End Sound |
Victory sound when PvP timer expires |
| BossBar Customization |
Full RGB color support, custom text, and timer display |
| BossBar Styles |
Multiple styles: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20 |
? Admin Features
| Feature |
Description |
| Config Reload |
/ocl reload - Reload configuration without restart |
| Item List |
/ocl list - View all items with cooldowns |
| Combat Status |
/ocl check - Check current PvP status |
| Plugin Info |
/ocl info - View plugin information and statistics |
| Update Checker |
Automatic notification when new version is available |
? Installation Guide
| Step |
Action |
| 1️⃣ |
Download — Get the latest .jar from Modrinth |
| 2️⃣ |
Install — Place the JAR into your server's plugins/ folder |
| 3️⃣ |
Restart — Restart your server (or use /reload if you must) |
| 4️⃣ |
Configure — Edit plugins/OutCombatLog/config.yml to your liking |
| 5️⃣ |
Enjoy! — Players are now protected from combat loggers |
⚠️ Important: A full server restart is strongly recommended over /reload for optimal performance and to avoid any plugin conflicts.
? bStats Metrics
OutCombatLog uses bStats to collect anonymous usage statistics. This helps us improve the plugin based on real usage data. Below is the live statistics chart for OutCombatLog:
? Commands & Permissions
? Player Commands
| Command |
Description |
Permission |
Default |
/ocl |
Main plugin command |
outcombatlog.use |
✅ All players |
/ocl list |
List all items with cooldowns |
outcombatlog.use |
✅ All players |
/ocl check |
Check current PvP status |
outcombatlog.use |
✅ All players |
/outcombatlog |
Alias for main command |
outcombatlog.use |
✅ All players |
/combatlog |
Alias for main command |
outcombatlog.use |
✅ All players |
/cl |
Alias for main command |
outcombatlog.use |
✅ All players |
/pvp |
Alias for main command |
outcombatlog.use |
✅ All players |
? Admin Commands
| Command |
Description |
Permission |
Default |
/ocl reload |
Reload plugin configuration |
outcombatlog.admin |
❌ Ops only |
/ocl info |
View detailed plugin information |
outcombatlog.admin |
❌ Ops only |
? Permissions
| Permission |
Description |
Default |
outcombatlog.use |
Use basic plugin commands |
✅ All players |
outcombatlog.admin |
Admin commands (reload, info) |
❌ Ops only |
outcombatlog.bypass |
Bypass all combat restrictions |
❌ Ops only |
⚙️ Configuration Deep Dive
? Core Configuration
prefix: "&f[&x&E&5&4&1&E&7ᴄ&x&D&B&3&9&D&Eᴏ&x&D&1&3&1&D&5ᴍ&x&C&7&2&9&C&Cʙ&x&B&D&2&1&C&3ᴀ&x&B&3&1&8&B&Aᴛ&x&A&9&1&0&B&1ʟ&x&9&F&0&8&A&8ᴏ&x&9&5&0&0&9&Fɢ&f]"
# PvP tag duration (in seconds)
pvp-time: 30
# Death mode in PvP
# true: Victim exits PvP, BUT killer remains in PvP
# false: Both players exit PvP
combat-on-death: true
# Logout broadcast radius (in blocks)
# 0 = disable broadcasting
logout-broadcast-radius: 25
# Commands allowed during PvP
allowed-commands:
- msg
- tell
- w
- r
- reply
- whisper
- report
- help
- discord
- donate
- sites
- combatlog
- outcombatlog
- ocl
- pvp
# List of all materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
item-cooldowns:
ENDER_PEARL: 15
ENCHANTED_GOLDEN_APPLE: 60
GOLDEN_APPLE: 30
CHORUS_FRUIT: 10
FIREWORK_ROCKET: 10
ENDER_CHEST: 30
bossbar:
# Enable/disable bossbar
enabled: true
# Bossbar color
# Available colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
color: "RED"
# Bossbar style
# Available styles:
# • PROGRESS - solid bar
# • NOTCHED_6 - divided into 6 parts
# • NOTCHED_10 - divided into 10 parts
# • NOTCHED_12 - divided into 12 parts
# • NOTCHED_20 - divided into 20 parts
overlay: "PROGRESS"
text: "&5⚔ &x&E&5&4&1&E&7ᴄ&x&D&B&3&9&D&Eᴏ&x&D&1&3&1&D&5ᴍ&x&C&7&2&9&C&Cʙ&x&B&D&2&1&C&3ᴀ&x&B&3&1&8&B&Aᴛ&x&A&9&1&0&B&1ʟ&x&9&F&0&8&A&8ᴏ&x&9&5&0&0&9&Fɢ &5⚔"
# Show remaining time in text
# true - %seconds% will be replaced with the number (15, 5)
# false - %seconds% will be removed or left as is
show-time: true
sounds:
# Enable/disable all sounds
enabled: true
# Sound when entering PvP
combat-start: "BLOCK_BELL_USE"
# Ticking sound before PvP ends
combat-tick: "BLOCK_NOTE_BLOCK_HAT"
# Sound when PvP ends
combat-end: "ENTITY_PLAYER_LEVELUP"
messages-enabled:
logout-punishment: true
logout-return-message: true
command-blocked: true
combat-status: true
not-in-combat: true
config-reloaded: true
no-permission: true
enderchest-blocked: true
combat-ended: true
item-cooldown: true
plugin-info: true
cooldowns-list: true
messages:
# When player logs out during PvP
logout-punishment: "&e%player% &cʟᴇꜰᴛ ᴛʜᴇ ꜱᴇʀᴠᴇʀ ᴅᴜʀɪɴɢ ᴘᴠᴘ!"
# When returning after logout punishment
logout-return-message: "&cʏᴏᴜ ʟᴇꜰᴛ ᴅᴜʀɪɴɢ ᴘᴠᴘ ᴀɴᴅ ᴡᴇʀᴇ ᴀᴜᴛᴏᴍᴀᴛɪᴄᴀʟʟʏ ᴋɪʟʟᴇᴅ..."
# Command blocked during PvP
command-blocked: "&c❌ ᴄᴀɴɴᴏᴛ ᴜꜱᴇ ᴄᴏᴍᴍᴀɴᴅꜱ ᴅᴜʀɪɴɢ ᴄᴏᴍʙᴀᴛ!"
# Combat status check
combat-status: "&6⚔ ᴘᴠᴘ ꜱᴛᴀᴛᴜꜱ:\n &7└ ᴛɪᴍᴇ ʟᴇꜰᴛ: &e%time% ꜱᴇᴄ\n &7└ ᴏᴘᴘᴏɴᴇɴᴛ: &c%opponent%"
# Not in combat
not-in-combat: "&a✓ ʏᴏᴜ ᴀʀᴇ ɴᴏᴛ ɪɴ ᴘᴠᴘ ᴍᴏᴅᴇ"
# Config reloaded
config-reloaded: "&a✓ ᴄᴏɴꜰɪɢᴜʀᴀᴛɪᴏɴ ʀᴇʟᴏᴀᴅᴇᴅ"
# No permission
no-permission: "&cɴᴏ ᴘᴇʀᴍɪꜱꜱɪᴏɴ"
# Ender chest blocked
enderchest-blocked: "&c❌ ᴄᴀɴɴᴏᴛ ᴏᴘᴇɴ ᴇɴᴅᴇʀ ᴄʜᴇꜱᴛ ᴅᴜʀɪɴɢ ᴄᴏᴍʙᴀᴛ!"
# Combat ended
combat-ended: "&a✓ ᴘᴠᴘ ᴍᴏᴅᴇ ᴇɴᴅᴇᴅ"
# Item on cooldown
item-cooldown: "&c❌ ɪᴛᴇᴍ ᴏɴ ᴄᴏᴏʟᴅᴏᴡɴ: &e%.1f &cꜱᴇᴄ"
# Plugin info
plugin-info: "&fᴘʟᴜɢɪɴ ɪɴꜰᴏ:\n&7└ &fᴠᴇʀꜱɪᴏɴ: &e2.3\n&7└ &fᴀᴜᴛʜᴏʀ: &evɪꜱꜱᴇᴅ ꜱᴛᴜᴅɪᴏ\n&7└ &fᴘᴠᴘ ᴛɪᴍᴇ: &e%pvptime% ꜱᴇᴄ\n&7└ &fᴅᴇᴀᴛʜ ᴍᴏᴅᴇ: &e%deathmode%\n&7└ &fɪᴛᴇᴍꜱ: &e%itemscount%"
# Cooldowns list header
cooldowns-list: "&fɪᴛᴇᴍꜱ ᴡɪᴛʜ ᴄᴏᴏʟᴅᴏᴡɴꜱ:\n%items%"
# Cooldown item format
cooldowns-item-format: "&7└ &f%material%: &e%cooldown% ꜱᴇᴄ"
check-updates: true
评论 0
登录后参与评分
还没有评论,来抢沙发吧