PillarOfFortune
一款适用于 Minecraft 1.21+ 的竞技生存游戏插件,玩家将在高耸的基岩柱上进行战斗。
功能特性
- 多种游戏模式:支持单人、双人、三人及小队玩法
- 动态世界生成:平坦的世界中矗立着高耸的基岩柱
- 组队系统:创建队伍并与好友一起游玩
- 可自定义记分板:显示玩家统计数据和服务端信息
- NPC 集成:使用 Citizens NPC 方便加入游戏
- 随机物品分发:游戏过程中每 10 秒向所有玩家发放随机物品
- 旁观者模式:被淘汰后可以观看比赛进程
- 胜负追踪:包含玩家统计数据和升级系统
- 可配置设置:所有设置均可通过 config.yml 进行自定义
命令
主要命令
/pof setlobby - 设置大厅位置(管理员)
/pof lobby - 传送至大厅
/pof reload - 重载配置(管理员)
/pof join <Solo/Duo/Trio/Squad> - 加入某种游戏模式
组队命令
/pof party create - 创建队伍
/pof party disband - 解散你的队伍(仅限队长)
/pof party invite <player> - 邀请玩家加入你的队伍
/pof party accept - 接受组队邀请
/pof party decline - 拒绝组队邀请
/pof party leave - 离开当前队伍
/pof party kick <player> - 踢出队伍中的玩家(仅限队长)
/pof party list - 列出所有队员
NPC 命令
/pof npc add <solo/duo/trio/squad> - 为特定游戏模式创建 NPC(管理员)
/pof npc remove - 移除最近的 PillarOfFortune NPC(管理员)
权限
pillaroffurtune.* - 所有权限(默认:OP)
pillaroffurtune.use - 基本插件使用权限(默认:true)
pillaroffurtune.admin - 管理命令权限(默认:OP)
pillaroffurtune.setlobby - 设置大厅位置权限(默认:OP)
pillaroffurtune.reload - 重载配置权限(默认:OP)
pillaroffurtune.npc - 管理 NPC 权限(默认:OP)
安装
- 下载插件 JAR 文件
- 将其放入服务器的
plugins/ 文件夹中
- 安装所需的依赖项:
- FancyNpcs(必需,用于 NPC 功能)
- PlaceholderAPI(推荐,用于聊天前缀和高级占位符)
- LuckPerms(可选,用于基于权限的聊天前缀)
- Vault(可选,用于经济集成)
- 重启服务器
- 在
plugins/PillarOfFortune/config.yml 中配置插件
- 使用
/pof setlobby 设置大厅位置
- 使用
/pof npc add <mode> 创建 NPC
配置
该插件通过 config.yml 文件高度可配置。你可以自定义以下内容:
- 记分板上显示的服务端信息
- 游戏设置(玩家上限、计时器、基岩柱尺寸)
- 记分板的外观和内容
- 消息和颜色
- 游戏过程中发放的随机物品
- 玩家统计数据的数据库设置
- 聊天格式化和 LuckPerms 集成
游戏机制
游戏流程
- 玩家加入一种游戏模式(单人/双人/三人/小队)
- 他们在游戏区域上方的玻璃方块内等待
- 当足够多的玩家加入后,倒计时开始
- 玩家被传送到各自的基岩柱上
- 每 10 秒,向所有玩家发放随机物品
- 最后存活的玩家/队伍获胜
- 获胜者会获得烟花和标题展示
- 所有玩家在 10 秒后返回大厅
组队系统
- 队长最多可以邀请 8 名玩家
- 当队长加入游戏时,所有队员将一同加入
- 当队长离开时,队伍将自动解散
统计数据
- 每位玩家的胜负记录都会被追踪
- 玩家可以获得经验值和等级
- 统计数据会在记分板上显示
- 数据存储在 SQLite 数据库中(支持 MySQL)
构建
本项目使用 Maven 进行构建:
mvn clean package
编译后的 JAR 文件将位于 target/ 目录中。
依赖项
- Spigot/Paper 1.21+
- FancyNpcs(必需,用于 NPC 功能)
- PlaceholderAPI(推荐,用于聊天前缀)
- LuckPerms(可选,用于基于权限的前缀)
聊天系统
该插件具备自定义聊天格式,可显示玩家等级:
- 格式:
[level⭐] playername: message
- 配合 LuckPerms:
[level⭐][prefix] playername: message
- 配置:在 config.yml 中通过
chat.show-luckperms-prefix 启用/禁用 LuckPerms 前缀
聊天前缀要求
- 必须安装 PlaceholderAPI
- 必须安装并配置 LuckPerms
- 在 config.yml 中设置
chat.show-luckperms-prefix: true(默认值)
如果检测到 LuckPerms 但缺少 PlaceholderAPI,将会记录警告日志。
记分板系统
记分板支持内部占位符和 PlaceholderAPI 占位符:
内部占位符
{player} - 玩家名称
{mode} - 当前游戏模式(Solo/Duo/Trio/Squad/Lobby)
{level} - 玩家等级
{wins} - 玩家胜场数
{losses} - 玩家负场数
{server_ip} - 来自配置文件的服务端 IP
PlaceholderAPI 支持
记分板中可以使用任何 PlaceholderAPI 占位符,例如:
%luckperms_prefix% - LuckPerms 前缀
%player_ping% - 玩家延迟
%server_tps% - 服务端 TPS
- 以及来自各种插件的更多占位符
重载命令
使用 /pof reload 重载配置并实时更新所有记分板。
防刷屏系统
该插件包含针对加入命令的防刷屏系统,以防止双击:
- 冷却时间:尝试加入之间有 3 秒冷却时间
- 首次点击:显示 "Configurazione mappa in corso, attendere prego..." 消息
- 防刷机制:如果点击过快,显示 "Hai già richiesto di entrare in una partita! Attendi..."
- 自动清理:玩家离开服务器时,冷却时间会自动移除
这可以防止玩家意外加入多个游戏或滥用加入命令。
支持
如有问题、建议或贡献,请访问项目仓库。
PillarOfFortune
A competitive survival game plugin for Minecraft 1.21+ where players fight on tall bedrock pillars.
Features
- Multiple Game Modes: Solo, Duo, Trio, and Squad gameplay
- Dynamic World Generation: Flat worlds with tall bedrock pillars
- Party System: Create parties and play with friends
- Customizable Scoreboard: Shows player stats and server info
- NPC Integration: Citizens NPCs for easy game joining
- Random Item Distribution: Items given every 10 seconds during gameplay
- Spectator Mode: Watch the action after elimination
- Win/Loss Tracking: Player statistics and leveling system
- Configurable Settings: Everything customizable via config.yml
Commands
Main Commands
/pof setlobby - Set the lobby location (Admin)
/pof lobby - Teleport to lobby
/pof reload - Reload configuration (Admin)
/pof join <Solo/Duo/Trio/Squad> - Join a game mode
Party Commands
/pof party create - Create a party
/pof party disband - Disband your party (Leader only)
/pof party invite <player> - Invite a player to your party
/pof party accept - Accept a party invitation
/pof party decline - Decline a party invitation
/pof party leave - Leave your current party
/pof party kick <player> - Kick a player from your party (Leader only)
/pof party list - List all party members
NPC Commands
/pof npc add <solo/duo/trio/squad> - Create an NPC for a game mode (Admin)
/pof npc remove - Remove the nearest PillarOfFortune NPC (Admin)
Permissions
pillaroffurtune.* - All permissions (Default: OP)
pillaroffurtune.use - Basic plugin usage (Default: true)
pillaroffurtune.admin - Administrative commands (Default: OP)
pillaroffurtune.setlobby - Set lobby location (Default: OP)
pillaroffurtune.reload - Reload configuration (Default: OP)
pillaroffurtune.npc - Manage NPCs (Default: OP)
Installation
- Download the plugin JAR file
- Place it in your server's
plugins/ folder
- Install the required dependencies:
- FancyNpcs (required, for NPC functionality)
- PlaceholderAPI (recommended, for chat prefixes and advanced placeholders)
- LuckPerms (optional, for permission-based chat prefixes)
- Vault (optional, for economy integration)
- Restart your server
- Configure the plugin in
plugins/PillarOfFortune/config.yml
- Set the lobby location with
/pof setlobby
- Create NPCs with
/pof npc add <mode>
Configuration
The plugin is highly configurable through the config.yml file. You can customize:
- Server information displayed on scoreboard
- Game settings (player limits, timers, pillar dimensions)
- Scoreboard appearance and content
- Messages and colors
- Random items given during gameplay
- Database settings for player statistics
- Chat formatting and LuckPerms integration
Game Mechanics
Game Flow
- Players join a game mode (Solo/Duo/Trio/Squad)
- They wait in a glass cube above the playing area
- When enough players join, a countdown begins
- Players are teleported to individual bedrock pillars
- Every 10 seconds, random items are given to all players
- Last player/team standing wins
- Winner gets fireworks and title display
- All players return to lobby after 10 seconds
Party System
- Party leaders can invite up to 8 players
- When a party leader joins a game, all members join together
- Parties are automatically disbanded when the leader leaves
Statistics
- Wins and losses are tracked per player
- Players gain experience and levels
- Statistics are displayed on the scoreboard
- Data is stored in SQLite database (MySQL support available)
Building
This project uses Maven for building:
mvn clean package
The compiled JAR will be in the target/ directory.
Dependencies
- Spigot/Paper 1.21+
- FancyNpcs (Required for NPC functionality)
- PlaceholderAPI (Recommended for chat prefixes)
- LuckPerms (Optional for permission-based prefixes)
Chat System
The plugin features a custom chat format that displays player levels:
- Format:
[level⭐] playername: message
- With LuckPerms:
[level⭐][prefix] playername: message
- Configuration: Enable/disable LuckPerms prefix via
chat.show-luckperms-prefix in config.yml
Requirements for Chat Prefixes
- PlaceholderAPI must be installed
- LuckPerms must be installed and configured
- Set
chat.show-luckperms-prefix: true in config.yml (default)
If LuckPerms is detected but PlaceholderAPI is missing, a warning will be logged.
Scoreboard System
The scoreboard supports both internal placeholders and PlaceholderAPI placeholders:
Internal Placeholders
{player} - Player name
{mode} - Current game mode (Solo/Duo/Trio/Squad/Lobby)
{level} - Player level
{wins} - Player wins
{losses} - Player losses
{server_ip} - Server IP from config
PlaceholderAPI Support
Any PlaceholderAPI placeholder can be used in the scoreboard, such as:
%luckperms_prefix% - LuckPerms prefix
%player_ping% - Player ping
%server_tps% - Server TPS
- And many more from various plugins
Reload Command
Use /pof reload to reload the configuration and update all scoreboards in real-time.
Anti-Spam System
The plugin includes an anti-spam system for join commands to prevent double-clicking:
- Cooldown: 3-second cooldown between join attempts
- First Click: Shows "Configurazione mappa in corso, attendere prego..." message
- Spam Prevention: Shows "Hai già richiesto di entrare in una partita! Attendi..." if clicked too quickly
- Auto-Cleanup: Cooldowns are automatically removed when players leave the server
This prevents players from accidentally joining multiple games or spamming the join command.
Support
For issues, suggestions, or contributions, please visit the project repository.
评论 0
登录后参与评分
还没有评论,来抢沙发吧