# [RB]\u65b9\u5757\u66ff\u6362 (ReplaceBlock)<\/p>\n
**The English description is below.**<\/p>\n
## \u7b80\u4ecb<\/p>\n
\u6b64\u6570\u636e\u5305\u63d0\u4f9b\u4e86\u4e00\u4e2a\u5f3a\u5927\u7684 API\uff0c\u53ef\u4ee5\u4ee5\u5b8c\u5168\u539f\u7248\u7684\u65b9\u5f0f\u5728\u4e16\u754c\u751f\u6210\u540e\u9ad8\u6027\u80fd\u5730\u66ff\u6362\u4e16\u754c\u4e2d\u7684\u65b9\u5757\u3002<\/p>\n
## \u529f\u80fd<\/p>\n
\u6b64\u6570\u636e\u5305\u4ee5\u533a\u5757\u4e3a\u5355\u4f4d\u904d\u5386\u5e76\u66ff\u6362\u65b9\u5757\uff0c\u6bcf\u6b21\u8c03\u7528\u4f1a\u4ece\u76ee\u6807\u5b9e\u4f53\u6240\u5728\u533a\u5757\u5411\u8fdc\u5904\u904d\u5386\uff0c\u76f4\u5230\u6210\u529f\u6e05\u9664\u4e00\u4e2a\u533a\u5757\uff0c\u6216\u8005\u904d\u5386\u5b8c\u52a0\u8f7d\u8303\u56f4\u5185\u6240\u6709\u533a\u5757\u3002\u904d\u5386\u8303\u56f4\u53ef\u4ee5\u8fdb\u884c\u914d\u7f6e\uff0c\u89c1\u4e0b\u6587\u3002<\/p>\n
## \u8c03\u7528<\/p>\n
\u8981\u8c03\u7528 API\uff0c\u8bf7\u5148\u5728\u60a8\u547d\u4ee4\u5b58\u50a8\u7684 `{}.replace_block` \u4e2d\u5b58\u50a8 API \u914d\u7f6e\uff0c\u53ef\u8c03\u7528 `replace_block:api\/reset_settings` \u51fd\u6570\u5e76\u4f20\u5165 `{storage:”\u60a8\u547d\u4ee4\u5b58\u50a8\u7684\u547d\u540d\u7a7a\u95f4 ID”}` \u751f\u6210\u793a\u4f8b\u914d\u7f6e\uff0c\u7136\u540e\u8c03\u7528 `replace_block:api\/execute` \u51fd\u6570\u5e76\u4f20\u5165 `{storage:”\u60a8\u547d\u4ee4\u5b58\u50a8\u7684\u547d\u540d\u7a7a\u95f4 ID”}`\u3002\u65b9\u5757\u66ff\u6362\u5c06\u7acb\u5373\u5f00\u59cb\uff0c\u5e76\u5728\u540c\u4e00 tick \u5185\u7ed3\u675f\u3002\u8bf7\u52a1\u5fc5\u786e\u8ba4\u60a8\u7684\u914d\u7f6e\u5305\u542b\u6240\u6709\u8981\u6c42\u7684\u6570\u636e\uff0cReplaceBlock \u4f1a\u9a8c\u8bc1\u60a8\u7684\u914d\u7f6e\u53c2\u6570\uff0c\u82e5\u7f3a\u5931\u53c2\u6570\u4f1a\u5bfc\u81f4 API \u8c03\u7528\u5931\u8d25\u3002<\/p>\n
## \u914d\u7f6e<\/p>\n
\u4ee5\u4e0b\u4e3a\u5b8c\u6574\u7684\u914d\u7f6e\u5217\u8868\uff0c\u53e6\u53ef\u67e5\u770b reset_settings.mcfunction \u4e2d\u7684\u793a\u4f8b\u3002<\/p>\n
– \u76ee\u6807\u9009\u62e9\u5668\uff1a
\n – \u8def\u5f84\uff1a`{}.replace_block.selector`
\n – \u5185\u5bb9\uff1a\u4e00\u4e2a\u76ee\u6807\u9009\u62e9\u5668\uff0c\u53ef\u5305\u542b\u53c2\u6570\u3002
\n – \u793a\u4f8b\uff1a`”@e[type=player]”`
\n– \u66ff\u6362\u8303\u56f4\uff1a
\n – \u8def\u5f84\uff1a`{}.replace_block.search_range`
\n – \u5185\u5bb9\uff1a\u904d\u5386\u8ddd\u79bb\uff0c\u4e3a 1 \u5373\u4ee5\u73a9\u5bb6\u4e3a\u4e2d\u5fc3\u7684 9 \u4e2a\u533a\u5757\u3002
\n – \u793a\u4f8b\uff1a`3`
\n– \u6210\u529f\u6570\u91cf\uff1a
\n – \u8def\u5f84\uff1a`{}.replace_block.success_threshold`
\n – \u5185\u5bb9\uff1a\u4e00\u6b21\u533a\u5757\u66ff\u6362\u89c6\u4e3a\u6210\u529f\u6240\u9700\u7684\u65b9\u5757\u66ff\u6362\u6570\u91cf\uff0c\u5982\u679c\u67d0\u533a\u5757\u6240\u6709\u65b9\u5757\u5bf9\u6210\u529f\u66ff\u6362\u7684\u65b9\u5757\u6570\u91cf\u603b\u548c\u672a\u8fbe\u5230\u6b64\u6570\u503c\uff0c\u5219\u7ee7\u7eed\u904d\u5386\u4e0b\u4e00\u533a\u5757\u3002
\n – \u793a\u4f8b\uff1a`50`
\n– \u8981\u66ff\u6362\u7684\u65b9\u5757\u5bf9\u5217\u8868\uff1a
\n – target_block
\n – \u8def\u5f84\uff1a`{}.replace_block.replace_pairs[].target_block`
\n – \u5185\u5bb9\uff1a\u5c06\u88ab\u66ff\u6362\u65b9\u5757\u7684\u547d\u540d\u7a7a\u95f4 ID
\n – \u793a\u4f8b\uff1a`”stone”`
\n – replace_with
\n – \u8def\u5f84\uff1a`{}.replace_block.replace_pairs[].replace_with`
\n – \u5185\u5bb9\uff1a\u65b0\u65b9\u5757\u7684\u547d\u540d\u7a7a\u95f4 ID
\n – \u793a\u4f8b\uff1a`”air”`
\n– \u66ff\u6362\u751f\u6548\u7ef4\u5ea6\u5217\u8868\uff1a
\n – dimension
\n – \u8def\u5f84\uff1a`{}.replace_block.dimensions[].dimension`
\n – \u5185\u5bb9\uff1a\u66ff\u6362\u751f\u6548\u7ef4\u5ea6\u7684\u547d\u540d\u7a7a\u95f4 ID
\n – \u793a\u4f8b\uff1a`”minecraft:overworld”`
\n – min_y
\n – \u8def\u5f84\uff1a`{}.replace_block.dimensions[].min_y`
\n – \u5185\u5bb9\uff1a\u66ff\u6362\u751f\u6548\u7684\u6700\u5c0f\u9ad8\u5ea6
\n – \u793a\u4f8b\uff1a`-64`
\n – max_y
\n – \u8def\u5f84\uff1a`{}.replace_block.dimensions[].max_y`
\n – \u5185\u5bb9\uff1a\u66ff\u6362\u751f\u6548\u7684\u6700\u5927\u9ad8\u5ea6
\n – \u793a\u4f8b\uff1a`319`<\/p>\n
—<\/p>\n
## Introduction<\/p>\n
This datapack provides a powerful API that can replace blocks in the world with high performance in a completely vanilla way after world generation.<\/p>\n
## Features<\/p>\n
This datapack traverses and replaces blocks chunk by chunk. Each call will traverse from the target entity’s current chunk outward until successfully clearing one chunk or traversing all chunks within the loaded range. The traversal range can be configured as described below.<\/p>\n
## Usage<\/p>\n
To use the API, first store the API configuration in your command storage at `{}.replace_block`. You can call the `replace_block:api\/reset_settings` function with `{storage:”your command storage namespace ID”}` to generate example configuration, then call the `replace_block:api\/execute` function with `{storage:”your command storage namespace ID”}`. Block replacement will start immediately and end within the same tick. Please ensure your configuration contains all required data. ReplaceBlock will validate your configuration parameters, and missing parameters will cause API calls to fail.<\/p>\n
## Configuration<\/p>\n
Below is the complete configuration list. You can also view the example in reset_settings.mcfunction.<\/p>\n
– Target Selector:
\n – Path: `{}.replace_block.selector`
\n – Content: A target selector that can include parameters.
\n – Example: `”@e[type=player]”`
\n– Search Range:
\n – Path: `{}.replace_block.search_range`
\n – Content: Traversal distance, where 1 means 9 chunks centered on the player.
\n – Example: `3`
\n– Success Threshold:
\n – Path: `{}.replace_block.success_threshold`
\n – Content: Number of block replacements required for a chunk replacement to be considered successful. If the total number of successfully replaced blocks in a chunk does not reach this value, traversal continues to the next chunk.
\n – Example: `50`
\n– Replacement Block Pairs List:
\n – target_block
\n – Path: `{}.replace_block.replace_pairs[].target_block`
\n – Content: Namespace ID of the block to be replaced
\n – Example: `”stone”`
\n – replace_with
\n – Path: `{}.replace_block.replace_pairs[].replace_with`
\n – Content: Namespace ID of the new block
\n – Example: `”air”`
\n– Effective Dimensions List:
\n – dimension
\n – Path: `{}.replace_block.dimensions[].dimension`
\n – Content: Namespace ID of the dimension where replacement takes effect
\n – Example: `”minecraft:overworld”`
\n – min_y
\n – Path: `{}.replace_block.dimensions[].min_y`
\n – Content: Minimum height where replacement takes effect
\n – Example: `-64`
\n – max_y
\n – Path: `{}.replace_block.dimensions[].max_y`
\n – Content: Maximum height where replacement takes effect
\n – Example: `319`<\/p>\n","protected":false},"excerpt":{"rendered":"
This datapack provides a powerful API that can replace blocks in the world with high performance in a completely vanilla way after world generation.<\/p>\n","protected":false},"featured_media":132168,"template":"","meta":{"_minecraft_slug":"replaceblock","_minecraft_project_id":"lr0gX2RY","_minecraft_author":"white_elephant","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":411,"_minecraft_follows":2,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"replaceblock.zip","_minecraft_size_bytes":6545147,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T18:59:28.587394Z","_minecraft_date_created":"2025-11-20T04:55:29.289771Z","_minecraft_date_modified":"2025-11-28T14:22:55.184996Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/replaceblock","_minecraft_icon_attachment_id":132168,"_minecraft_imported_at":"2026-06-07T19:07:24+00:00","_minecraft_import_hash":"cc1b2124396a80b7d2cebfb653b838ff","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,97,104,873,158,98,123],"mod_loader":[86,99,106,160,100],"minecraft_version":[93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-132167","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-fabric","mod_category-forge","mod_category-library","mod_category-neoforge","mod_category-quilt","mod_category-technology","mod_loader-datapack","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","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-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