LotusBBR

LotusBBR is a shared block-breaking event plugin where players contribute to a global goal.

Each block tracks total progress and individual contributions. When the goal is reached, the top contributor wins the reward. The block then enters a cooldown and automatically resets, creating a repeating server-wide event.

Fully configurable with support for multiple blocks, rewards, and optional holograms.

Core Mechanics

• Global break counter shared across all players
• Configurable break target per block
• Top contributor receives the reward
• Console commands with %player% support
• Block is replaced with Bedrock during cooldown
• Automatic restore after cooldown

Multiple Blocks

• Define multiple blocks in blocks.yml
• Each block has its own settings (location, target, cooldown, rewards, etc.)
• Optional hologram toggle per block

Holograms

• Requires DecentHolograms to display holograms
• Displays progress, cooldown, and top players
• Fully configurable
• Optimized updates to reduce performance impact

Inactivity System

• Resets individual progress after inactivity
• Configurable timeout or can be disabled

Database Support

• YAML, JSON, SQLite, MySQL

Performance

• Fast block lookup for break events
• Cached progress and leaderboards
• Async handling for heavy tasks

Command	Permission	Description
/lbbr reload	lbbr.reload	Reload plugin configuration
/lbbr list	lbbr.list	View block list and progress
/lbbr tp <id>	lbbr.tp	Teleport to a block
/lbbr reset <id>	lbbr.reset	Reset block progress and cooldown
/lbbr set <id>	lbbr.set	Move/set a block in-game
/lbbr cleanholo	lbbr.cleanholo	Rebuild all holograms
/lbbr status	lbbr.admin	View plugin status
/lbbr debug	lbbr.debug	Toggle debug mode
-	lbbr.*	Full access to all commands

config.yml

# ============================================================
#   LotusBBR v1.0.0  |  Configuration File
#   Author: JaoXu   |  Discord: jaoxu_
# ============================================================

# -----------------------------------------------------------
# DATABASE
# -----------------------------------------------------------
Database:
  type: "SQLITE"          # YAML | JSON | SQLITE | MYSQL

  mysql:
    host: "localhost"
    port: 3306
    database: "minecraft"
    username: "root"
    password: "password"
    useSSL: false
    autoReconnect: true
    maximumPoolSize: 10
    minimumIdle: 2
    connectionTimeout: 30000
    idleTimeout: 600000
    maxLifetime: 1800000

  sqlite:
    filename: "lbbr_data.db"

# -----------------------------------------------------------
# OPTIMIZATION
# -----------------------------------------------------------
Optimization:
  tasks:
    hologramUpdateInterval: 5     # Cooldown check & hologram refresh interval (seconds)
    inactivityCheckInterval: 60   # How often inactive players are checked (seconds)
    autoSaveInterval: 300         # How often data is saved automatically (seconds)
    progressMessageInterval: 5    # How often progress messages are sent to players (seconds)

  performance:
    maxConcurrentUpdates: 5       # Max holograms updating at the same time
    asyncOperations: true         # Use async DB saves (recommended: true)

# -----------------------------------------------------------
# SOUND
# -----------------------------------------------------------
Sound:
  enabled: true
  name: "FIREWORK"
  volume: 1.0
  pitch: 1.0

# -----------------------------------------------------------
# HOLOGRAMS
# Requires DecentHolograms (optional).
# The plugin works normally without it — holograms are simply
# skipped if DecentHolograms is not installed.
#
# Variables: %name_block% %timereset% %block_break% %blocks%
#            %top1% %top1b% %top2% %top2b% %top3% %top3b%
# -----------------------------------------------------------
Holograms:
  height: 4.5
  updateOnlyWhenChanged: true
  hologram:
   - "%name_block%"
    - "&6Reset time: &e%timereset%"
    - "&6Blocks mined: &e%block_break%&7/&e%blocks%"
    - "&f"
    - "&e» &6&lTOP MINERS &e«"
    - "&e1. &a%top1% &7(&e%top1b%&7)"
    - "&e2. &a%top2% &7(&e%top2b%&7)"
    - "&e3. &a%top3% &7(&e%top3b%&7)"
    - "&7&o(Progress is reset after 10 minutes of inactivity)"
    - "&f"

# -----------------------------------------------------------
# GENERAL
# -----------------------------------------------------------
General:
 # Seconds of inactivity before a player's progress is reset.
  # Set to -1 to disable inactivity resets entirely.
  # Examples: 300 = 5 min | 600 = 10 min | 3600 = 1h | -1 = disabled
  inactive-reset: 600

  debug: false              # Set to true to print detailed debug logs to console

blocks.yml

# ============================================================
#   LotusBBR v1.0.0  |  Block Definitions  (blocks.yml)
#   Author: JaoXu   |  Discord: jaoxu_
# ============================================================
#
# Each entry in "BlockRewards" is a reward block.
# The key (e.g. "epic_diamond") is the internal ID used in
# commands like /lbbr tp <id> or /lbbr reset <id>.
#
# ──────────────────────────────────────────────────────────
#  Name       → Display name shown in holograms & messages.
#               Supports color codes (&6, &l, &c…)
#  Cooldown   → Seconds before the block resets. During
#               cooldown it becomes BEDROCK (unbreakable).
#               900 = 15min | 3600 = 1h | 86400 = 24h
#  Block      → Minecraft material name.
#               e.g. DIAMOND_BLOCK, EMERALD_BLOCK, GOLD_BLOCK
#  Blockbreak → Total breaks needed across ALL players to
#               complete the block.
#  Hologram   → true/false — requires DecentHolograms.
#  Coords     → [x, y, z] — use /lbbr set <id> in-game
#               instead of editing this field manually.
#  World      → Exact world name (case-sensitive).
#               e.g. world, world_nether, world_the_end
#  Commands   → Console commands on completion. The player
#               with the most breaks wins.
#               Available variable: %player%
#
# Command examples:
#   - "give %player% diamond 10"
#   - "eco give %player% 5000"
#   - "broadcast &6%player% &awon the challenge!"
# ============================================================

BlockRewards:
  epic_diamond:
    Name: "&6&lEpic Diamond"
    Cooldown: 3600
    Block: DIAMOND_BLOCK
    Blockbreak: 1000
    Hologram: true
    Coords: [0, 64, 0]
    World: "world"
    Commands:
     - "give %player% diamond_sword 1"
      - "broadcast &6%player% &acompleted the &6&lEpic Diamond &achallenge!"

  legendary_emerald:
    Name: "&2&lLegendary Emerald"
    Cooldown: 7200
    Block: EMERALD_BLOCK
    Blockbreak: 2500
    Hologram: true
    Coords: [100, 70, 100]
    World: "world"
    Commands:
     - "give %player% emerald 64"
      - "give %player% elytra 1"

  golden_rush:
    Name: "&e&lGolden Rush"
    Cooldown: 1800
    Block: GOLD_BLOCK
    Blockbreak: 500
    Hologram: true
    Coords: [-50, 65, -50]
    World: "world"
    Commands:
     - "give %player% golden_apple 5"
      - "give %player% gold_ingot 32"

  iron_fortress:
    Name: "&7&lIron Fortress"
    Cooldown: 900
    Block: IRON_BLOCK
    Blockbreak: 250
    Hologram: true
    Coords: [25, 63, 25]
    World: "world"
    Commands:
     - "give %player% iron_sword 1"
      - "give %player% iron_pickaxe 1"
      - "give %player% iron_ingot 16"

No servers are currently listed. Running LotusBBR on your server? Message me on Discord and I’ll add you here.

If you need support for the plugin, want to report bugs, suggest features, or access a test server, contact me on Discord.