ServerWar

插件

· 作者 Zavoin

适用于 Paper 1.21.x 的竞技性游戏内 PvP 战争系统,包含金库金钱赌注、托管资金、目标、队伍和排行榜。

0 本站下载 0 关注 更新于 2 个月前

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

ServerWar

适用于 Paper 1.21.x 服务器的生产级竞技性游戏内 PvP 战争系统。

ServerWar 允许玩家通过游戏内 Vault 货币进行带有赌注的战争挑战,提供安全的奖金托管、基于击杀的计分、目标任务、排行榜、团队战争、统计数据以及完整的管理员控制功能。

重要提示:ServerWar 仅使用服务器现有的游戏内 Minecraft 经济系统(Vault)。它绝不涉及真实货币、加密货币或任何支付行为。所有赌注和奖励严格限定在游戏内 Vault 货币范围内。

功能特性

  • 1v1 战争 — /war challenge Ahmed 500000
  • 团队对战团队战争 — /war team challenge Blue 500000
  • 通过 Vault 进行游戏内货币赌注(使用 BigDecimal,避免浮点数误差)
  • 安全的奖金托管,具备幂等性及交易 ID 保护的 payouts
  • 防刷杀机制(冷却时间、递减回报、队友伤害及自杀/虚空掉落保护)
  • 战斗登出检测
  • 目标任务(击杀玩家、挖掘方块、击杀生物、获取物品、弓箭/剑击杀)
  • 战争统计与排行榜
  • 战争历史记录
  • 可配置的 GUI 管理界面
  • SQLite(默认)和 MySQL/MariaDB 支持,配备 HikariCP 连接池
  • PlaceholderAPI 扩展支持
  • 管理员控制,支持细粒度权限配置
  • 服务器重启恢复 — 绝不会重置进行中的战争

依赖要求

  • Paper 1.21.x(或兼容分支)
  • Java 21
  • Vault + 一个经济插件(如 EssentialsX、CMI 等)
  • PlaceholderAPI(可选)

安装步骤

  1. 将 ServerWar.jar 放入服务器的 plugins/ 文件夹中。
  2. 启动服务器。插件会自动创建 plugins/ServerWar/config.yml、messages.yml,以及(针对 SQLite)serverwar.db。
  3. 安装 Vault 和 经济插件 以使货币功能正常工作。
  4. (可选)安装 PlaceholderAPI。
  5. 重启服务器(或运行 /waradmin reload)。

命令

玩家命令:/war、/war challenge <player> <stake>、/war accept <player>、/war decline <player>、/war surrender [confirm]、/war stats [player]、/war history、/war top、/war team ...

管理员命令:/waradmin reload、stats、wars、war <id>、cancel <id>、force-start <id>、force-end <id>、refund <id>、sponsor <id> <amount>、reset-stats <player>、blacklist <player>、unblacklist <player>

数据库

默认情况下,ServerWar 使用 SQLite,无需额外设置。如需使用 MySQL/MariaDB,请编辑 config.yml。所有货币值均使用 BigDecimal 存储,在 SQLite 中以 TEXT 格式存储,在 MySQL 中以 DECIMAL(20,2) 格式存储。如果启动时无法连接到 MySQL,ServerWar 将自动回退到 SQLite。

PlaceholderAPI

%serverwar_active_wars%、%serverwar_player_wins%、%serverwar_player_losses%、%serverwar_player_kills%、%serverwar_player_deaths%、%serverwar_player_points%、%serverwar_player_winrate%、%serverwar_player_streak%、%serverwar_player_winnings%、%serverwar_top_player%、%serverwar_top_player_<rank>%、%serverwar_top_player_<category>_<rank>%

重启恢复

启动时:处于 ACTIVE/STARTING/PAUSED 状态的战争会被完全恢复(包括分数、目标、参与者、剩余持续时间)。未接受的 PENDING 挑战将被退款并取消——资金绝不会丢失。奖励和退款操作具有幂等性,因此即使在 payout 过程中发生崩溃,也绝不会出现重复支付的情况。

许可证

MIT

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源