Astra Region Editor

Select an area, see the result in the world, and edit it from a dedicated screen. Astra Region Editor is a building tool for Minecraft 1.20.1 on Forge, with visual selection, block replacement, repeated cloning, and undo.

Features

• Select two corners with the editor tool. After the first click, the selection preview follows the block you are looking at.
• Fill a region or replace a specific block or block state using a searchable block picker.
• Copy, paste, cut, and delete rectangular regions.
• Clone with X/Y/Z offsets and an R repeat count. Preview each destination before placing up to 64 copies. For example, Z = -10 and R = 6 places six copies at intervals of ten blocks.
• Rotate supported block states by 90 degrees and mirror regions along the X, Y, or Z axis.
• Undo edits, including overwritten block data and repaired fence, wall, and pane connections.
• Keep the world visible between two independently scrolling editor panels.
• Use English or Japanese menu labels. Some server status and error messages are currently Japanese.

Requirements and installation

• Minecraft 1.20.1, Forge 47.4.0 or newer within Forge 47.x, and Java 17. Tested with Forge 47.4.0. Fabric and NeoForge builds are not provided.
• Put astra-region-editor-1.20.1-1.4.2.jar in the instance's mods folder without extracting it.
• For multiplayer, install the same version on both the client and the server.
• NGTLib and the original MCTE are not required.
• This project was previously named Astra MCTE Edit. Replace its old JAR when updating; do not install both. Existing editor items keep the same ID.

Getting started

1. In Creative mode, obtain World Editor from the Tools & Utilities tab, or use /give @s astra_mcte:editor.
2. Hold the tool and right-click the first and second corners of the region.
3. Press K, or Shift + right-click with the tool, to open the editor.
4. Choose blocks for Fill or Replace, or enter Clone offsets and a repeat count, then run the operation.
5. Press N to clear the region and paste target. Use Undo in the editor to restore the last edit.

Chisels & Bits integration

Chisels & Bits - For Forge is optional. With its Minecraft 1.20.1 / Forge 20.1.20 build, Clone preserves carved shapes, materials, and empty space. Repeated Clone and its Undo are supported; save-and-reload behavior has been tested.

This integration covers Clone and its Undo. Bit-level selection, placing a carved item through the held-block picker, and rotating or mirroring the internal carved shape are not supported. Rotate/Mirror rejects a region containing these carved blocks before making changes. Other Chisels & Bits versions have not been verified.

Permissions and limits

The editor requires Creative mode. Dedicated-server users and LAN guests also need operator level 2; the single-player world owner can use it in Creative mode.

Server administrators: editor operations do not post Forge's cancellable BlockEvent.BreakEvent. Claim/protection mods that depend only on that event may therefore not prevent these edits. Grant access only to trusted builders. Vanilla location restrictions, world boundaries, loaded-chunk checks, and permission checks still apply.

Operations are limited to 65,536 blocks and 256 loaded chunks, with additional data-size limits. Edits run in bounded steps over multiple ticks. Undo stores up to eight operations subject to memory limits and does not survive disconnects or server restarts. Make a world backup before large edits.

This is a block-region editor. Miniature blocks, world-data file import/export, OBJ conversion, and arbitrary-angle rotation are not included. Not every modded block's custom orientation data can be transformed. The full range of third-party mod combinations has not been tested.

Credits

The interaction workflow was inspired by MC Terrain Editor by ngt5479. Astra Region Editor is an independent implementation, not an official update from the original author. Original MCTE/NGTLib binaries and assets are not bundled. Chisels & Bits and its assets remain the work of their respective authors and are not bundled either.

日本語

Astra Region Editor は、Minecraft 1.20.1 / Forge 47.4.0以降の47.x / Java 17 用の範囲編集MODです。Forge 47.4.0で動作確認しています。2点で範囲を選び、独自の画面から設置・置換・コピー・貼り付け・Clone・回転・反転・Undoを実行できます。

導入と操作

1. JARを解凍せず mods に入れます。マルチプレイではクライアントとサーバーの両方に同じバージョンを入れてください。NGTLibや旧MCTEは不要です。
2. クリエイティブの「道具と実用品」からワールドエディターを取り出します。コマンドは /give @s astra_mcte:editor です。
3. ツールを持って2点を右クリックすると範囲を指定できます。1点目の後は視線に合わせて範囲を動的に表示します。
4. K、またはツールを持って Shift + 右クリックで編集画面を開きます。
5. Cloneの X/Y/Z に1回ごとの移動量、R にコピー回数を入力します。たとえばZ=-10、R=6なら、10ブロック間隔で6個追加します。
6. N で範囲と貼り付け先を解除できます。Undoは画面下部の「元に戻す」です。

旧名 Astra MCTE Edit と同じMODです。更新時は旧JARを取り外し、新JARと入れ替えてください。既存アイテムとキー設定のIDは維持しています。

Chisels & Bits Forge 20.1.20 の彫刻は CloneとそのUndo に対応しています。彫刻内部の回転・反転、ビット単位の範囲選択、手持ち彫刻アイテムからの設置は対象外です。通常ブロックの回転・反転は利用できます。

編集にはクリエイティブが必要です。専用サーバーとLANゲストはOPレベル2以上も必要です。編集処理はForgeの破壊イベントを発行しないため、そのイベントだけに依存する土地保護MODの拒否は適用されない場合があります。大規模編集前にはワールドをバックアップしてください。

編集上限は65,536ブロック・256読込済みチャンクで、データ容量にも上限があります。Undoは最大8回で、切断や再起動後には保持されません。Miniature・ファイル入出力・OBJ変換は含みません。

MCTEの操作を参考にした非公式の新規実装です。元作者は ngt5479 氏です。元MODのクラスや画像は同梱していません。