Complete Usage Guide: CLI & UI
BlockDoom is built for effortless administration and live gameplay control.
Every part of the game loop can be managed either through the interactive in-game GUI or the command-line interface (CLI).

All commands require the blockdoom.admin permission.
Server operators receive this permission by default.

️ 1. Interactive GUI — /blockdoom ui

Use: /blockdoom ui to open the main configuration chest menu directly in-game.
️ GUI Features
⏰ Timer Duration (Clock)
Adjust the global countdown timer length.

• Left-Click → +10 seconds
• Right-Click → -10 seconds
• Shift + Left-Click → +60 seconds
• Shift + Right-Click → -60 seconds

Changes apply instantly to the active cycle.

Auto Reload Config (Repeater)
Toggle automatic live synchronization.

When enabled:

• Any GUI changes instantly update the server
• CLI configuration changes also sync automatically

Values:

• True
• False

Scan Radius (Compass)
Controls how far around players BlockDoom scans for candidate blocks.

• Increase or decrease the chunk radius
• Range: 1 → 8 chunks

Higher values scan larger areas around players.

Show Next Block Early (Torch / Lever)
Toggle early block reveal in the ActionBar timer.

When enabled, players can see the upcoming deletion target before the countdown ends.

Example: Next deletion: Stone in 00:43
️ Protect Player Builds (Shield)
Protect manually built player structures from deletion.

Values:

• True
• False

When enabled, naturally generated terrain can still be deleted while player builds remain safe.

Deletion Speed (Minecart)
Controls how quickly chunks are processed during deletion.

• Left / Right Click to adjust speed
• Changes occur in +5 / -5 chunks per tick

Higher values cause worlds to disintegrate faster.

Manage Blacklist (Barrier)
Opens the Blacklist Manager GUI.

This allows live management of excluded materials that should never be deleted.

Managing the Blacklist GUI
When the Barrier icon is clicked, the Blacklist Manager opens.

Removing Blacklisted Blocks
The top section displays every currently blacklisted block.

Examples:

• Bedrock
• Portals
• Protected materials

Click any listed item to instantly remove it from the blacklist.

Adding New Blacklisted Blocks
Your personal inventory appears in the lower section.

Simply click any block item from your inventory to add it to the exclusion blacklist instantly.

2. Complete Command Reference
All commands support:

• Full tab completion
• Material auto-completion
• Number suggestions
• Setting suggestions

General Commands
/blockdoom
Displays the complete help menu and command list.

/blockdoom ui
Opens the interactive GUI configuration menu.

/blockdoom start
Starts or resumes the global deletion cycle.

/blockdoom pause
Pauses the active countdown or deletion loop immediately.

/blockdoom skip
Skips the active countdown and jumps directly to the deletion reveal phase.

/blockdoom status
Displays:

• Current game state
• Active dimension
• Current target material
• Total erased block count

/blockdoom forcestart
Forcefully starts the BlockDoom cycle regardless of current state.

/blockdoom forcedelete <material>
Immediately deletes a specific block material in the active dimension.

Example:
/blockdoom forcedelete GRASS_BLOCK

/blockdoom config <setting> <value>
Updates configuration values live through the CLI.
Supports all config subcommands listed below.

/blockdoom blacklist <add|remove> <material>
Adds or removes materials from the deletion blacklist instantly.

Example:
/blockdoom blacklist add DIAMOND_ORE

/blockdoom reload
Reloads:

• config.yml
• deleted_materials.yml
• Placement registries

without restarting the server.

/blockdoom regenerate
⚠️ Performs a complete world reset.

This command will:

• Teleport players to safety
• Unload BlockDoom gameplay worlds
• Delete custom blockdoom_* worlds
• Generate fresh clean worlds
• Reset all deletion registries

Use carefully.

⚙️ CLI Configuration Subcommands
/blockdoom config timer <seconds>
Sets the countdown duration.

Example:
/blockdoom config timer 60

/blockdoom config radius <chunks>
Sets the player sampling chunk radius.

Example:
/blockdoom config radius 3

/blockdoom config speed <chunks>
Sets how many chunks are scrubbed per tick.

Example:
/blockdoom config speed 10

/blockdoom config shownext <true|false>
Enables or disables early block reveal in the countdown timer.

/blockdoom config protect <true|false>
Toggles player-build protection.

/blockdoom config autoreload <true|false>
Enables or disables instant live configuration synchronization.