GPTitle 🚩

A lightweight PaperMC plugin that enhances claim identification. It displays a Title/Subtitle to players entering a claim and allows owners to personalize their territory with custom names.

✨ Features

• Automatic Titles: Displays the owner's name when a player enters a claim.
• Custom Naming: Claim owners can set a custom display name for their land.
• GriefPrevention Integration: Works seamlessly with your existing GP claims.

🛠️ Requirements

• Server: PaperMC (Recommended version: 26.1.2)
• Dependency: GriefPrevention (Required)

🚀 Installation

1. Download the latest .jar from the releases page.
2. Ensure GriefPrevention is installed on your server.
3. Drop the GPTitles.jar into your /plugins folder.
4. Restart or reload the server.

⌨️ Commands

Command	Description	Permission
/claimname <name>	Sets a custom name for the claim you are standing in.	Default
/claimclear	Removes the custom name and resets to default.	Default

⚙️ Configuration

The configuration file will be generated at plugins/GPTitles/config.yml.

Currently, it focuses on localization, allowing you to translate all messages sent to players:

This plugin supports MiniMessage (Adventure) tags for rich text formatting and internal placeholders for dynamic information.

# Language Settings
messages:
  # Title and Subtitle shown when entering a claim
  claim-title: "<green>{name}"
  claim-subtitle: "<yellow>Entering claim of: <gold>{owner}</gold>"

  # Feedback for the /claimname command
  claim-set: "<green>Claim name updated to: <white>{name}</white>"
  claim-cleared: "<red>Claim name has been reset.</red>"

  # Error messages
  claim-empty: "<red>You are not inside a claim!"
  claim-permission: "<red>You don't have permission to name this claim!"

  # Command usage and help (CLI)
  command-claimname-argument: "name"
  command-claimname-use: "<yellow>Usage: /claimname <name>"
  command-claimname-description: "Sets a custom name for the current claim"

🏗️ Development

Built with Kotlin for the Paper API.

Build from source:

# Clone the repository
git clone https://github.com/alexribeirodesa/paper-gptitle.git

# Build with Gradle
./gradlew build

☕ Support the Project

If this plugin helps your server, consider supporting its development!

Every coffee helps me keep the "Paper Projects" series updated and free.