{"id":110542,"date":"2026-06-06T14:58:17","date_gmt":"2026-06-06T11:58:17","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/"},"modified":"2026-06-06T14:58:17","modified_gmt":"2026-06-06T11:58:17","slug":"newplayerpanel","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/","title":{"rendered":"NewPlayerPanel"},"content":{"rendered":"

# NewPlayerPanel v3.0.2<\/p>\n

## Features<\/p>\n

### Villager Tracking Module<\/p>\n

The villager tracking module provides comprehensive monitoring and logging of villager death events:<\/p>\n

– **Death Event Recording**: Automatically tracks all villager deaths with full metadata
\n– **Killer Identification**: Records player name, UUID, and associated information
\n– **Location Tracking**: Saves precise coordinates (X, Y, Z) and world name for each event
\n– **Villager Type Detection**: Identifies and records the specific villager type
\n– **Enchantment Preservation**: Captures enchantment data from villager trades
\n– **Interactive Coordinates**: Clickable coordinates for instant teleportation to villager death location
\n– **Clickable Teleport in Notifications**: Coordinates in villager death notifications are clickable for quick teleportation
\n– **Automatic Dimension Detection**: Automatic detection of the correct dimension (overworld\/nether\/end) for proper teleportation between worlds
\n– **Advanced Search**: Query records by player name, coordinates, or combined criteria
\n– **Notification System**: Real-time notifications for administrators with appropriate permissions
\n– **Data Cleanup**: Automatic cleanup of historical records based on time criteria<\/p>\n

### Player Restrictions System<\/p>\n

Advanced restriction system allowing precise control over player actions:<\/p>\n

– **Multiple Restriction Types**: Support for EQUIPMENT, ITEM, ENTITY, and COMMAND restrictions
\n– **Default Restrictions**: Automatic application of restrictions based on player’s time on server
\n– **Time Control**: Configure temporary or permanent restrictions
\n– **In-Game Management**: Create and modify restrictions through command interface
\n– **Action Granularity**: Precise restriction configuration using action types (DAMAGE, USE, DROP, EQUIP, EXECUTE)
\n– **Personal Overrides**: Apply individual restrictions that override default settings
\n– **Real-Time Application**: Restrictions are checked and applied every 0.1 seconds
\n– **Player Viewing**: Players can view their active restrictions using `\/restrictions`
\n– **Default Time-Based Restrictions**: Default restrictions count time from player’s first join, not from server start<\/p>\n

### Storage Systems<\/p>\n

Multiple storage backends for maximum flexibility:<\/p>\n

– **YAML\/JSON Storage**: File-based storage using JSON format in plugin data directory
\n– **H2 Database**: Lightweight embedded SQLite database (default, no configuration required)
\n– **MySQL Support**: Full integration with MySQL database with connection pooling
\n– **MariaDB Support**: Native MariaDB database support with optimized queries<\/p>\n

### Localization<\/p>\n

Full internationalization support:<\/p>\n

– **Multi-Language**: Full support for Russian and English languages included
\n– **Extensibility**: Easy to add additional languages through message files
\n– **Customizable Messages**: All user-facing text can be modified through configuration
\n– **Real-Time Language Switching**: Change language without server restart<\/p>\n

—<\/p>\n

## Commands<\/p>\n

### Administrative Commands<\/p>\n

| Command | Description | Permission | Usage Example |
\n|———|————-|————|—————|
\n| `\/npp reload` | Reloads plugin configuration and applies changes | `newplayerpanel.admin` | `\/npp reload` |
\n| `\/npp addrestriction` | Creates a new restriction definition | `newplayerpanel.admin` | `\/npp addrestriction elytra_ban EQUIPMENT EQUIP minecraft:elytra time:-1 default:false` |<\/p>\n

**Command Syntax:**
\n“`
\n\/npp addrestriction [targets…] [time:N] [default:true\/false]
\n“`<\/p>\n

### History Commands<\/p>\n

| Command | Description | Permission | Usage Example |
\n|———|————-|————|—————|
\n| `\/history` | Displays all villager death records | `newplayerpanel.history` | `\/history` |
\n| `\/history ` | Shows records for a specific player | `newplayerpanel.history` | `\/history Steve` |
\n| `\/history ` | Shows records near coordinates | `newplayerpanel.history` | `\/history 100 64 200` |
\n| `\/history coords` | Shows records at your current location | `newplayerpanel.history` | `\/history coords` |
\n| `\/history purge

**Time Format Examples:**
\n– `7d` – 7 days
\n– `30d` – 30 days
\n– `1h` – 1 hour
\n– `2w` – 2 weeks
\n– `1M` – 1 month<\/p>\n

### Restriction Management Commands<\/p>\n

| Command | Description | Permission | Usage Example |
\n|———|————-|————|—————|
\n| `\/restrict

**Time Values:**
\n– `-1` – Permanent restriction
\n– `0` – Remove restriction
\n– `>0` – Duration in seconds (e.g., `3600` = 1 hour)<\/p>\n

**Note:** Players can view their restrictions by using `\/restrictions` without arguments. Administrators can view other players’ restrictions by specifying the player name.<\/p>\n

—<\/p>\n

## Permissions<\/p>\n

| Permission Node | Description | Default Access |
\n|—————-|————-|—————-|
\n| `newplayerpanel.admin` | Full administrative access to `\/npp` commands | Operators only |
\n| `newplayerpanel.history` | View villager death history records | Operators only |
\n| `newplayerpanel.history.purge` | Permission to purge old history records | Operators only |
\n| `newplayerpanel.notify` | Receive notifications about villager deaths | Operators only |
\n| `newplayerpanel.restrictions.bypass` | Bypass all restrictions from configuration | Operators only |
\n| `newplayerpanel.restrictions.restrict` | Apply and remove player restrictions | Operators only |
\n| `newplayerpanel.restrictions.view` | View your active restrictions | All players |
\n| `newplayerpanel.restrictions.view.others` | View other players’ restrictions | Operators only |<\/p>\n

—<\/p>\n

## Configuration<\/p>\n

### Main Configuration File (`config.yml`)<\/p>\n

“`yaml
\nlanguage: en
\nstorage: H2
\ndatabase:
\n host: localhost
\n port: 3306
\n database: newplayerpanel
\n username: root
\n password: “”
\n pool:
\n maximum-pool-size: 10
\n minimum-idle: 2
\n connection-timeout: 30000
\n idle-timeout: 600000
\n max-lifetime: 1800000<\/p>\n

villager-tracker:
\n only-traded: true
\n notify-enabled: true
\n save-debug-files: false
\n“`<\/p>\n

### Restrictions Configuration File (`restrictions.yml`)<\/p>\n

“`yaml
\nrestrictions:
\n – name: elytra_ban
\n type: EQUIPMENT
\n actions: EQUIP
\n item: [minecraft:elytra]
\n time: -1
\n default: false<\/p>\n

– name: tnt_restriction
\n type: ITEM
\n actions: USE
\n item: [minecraft:tnt]
\n time: 28800
\n default: true<\/p>\n

– name: villager_hit_restriction
\n type: ENTITY
\n actions: DAMAGE
\n entity: [minecraft:villager]
\n time: -1
\n default: false
\n“`<\/p>\n

### Restriction Types<\/p>\n

| Type | Description | Target Field |
\n|——|————-|————–|
\n| `EQUIPMENT` | Restricts equipping items in armor\/elytra slots | `item` |
\n| `ITEM` | Restricts using or placing items | `item` |
\n| `ENTITY` | Restricts interaction with entities | `entity` |
\n| `COMMAND` | Restricts command execution | `command` |<\/p>\n

### Action Types<\/p>\n

| Action | Description |
\n|——–|————-|
\n| `DAMAGE` | Dealing damage to entities |
\n| `USE` | Using or placing items |
\n| `DROP` | Dropping items |
\n| `EQUIP` | Equipping items in armor\/elytra slots |
\n| `EXECUTE` | Executing commands |<\/p>\n

### Restriction Logic<\/p>\n

**Default Restrictions:**
\n– When `default: true`, restrictions are automatically applied to all players
\n– Time is calculated from **player’s first join** (not from server start time)
\n– Example: If `time: 3600` (1 hour), restriction applies during the first hour after player’s first join
\n– If `time: -1`, restriction is permanent for all players
\n– Default restrictions are automatically removed when time expires<\/p>\n

**Personal Restrictions:**
\n– Applied through `\/restrict` command
\n– Time is calculated from **application moment** (not from player’s first join)
\n– Personal restrictions **override** default restrictions
\n– If a player has a personal restriction, default restrictions with the same name are ignored
\n– Personal restrictions can be manually removed using `\/unrestrict`<\/p>\n

**Priority Order:**
\n1. Personal restrictions (highest priority)
\n2. Default restrictions (if no personal restriction exists)<\/p>\n

**Viewing Restrictions:**
\n– Players can view their restrictions: `\/restrictions`
\n– Administrators can view any player’s restrictions: `\/restrictions `
\n– Both personal and default restrictions are displayed with remaining time<\/p>\n

—<\/p>\n

## Storage Systems<\/p>\n

### YAML\/JSON Storage<\/p>\n

File-based storage using JSON format. All data is stored in `plugins\/NewPlayerPanel\/data\/`:
\n– `messages.json` – Localization messages
\n– `villager_deaths.json` – Villager death records
\n– `restrictions.json` – Player restriction data<\/p>\n

**Advantages:**
\n– No database setup required
\n– Easy to backup (copy files)
\n– Human-readable format<\/p>\n

**Configuration:**
\n“`yaml
\nstorage: YAML
\n“`<\/p>\n

### H2 Database (Default)<\/p>\n

Embedded SQLite database stored as `plugins\/NewPlayerPanel\/database.db`.<\/p>\n

**Advantages:**
\n– No external dependencies
\n– Automatic setup
\n– Good performance for small to medium servers<\/p>\n

**Configuration:**
\n“`yaml
\nstorage: H2
\n“`<\/p>\n

### MySQL Database<\/p>\n

Full integration with MySQL database with connection pooling via HikariCP.<\/p>\n

**Advantages:**
\n– Scalability for large servers
\n– Support for multiple server instances
\n– Advanced query capabilities<\/p>\n

**Configuration:**
\n“`yaml
\nstorage: MYSQL
\ndatabase:
\n host: localhost
\n port: 3306
\n database: newplayerpanel
\n username: root
\n password: your_password
\n“`<\/p>\n

### MariaDB Database<\/p>\n

Native MariaDB support with optimized connection handling.<\/p>\n

**Advantages:**
\n– MariaDB feature compatibility
\n– High performance
\n– Enterprise-level reliability
\n– Optimized connection with proper parameters
\n– Automatic column checking and addition for backward compatibility<\/p>\n

**Configuration:**
\n“`yaml
\nstorage: MARIADB
\ndatabase:
\n host: localhost
\n port: 3306
\n database: newplayerpanel
\n username: root
\n password: your_password
\n pool:
\n maximum-pool-size: 10
\n minimum-idle: 2
\n connection-timeout: 30000
\n idle-timeout: 600000
\n max-lifetime: 1800000
\n“`<\/p>\n

## Compatibility<\/p>\n

### Supported Server Software<\/p>\n

– **Spigot** – Full compatibility
\n– **Purpur** – Full compatibility
\n– **Any Bukkit-based server** – Compatible with standard Bukkit API<\/p>\n

### Minecraft Versions<\/p>\n

– **1.21.x** – Fully supported
\n– Future versions – Should work with API version 1.20+<\/p>\n

### Java Requirements<\/p>\n

– **Java 17** – Minimum required version
\n– **Java 21** – Recommended for optimal performance<\/p>\n

### Database Requirements (if using MySQL\/MariaDB)<\/p>\n

– **MySQL 8.0+**
\n– **MariaDB 10.3+**
\n– Database must support UTF-8 encoding<\/p>\n

—<\/p>\n

## Support and Documentation<\/p>\n

– **Author:** Math_Tereegor
\n– **Help and Support:** MISQZY and 6oJIeH
\n– **Plugin Version:** 3.0.2<\/p>\n","protected":false},"excerpt":{"rendered":"

Player Restrictions System & Villager Tracker Module<\/p>\n","protected":false},"featured_media":110543,"template":"","meta":{"_minecraft_slug":"newplayerpanel","_minecraft_project_id":"ajaGny9W","_minecraft_author":"Math_Tereegor","_minecraft_license":"MIT","_minecraft_downloads":25,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"newplayerpanel.zip","_minecraft_size_bytes":38952835,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:24:00.981414Z","_minecraft_date_created":"2025-12-05T04:10:02.825064Z","_minecraft_date_modified":"2025-12-04T19:27:42.008431Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/newplayerpanel","_minecraft_icon_attachment_id":110543,"_minecraft_imported_at":"2026-06-06T11:58:17+00:00","_minecraft_import_hash":"bb29d554061aec8b94b71b56900780c6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,867,129],"mod_loader":[130,132,133,134],"minecraft_version":[37,40,73,74,38,78,79,80,81,82],"class_list":["post-110542","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nNewPlayerPanel - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"NewPlayerPanel - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Player Restrictions System & Villager Tracker Module\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/\",\"name\":\"NewPlayerPanel - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/newplayerpanel-icon-8100d180532985551f6017e1a32685f198ca8df7_96.webp\",\"datePublished\":\"2026-06-06T11:58:17+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/newplayerpanel-icon-8100d180532985551f6017e1a32685f198ca8df7_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/newplayerpanel-icon-8100d180532985551f6017e1a32685f198ca8df7_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/newplayerpanel\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"NewPlayerPanel\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"NewPlayerPanel - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/","og_locale":"en_US","og_type":"article","og_title":"NewPlayerPanel - Minecraft","og_description":"Player Restrictions System & Villager Tracker Module","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/","name":"NewPlayerPanel - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/newplayerpanel-icon-8100d180532985551f6017e1a32685f198ca8df7_96.webp","datePublished":"2026-06-06T11:58:17+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/newplayerpanel-icon-8100d180532985551f6017e1a32685f198ca8df7_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/newplayerpanel-icon-8100d180532985551f6017e1a32685f198ca8df7_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/newplayerpanel\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"NewPlayerPanel"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/110542","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/110543"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=110542"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=110542"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=110542"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=110542"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}