# BridgeFalls<\/p>\n
BridgeFalls is a Minecraft plugin that adds structural stability rules to placed and nearby blocks.
\nIf a block has no valid support, it can be denied on placement or marked unstable and made to fall later.<\/p>\n
It is designed for **Paper\/Folia-style servers** and includes configurable support rules, visual instability feedback, and in-game admin commands.<\/p>\n
## Features<\/p>\n
– **Support simulation** for placed\/broken blocks (vertical, horizontal, top support, and anchor checks)
\n– **Anchor validation** with 3D connectivity (including diagonals)
\n– **Unstable block lifecycle**: mark, warn, persist, and optionally convert to `FallingBlock`
\n– **Visual feedback** with configurable particle colors and warning sounds
\n– **Large material rule lists** for:
\n – non-supporting vertical blocks
\n – non-supporting horizontal blocks
\n – always-stable blocks
\n – always-stable-but-no-support blocks
\n – floating-on-water support blocks
\n– **Gamemode exclusions** (for example Creative\/Spectator)
\n– **Runtime configuration commands** (`\/bf config …`) with validation and reload
\n– **Folia-compatible scheduling** (`GlobalRegionScheduler` + per-region execution)
\n– **Persistence** of unstable blocks to `unstable-blocks.yml`<\/p>\n
## Compatibility<\/p>\n
– **Java**: 21
\n– **API target**: Paper API `1.21.11-R0.1-SNAPSHOT`
\n– **Declared supported Minecraft versions**: `1.20 – 1.21.11`
\n– `folia-supported: true` in `plugin.yml`<\/p>\n
## Installation<\/p>\n
1. Build or download the plugin jar.
\n2. Put the jar in your server `plugins\/` folder.
\n3. Start the server once to generate default files.
\n4. Edit:
\n – `plugins\/BridgeFalls\/config.yml`
\n – `plugins\/BridgeFalls\/messages.yml`
\n5. Use `\/bf reload` or restart the server.<\/p>\n
## Commands<\/p>\n
Main aliases:<\/p>\n
– `\/bf`
\n– `\/bridgeFalls`
\n– `\/bfCommand`
\n– `\/bridgeFallsCommand`<\/p>\n
Permission:<\/p>\n
– `bridgefalls.admin` (default: op)<\/p>\n
Core:<\/p>\n
– `\/bf help`
\n– `\/bf enable`
\n– `\/bf disable`
\n– `\/bf reload`<\/p>\n
Config commands:<\/p>\n
– Radius ## How support works (high level)<\/p>\n BridgeFalls evaluates support from several angles:<\/p>\n 1. **Direct vertical support** If support is missing:<\/p>\n – placement can be denied, or Marked unstable blocks are periodically re-evaluated. If still unstable after `fall-delay-minutes`, they can fall as `FallingBlock` entities.<\/p>\n ## Configuration notes<\/p>\n Important keys in `config.yml`:<\/p>\n – `support-radius` Messages are customizable in `messages.yml` with placeholders (for example `{block}`, `{radius}`, `{count}`, `{minutes}`).<\/p>\n ## Folia behavior<\/p>\n BridgeFalls uses a **global repeating task only as a dispatcher**. ## Build from source<\/p>\n “`bash # Windows Output jar:<\/p>\n – `build\/libs\/BridgeFalls- Local Folia run task (project configured with run-paper):<\/p>\n “`bash # Windows ## Development quality tools<\/p>\n The project is configured with:<\/p>\n – Checkstyle ## License<\/p>\n See `LICENSE.md`.<\/p>\n","protected":false},"excerpt":{"rendered":" BridgeFalls is a Minecraft plugin that adds structural stability rules to placed and nearby blocks.<\/p>\n","protected":false},"featured_media":34850,"template":"","meta":{"_minecraft_slug":"bridgefalls","_minecraft_project_id":"DH5QSwkK","_minecraft_author":"Eugene-74","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bridgefalls.zip","_minecraft_size_bytes":374953,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:14:47.289315Z","_minecraft_date_created":"2026-03-04T04:36:23.727515Z","_minecraft_date_modified":"2026-02-23T23:48:36.259147Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bridgefalls","_minecraft_icon_attachment_id":34850,"_minecraft_imported_at":"2026-06-01T16:45:41+00:00","_minecraft_import_hash":"edd40fa3f555685dbff70eefe47d36ed","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125],"mod_loader":[131],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-34849","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_loader-folia","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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":"\n
\n – `\/bf config support-radius
\n – `\/bf config top-support-radius
\n – `\/bf config anchor-support-radius
\n– Behavior
\n – `\/bf config fall-delay-minutes
\n – `\/bf config time-to-check
\n – `\/bf config debug [true|false]`
\n – `\/bf config allow-placing-unstable-blocks [true|false]`
\n – `\/bf config falling-block [enable|disable]`
\n – `\/bf config falling-block drop-item [true|false]`
\n – `\/bf config falling-block hurt-entities [true|false]`
\n– Lists (`list`, `add`, `remove`)
\n – `no-rest-vertical`
\n – `no-rest-horizontal`
\n – `always-stable`
\n – `always-stable-no-support`
\n – `floating-support`
\n – `instability-colors`
\n – `disabled-gamemodes`<\/p>\n
\n – checks the 3×3 area below a block
\n – excludes air and materials listed in `no-rest-blocks-vertical`
\n2. **Horizontal support**
\n – BFS-style search up to `support-radius`
\n – only traverses blocks allowed as horizontal support providers
\n3. **Top support**
\n – optional upward check up to `top-support-radius`
\n4. **Anchor check**
\n – connectivity test within `anchor-support-radius`
\n – uses 3D neighboring blocks including diagonals<\/p>\n
\n– block is accepted but marked unstable (depending on config)<\/p>\n
\n– `top-support-radius`
\n– `anchor-support-radius`
\n– `fall-delay-minutes` (`0` means immediate fall)
\n– `time-to-check` (task interval in ticks)
\n– `allow-placing-unstable-blocks`
\n– `falling-block`
\n– `falling-block-drop-item`
\n– `falling-block-hurt-entities`
\n– `disabled-gamemodes`
\n– `instability-colors`
\n– `instable-color` (default outline when falling mode is disabled)<\/p>\n
\nAll block\/world reads are executed per location on the **region scheduler**, which is the safe model for Folia region threading.<\/p>\n
\n# Unix\/macOS
\n.\/gradlew clean shadowJar<\/p>\n
\n.\/gradlew.bat clean shadowJar
\n“`<\/p>\n
\n# Unix\/macOS
\n.\/gradlew runFolia<\/p>\n
\n.\/gradlew.bat runFolia
\n“`<\/p>\n
\n– PMD
\n– SonarQube plugin<\/p>\n