P_Fragmentos v1.0

# P_Fragmentos

A fragment plugin for Paper 1.21.x servers, featuring configurable reward systems, menu, shop, physical redemption, placeholders, and multi-language support.

## Overview

P_Fragmentos allows you to create custom fragments and distribute them to players through different server activities.

The plugin offers:

• Fully configurable fragments
• Main menu with pagination
• Fragment shop with multiple cost types
• Virtual or physical rewards
• Manual redemption of physical fragments
• Support for custom heads via hash, URL, or Base64
• Multi-language messages
• PlaceholderAPI integration
• Automatically persisted data

## Features

### 1. Custom Fragments

Each fragment can have:

• Custom name
• Custom lore
• Material
• Custom head
• Glow effect
• Display priority in the menu
• Custom model data

This allows you to create rare, common, themed fragments, or integrate them into different server systems.

### 2. Reward Sources

Players can receive fragments from:

• Block breaking
• Furnace
• Crafting

Each source can be configured separately with:

• Enable or disable
• Random chance
• Fixed amount or interval
• Permission
• Allowed worlds
• Allowed materials
• Reward mode

### 3. Virtual and Physical Rewards

The plugin supports two reward modes:

• VIRTUAL: directly adds fragments to the player’s balance
• PHYSICAL: gives the player a physical fragment item

In physical mode, the fragment can be placed in the player’s inventory and manually redeemed with right-click.

### 4. Fragment Redemption

The player can convert virtual balance into a physical item using a command.

This is useful for:

• Player trading
• Commerce
• Events
• Manual collection systems
• Physical inventory rewards

### 5. Main Menu

The plugin includes a paginated menu to display fragments.

The menu shows:

• Registered fragments
• Amount of each fragment
• Player total
• Detailed fragment list
• Button to open the shop

The layout is configurable:

• Inventory size
• Content slots
• Information item
• Decorative item
• Buttons
• Custom heads

### 6. Fragment Shop

The shop allows players to spend fragments on rewards.

Each shop item can have:

• Custom name and lore
• Material or custom head
• Glow effect
• Custom model data
• Its own permission
• Cost using one or more fragment types
• Command rewards
• Item rewards
• Optional close after purchase

It is also possible to display a summary of the player’s fragments in the shop info item.

### 7. Messages and Languages

The plugin has a language system with separate message files.

Included languages:

• pt_br
• en_us

Chat messages, help text, prefix, and system responses can all be customized.

### 8. PlaceholderAPI Support

When PlaceholderAPI is installed, the plugin hooks into it automatically.

Available placeholders:

• %p_fragmentos_total%
• %p_fragmentos_idioma%
• %p_fragmentos_amount_<id>%
• %p_fragmentos_display_<id>%

### 9. Custom Heads

The plugin supports custom heads in multiple formats:

• Texture hash
• Minecraft texture URL
• Base64
• Links compatible with texture websites

These heads can be used:

• In fragments
• In menus
• In the shop
• In shop rewards

### 10. Data Persistence

Player balances are automatically saved in players.yml.

The save interval can be configured in the plugin’s main file.

## Commands

### Player Commands

- /fragmentos
Opens the player’s main menu.

- /fragmentos loja [page]
Opens the fragment shop.

- /fragmentos ver [player]
Shows the player’s own fragments or another player’s fragments, if they have permission.

- /fragmentos resgatar <fragment> <amount>
Converts virtual balance into a physical fragment.

### Admin Commands

- /fragmentos admin listar
Lists all registered fragments.

- /fragmentos admin dar <player> <fragment> <amount>
Adds fragments to a player.

- /fragmentos admin remover <player> <fragment> <amount>
Removes fragments from a player.

- /fragmentos admin setar <player> <fragment> <amount>
Sets the exact amount of a fragment for a player.

- /fragmentos admin recarregar
Reloads the plugin configuration.

## Permissions

- pfragmentos.use
Allows use of basic commands.

- pfragmentos.menu
Allows opening the main menu.

- pfragmentos.loja
Allows opening the shop.

- pfragmentos.resgatar
Allows redeeming physical fragments.

- pfragmentos.ver.outros
Allows viewing other players’ fragments.

- pfragmentos.admin
Grants access to admin commands.

## Configuration Files

### config.yml

Contains:

• Languages
• Save interval
• Placeholder integration in texts
• Global world rules

### fragmentos.yml

Contains fragment settings such as:

• Fragment types
• Name
• Lore
• Heads
• Glow
• Material
• Priority

### sources.yml

Contains:

• Rewards from block breaking
• Rewards from crafting
• Rewards from furnace usage
• Chance
• Worlds
• Permissions
• Allowed materials
• Physical or virtual mode

### menu.yml

Contains:

• Main menu layout
• Slots
• Information item
• Shop button
• Decoration
• Fragment display settings

### loja.yml

Contains:

• Shop layout
• Sold items
• Costs
• Rewards
• Buttons
• Custom heads
• Fragment info display settings

### idiomas/*.yml

Used to customize:

• Prefix
• Messages
• Help
• Plugin texts

## Active Hooks

The plugin automatically detects available hooks and reports them in the console when enabled.

Included hook:

- PlaceholderAPI

## Plugin Highlights

• Configurable fragment system
• Visual menu and shop
• Physical or virtual rewards
• Manual item redemption
• Custom heads
• Placeholders
• Languages
• Separate permissions for players and administrators
• Structure ready for expansion

## Summary

P_Fragmentos was made to provide a complete system for progression, collection, trading, and fragment usage inside the server, with a focus on flexibility, customization, and integration with menus and shop systems.