🚀 PerPlayerBlockLimits - Chunk-Based System (Secure Edition)

🎮 The ULTIMATE chunk-based block limiting plugin — Secure, Optimized & Monetizable!

Take full control of technical builds & server performance while offering players premium perks they can buy — all with the most advanced, secure, and feature-rich per-chunk block limit system ever made for Minecraft servers.

✨ Why Choose PerPlayerBlockLimits?

✅ Prevent server lag & abuse from redstone machines and farms
✅ Offer rank-based perks players can purchase — perfect for donations or shop bundles
✅ Fully integrated with LuckPerms & PlaceholderAPI
✅ Completely customizable to fit YOUR server’s needs
✅ Safe, secure, and blazing fast

🧱 Core Features

🌟 Chunk-Based Block Limits
Each 16x16 chunk tracks limits separately — smarter than global limits.

🌟 Rank-Based Permissions
Set different limits for ranks like Default, VIP, VVIP, MVP, Legend & Ultimate — and sell these ranks or permissions to players through your shop.

🌟 Seamless LuckPerms Integration
Assign permissions dynamically with LuckPerms — players automatically get the limits of their rank.

🌟 Real-Time Tracking
Detects block placement & breaking instantly — no laggy scans.

🌟 Monetizable Perks
Because limits are tied to permissions, you can sell higher block limits as perks or bundles — increasing your server’s revenue while keeping builds under control.

🌟 PlaceholderAPI Support
Show players their limits, progress & rank anywhere — perfect for scoreboards & menus.

🌟 High Performance & Secure
Lightweight, optimized, and packed with anti-tampering & runtime security checks to protect your server.

🎯 How Does It Work?

🗺️ Every chunk (16x16 area) has its own independent limits based on the player’s rank.
🔨 Players can build up to their rank’s limit per chunk, then move to another chunk if needed.
🛑 Prevents huge farms in one area that hurt performance, while letting players progress.
💰 Players can upgrade their rank to unlock more limits!

🏆 Default Rank Limits Table

All values can be changed in config.yml — customize it however you like!

🧰 Commands

• /pblimits check – View your current chunk’s block usage & limits

• /pblimits clean <blocktype> – Reset tracking for a specific block type

• /pblimits clear – Wipe all tracking data

• /pblimits reload – Reload configuration without restarting

• /pblimits stats – View server-wide stats

• /pblimits info – Plugin information

📊 PlaceholderAPI Placeholders

✔️ %ppbl_hopper_current% – Current hopper count in this chunk
✔️ %ppbl_hopper_max% – Maximum hoppers allowed in this chunk
✔️ %ppbl_rank% – Player’s current rank
✔️ %ppbl_chunk_info% – Chunk coordinates & stats

Use these to create dynamic scoreboards, menus, and messages!

🔧 Easy Installation

1️⃣ Download the plugin JAR file
2️⃣ Drop it into your /plugins folder
3️⃣ Install LuckPerms (strongly recommended)
4️⃣ Restart your server
5️⃣ Edit config.yml to set up ranks & limits
6️⃣ Assign permissions to ranks with LuckPerms — and start selling them in your shop!




Config

# PerPlayerBlockLimits Configuration


settings:
  notifications:
    chunk-limit-reached: true
    chunk-near-limit: true
    near-limit-percent: 80
  
  cleanup:
    remove-oldest-first: true
    protect-named-blocks: true
    
  # Security settings
  security:
    enabled: true
    build-timestamp: 1721207244

# Block limits per chunk based on player rank
ranks:
  default:
    blocks:
      HOPPER: 5
      PISTON: 8
      STICKY_PISTON: 8
      OBSERVER: 6
  
  vip:
    blocks:
      HOPPER: 10
      PISTON: 15
      STICKY_PISTON: 15
      OBSERVER: 12
  
  vvip:
    blocks:
      HOPPER: 20
      PISTON: 25
      STICKY_PISTON: 25
      OBSERVER: 20
      
  mvp:
    blocks:
      HOPPER: 35
      PISTON: 40
      STICKY_PISTON: 40
      OBSERVER: 35
      DISPENSER: 25
      DROPPER: 25
      
  legend:
    blocks:
      HOPPER: 50
      PISTON: 60
      STICKY_PISTON: 60
      OBSERVER: 50
      DISPENSER: 40
      DROPPER: 40
      COMPARATOR: 30
      REPEATER: 30
      
  ultimate:
    blocks:
      HOPPER: 100
      PISTON: 120
      STICKY_PISTON: 120
      OBSERVER: 100
      DISPENSER: 80
      DROPPER: 80
      COMPARATOR: 60
      REPEATER: 60
      NOTE_BLOCK: 50
      
messages:
  prefix: "&8[&bPPBL&8]&r "
  chunk-limit-reached: "&cChunk limit reached! You can't place more {block} in this chunk (limit: {limit})"
  chunk-near-limit: "&eApproaching chunk limit for {block}! ({current}/{max}) in {chunk}"
  chunk-info: "&aChunk information: &f{chunk}"
  block-removed: "&cRemoved {count} blocks from chunk due to configuration change."
  rank-upgrade: "&aYour chunk block limits have increased with your new rank!"

💰 Monetization Ready

🎁 Since the block limits are tied to ranks & permissions, you can offer players premium ranks (VIP, VVIP, etc.) in exchange for donations or in-game purchases — turning your server’s limitations into a sustainable revenue stream!

🔒 Built-In Security Features

🔐 Secure build with integrity verification
🚫 Anti-tampering & runtime validation
⚡ Minimized, optimized JAR for peak performance

📞 Support & Community

💬 Need help or have questions?
Join our Discord server , ask your questions, or open a support ticket anytime.

🎨 Perfect for:
✔ Survival servers
✔ Creative plots
✔ Technical Minecraft servers
✔ Any server where performance & fairness matter!