BuildersDream

Version 1.0.0 · Paper/Purpur 1.21.x · Java 21

A timed "limited creative" service for survival servers. Players buy a build session and get flight, haste and a paginated building-blocks GUI for a set duration — without ever entering real creative mode. Every item handed out and every block placed is tracked, so creative-mode resources cannot leak into your survival economy.

Features

• Two service tiers — a full Creative tier (fly + haste + building blocks) and a lighter Fly-only tier. Both have configurable price and duration.
• No real creative — players get flight, haste and blocks only. There is no /gamemode creative, so vanilla creative exploits do not apply.
• Leak-proof by design — every dream item is tagged in its PersistentDataContainer and every placed dream block is tracked in SQLite. Drop suppression plus tracking cover crafting, containers, item frames, armor stands, ender chests, death, pistons, explosions and hoppers, so dream materials never turn into real survival drops.
• Building-blocks GUI — a categorized, paginated block picker with chat search. When enabled, dream block stacks refill as you build so you never run out mid-session.
• Pause and resume — pause a session (limited number of pauses per service) and resume later so you do not waste time while offline or busy.
• Combat aware — flight is disabled during combat (self-detected and, when present, via CombatLog), with optional fall-damage immunity while flight is cut.
• Automatic cleanup — tagged items are cleared from the ender chest on expiry and on death, leaving nothing behind when the session ends.
• Dual, optional economy — MultiBank (primary, fully async) or Vault (fallback).
• Per-player language — English, Portuguese and French, honouring PlayerSettings when present.

Commands

Command	Description	Permission
/builder	Open the main menu (buy / manage a service)	buildersdream.use
/builder blocks	Open the building-blocks picker	buildersdream.use
/builder pause	Pause your active service	buildersdream.use
/builder resume	Resume your paused service	buildersdream.use
/builder cancel	Cancel your active service	buildersdream.use
/builder status	Show your service status and time left	buildersdream.use
/builder search <query>	Search blocks in the picker	buildersdream.use
/builder reload	Reload the configuration	buildersdream.admin
/builder forcecancel <player>	Force-cancel a player's service	buildersdream.admin
/builder inspect <player>	Inspect a player's service	buildersdream.admin

Aliases: /bd, /bdream.

Permissions

Node	Description	Default
buildersdream.use	Purchase and use BuildersDream services	true
buildersdream.admin	Admin commands (reload, force-cancel, inspect)	op

Configuration

# Default language (used when PlayerSettings is not available)
language: en_US

economy:
  # "auto" = try MultiBank first, then Vault. Or force "multibank" / "vault"
  mode: auto
  priority: ["MultiBank", "Vault"]

services:
  creative:
    enabled: true
    cost: 50000.0
    duration-hours: 3
    max-pauses: 3
    includes-fly: true
    includes-haste: true
    includes-blocks: true
    haste-level: 70
  fly-only:
    enabled: true
    cost: 15000.0
    duration-hours: 3
    max-pauses: 3
    includes-fly: true
    includes-haste: false
    includes-blocks: false

combat:
  clean-period-seconds: 60
  cancel-combat-fall-damage: true
  tag-seconds: 10

blocks:
  # Broken blocks drop nothing while a service is active (no fly+haste farming)
  suppress-all-drops: true
  # Dream block stacks refill as you build
  infinite-blocks: true

cleanup:
  # Clean tagged items from the ender chest on service expiry
  # (death cleanup is always on and not configurable)
  clean-ender-chest: true

storage:
  database: "buildersdream.db"

Notable keys:

• services.<tier>.cost / duration-hours / max-pauses — price, session length and how many times a session can be paused.
• blocks.suppress-all-drops — with this on, blocks broken during a session drop nothing, which is what stops fly + haste being used to farm resources.
• blocks.infinite-blocks — dream block stacks refill while building; set false to hand out a single depleting stack instead.
• combat.* — how long flight stays cut after combat and whether the forced descent is protected from fall damage.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Install an economy provider — MultiBank or Vault — since services are purchased.
3. Drop BuildersDream-1.0.0.jar into your server's plugins/ folder.
4. Start the server, edit plugins/BuildersDream/config.yml, then run /builder reload.

Dependencies

• MultiBank or Vault — required to buy services (the economy is how sessions are paid for). MultiBank is used first, Vault as a fallback.
• PlayerSettings (optional) — per-player language selection.
• CombatLog (optional) — adds PvP combat tagging on top of the plugin's own combat detection, so flight is cut during fights.

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-buildersdream