Python 【MXCR】一个跨存档/同存档建筑编辑插件（Endstone） 2.8.0

[MD]# MXCR: Minecraft X Copy Region for Endstone     **MXCR (Minecraft X Copy Region)** is a powerful, user-friendly, and server-performance-conscious building copy and paste plugin designed for the **Minecraft Bedrock Edition** server software, **Endstone**. It empowers players and administrators to easily select, save, preview, and load complex structures, all through an intuitive in-game menu system. With a focus on stability and performance, MXCR handles massive structures spanning thousands of chunks without crashing your server, thanks to its intelligent, asynchronous chunk management system. --- ## ✨ Key Features | Feature | Description | | :--- | :--- | | **Intuitive UI** | All functions are accessible via a clean, form-based menu. No need to memorize complex commands. | | **Advanced Chunk Management** | Asynchronously loads and processes structures chunk by chunk, preventing server lag and memory leaks, even with massive buildings. | | **Live Preview & Adjustment** | See a particle outline of your structure before you place it. Nudge it block by block or rotate it to get the perfect position. | | **Multi-level Permission System** | Fine-grained control over who can do what. From server OPs with full control to normal players with specific, limited permissions. | | **Undo/Redo System** | Made a mistake? No problem. Every paste and move operation can be undone and redone. | | **Progress Indicators** | For long operations, a Boss Bar shows the real-time progress, so you're never left guessing. | | **Persistent Database Storage** | Structures are saved securely in a local SQLite database, organized by player. | | **Highly Configurable** | Customize everything from selection tools and max block counts to enabling/disabling the entire permission system. | --- ## 🚀 Installation 1. Download the latest `endstone_mxcr-x.x.x-py3-none-any.whl` file from the [Releases](https://github.com/your-repo/MXCR/releases) page. 2. Place the `.whl` file into the `plugins` directory of your Endstone server. 3. Restart the server. The plugin will automatically generate its configuration files in the `plugins/MXCR` directory. --- ## 📖 Getting Started: Your First Copy & Paste Here’s how to copy your first building. ### 1. Start Selection Mode - Type `/mxcr` to open the main menu. - Click **[开始选区] (Start Selection)**. You'll receive a selection tool (a Wooden Axe by default). ### 2. Select the Area - **Position 1**: Use the selection tool (Wooden Axe) and right-click on a block to set the first corner of your selection. - **Position 2**: Right-click another block to set the second corner. A particle box will appear, showing your selected region. - **(Optional) Adjust**: If you need to change the second point, use the modification tool (a Stick by default) to right-click a new block. The particle box will update. ### 3. Save the Structure - Once you're happy with the selection, type `/mxcr ok` or click **[保存建筑] (Save Structure)** in the main menu. - A form will pop up. Give your structure a **name**. You can also configure options like excluding certain blocks or preserving air. - Click **Submit**. ### 4. Load the Structure - Open the main menu (`/mxcr`) and go to **[我的建筑] (My Structures)**. - Find your saved structure in the list and click on it. - Click **[加载] (Load)**. ### 5. Preview and Place - A particle preview of your structure will appear at your location. - The **Preview Panel** will open automatically (or use `/mxcr preview`). Use the buttons to move the structure (`↑`, `↓`, `←`, `→`, `Forward`, `Back`) or rotate it. - When you're satisfied with the position, click **[放置建筑] (Place Structure)**. - The plugin will paste the building, showing a progress bar for large structures. --- ## ⌨️ Commands While most functions are UI-based, MXCR also provides a full suite of commands. ### User Commands | Command | Description | | :--- | :--- | | `/mxcr` | Opens the main menu. | | `/mxcr start` | Enters selection mode. | | `/mxcr ok` | Confirms a selection and opens the save form. | | `/mxcr cancel` / `stop` | Exits selection mode. | | `/mxcr list` | Opens the "My Structures" list. | | `/mxcr undo` | Undoes the last paste/move operation. | | `/mxcr redo` | Redoes the last undone operation. | | `/mxcr preview` | Toggles the preview adjustment panel. | ### Admin & OP Commands These commands require the user to be a server Operator (OP). | Command | Description | | :--- | :--- | | `/mxcr reload` | Reloads `config.json` and `permissions.json`. | | `/mxcr op <player>` | Grants a player full access to MXCR. | | `/mxcr deop <player>` | Revokes a player's full access. | | `/mxcr oplist` | Lists all players[/MD]