P_PasseBatalha v1.0

# P_PasseBatalha

Battle Pass plugin for Paper 1.21.x servers, with free and premium tracks, daily and weekly missions, configurable menus, ranking, and PlaceholderAPI support.

## Overview

P_PasseBatalha was built to add a complete progression system to the server. Players earn battle pass points by completing missions, level up, track their progress in menus, and claim rewards from separate tracks.

The plugin also includes a top players menu, premium support, database storage, language support, and placeholder integration so battle pass information can be used in other menus, scoreboards, and messages.

## Features

• Battle pass with Free and Premium tracks.
• Level system based on battle pass points.
• Main menu with quick access to profile, rewards, missions, and top players.
• Reward menu with pagination.
• Mission menu with All, Daily, and Weekly views.
• Top 10 menu with the highest-ranked players.
• Level-based reward configuration.
• Command-based reward execution.
• Support for regular icons and custom heads in rewards and menus.
• Configurable custom-head progress states.
• Configurable daily missions.
• Configurable weekly missions.
• Configurable daily and weekly reset times.
• Progress, completion, and actionbar messages.
• pt_br and en_us language support.
• PlaceholderAPI support.
• SQLite or MySQL storage.
• Separate permission for premium access.
• Administrative commands for points, premium, reset, and reload.
• Letter-based autocomplete.
• Hidden admin commands for players without permission.

## How It Works

Players join the server, receive active daily and weekly missions, and build progress through normal gameplay.

When a mission is completed, the player receives battle pass points. These points increase the season level and unlock rewards configured for that progression range.

Rewards can exist only in the free track, only in the premium track, or in both at the same time. Premium players can claim premium track rewards once they reach the required level.

The plugin also shows a Top 10 ranking menu with the players who have the highest pass progress.

## Mission Types Already Supported

The plugin already supports objectives such as:

• joining the server
• clicking in inventories
• breaking blocks
• placing blocks
• crafting items
• using furnaces
• killing mobs
• killing players
• fishing
• enchanting items
• consuming food
• gaining experience
• walking through the world

Missions can also use filters such as specific materials and entities depending on the configured objective.

## Menus

### Main Menu

Shows the player's general battle pass information and quick access to:

• rewards
• missions
• top 10
• premium status

### Missions Menu

Allows players to view:

• all missions
• daily missions only
• weekly missions only
• current page of objectives
• progress status for each mission

### Rewards Menu

Displays:

• free track
• level progress track
• premium track
• blocked, available, and claimed states
• page navigation

### Top 10 Menu

Shows the highest-performing battle pass players.

When a position has no player, the slot can use its own configurable visual item.

## Rewards

Each battle pass level can contain:

• free reward
• premium reward
• name
• lore
• icon
• custom head
• commands executed on claim

This allows the plugin to be used for simple rewards, kits, coins, keys, temporary ranks, special items, or any other action handled by commands.

## Premium System

The plugin supports a premium battle pass.

Premium access can be defined by:

• permission
• administrative command

This allows you to sell premium access through a store, rank, group, or manual activation.

## Commands

### Player Commands

• /passe
• /passe abrir
• /passe missoes
• /passe recompensas
• /passe top

Aliases:

• /passebatalha
• /bp

### Admin Commands

• /passe recarregar
• /passe reload
• /passe darpontos <amount>
• /passe darpontos <player> <amount>
• /passe setpremium <true|false>
• /passe setpremium <player> <true|false>
• /passe resetar
• /passe resetar <player>

## Permissions

• passe.admin: access to administrative commands.
• passe.premium: premium access by permission.

## Placeholders

Identifier:

- %p_passebatalha_...%

Available placeholders:

• %p_passebatalha_temporada%
• %p_passebatalha_pontos%
• %p_passebatalha_nivel%
• %p_passebatalha_premium%
• %p_passebatalha_para_proximo_nivel%
• %p_passebatalha_reset_diario%
• %p_passebatalha_reset_semanal%
• %p_passebatalha_rank%

These placeholders can be used in scoreboards, menus, holograms, other GUIs, and messages from plugins compatible with PlaceholderAPI.

## Configuration Files

### config.yml

Main plugin file. Controls:

• default language
• prefix
• autosave
• PlaceholderAPI usage
• premium permission
• season name
• max level
• points per level
• daily reset
• weekly reset
• amount of active daily and weekly missions
• progress sounds and messages
• database settings

### menu.yml

Controls the plugin menus:

• titles
• rows
• fillers
• slots
• buttons
• icons
• custom heads
• progress visual items
• empty top-slot visual items

### recompensa.yml

Defines level rewards:

• required points
• free rewards
• premium rewards
• names
• lores
• commands

### Passe/free.yml

Defines the visual appearance of the free track.

### Passe/premium.yml

Defines the visual appearance of the premium track.

### missoes/diarias.yml

Defines the list of available daily missions.

### missoes/semanais.yml

Defines the list of available weekly missions.

### idiomas/pt_br.yml

Portuguese messages.

### idiomas/en_us.yml

English messages.

## Database

The plugin can store data in:

• SQLite
• MySQL

Stored data includes:

• player
• battle pass points
• premium status
• daily progress
• weekly progress
• active missions
• claimed free rewards
• claimed premium rewards

There is also an option to import old YML data when migrating to database storage.

## Languages

The plugin supports:

• pt_br
• en_us

The default language can be configured in the main config file.

## Integrations

- PlaceholderAPI

When PlaceholderAPI is installed and enabled in the config, the plugin automatically registers and expands the battle pass placeholders.

## Best Use Cases

• survival servers
• seasonal servers
• progression events
• activity-based reward systems
• monetization with premium battle passes
• networks that want to integrate scoreboards, menus, and player status with PlaceholderAPI

## Summary

P_PasseBatalha delivers a complete battle pass system with real in-server progression, ready-to-use menus, free and premium tracks, ranking, level rewards, configurable missions, database support, and PlaceholderAPI integration.