### MagicBlock Changelog 3.1.6.1-3.2.0.1
#### `Feat`

1. **Anti-Duplication System**: Added a UUID-based anti-duplication system, with UUIDs stored in NBT. When a player holds a MagicBlock, duplicate blocks in their inventory are automatically detected and removed. This feature can be enabled or disabled in the configuration file. The update is backward compatible: missing UUIDs will be automatically added when a block is held.
2. **Shop Plugin Integration**: The `addtimes` command can now be executed from the console using `/mb addtimes <player> <times>`.
3. **Fully Customizable GUI**:
* The GUI is now fully customizable in `config.yml`, including options for: title, number of rows, all buttons (including disabled states), and decorative fillers' material, name, lore, and slots.
* All material options support ItemsAdder custom items (theoretically, not fully tested).
4. **Favorites Feature**:
* Added a block favorites feature. Players can right-click in the GUI to favorite blocks and view them in a dedicated favorites interface.
* The favorites list automatically filters out blocks the player does not have permission to use. Favorites data supports both database and JSON storage.

#### `Refactor`

1. **Data Storage Migration**: The plugin will automatically migrate binding data from `bindings.yml` to a new `bindings.json` file.
2. **Unified Config Structure**: All GUI-related text has been moved from language files (`lang_xx.yml`) to `config.yml`.
3. **Unified Console Message Style**: All command outputs in the console now use a consistent style.
4. **GUI Pagination Optimization**: The "Previous Page/Next Page" buttons are now always displayed and provide visual feedback by switching to a custom "disabled state" style when needed.
5. **`config.yml` Chinese Localization**: The default config comments and content are now in Chinese.

#### `Fix`

1. **Data Migration**: Fixed a crash issue caused by serialization errors during migration from `bindings.yml`.
2. **Container Placement Restrictions**: Improved the mechanism that prevents MagicBlocks from being placed in workbenches, furnaces, villagers, and other functional containers.
3. **Non-Stackable Blocks**: The UUID in NBT now prevents unintended stacking of identical blocks.

---

### **Update Instructions & Notes**

This update involves changes to data structures and configuration files. **Make sure to fully back up your server data before updating.**

1. **Data Migration**
* On first startup, the plugin will automatically migrate data from `plugins/MagicBlock/bindings.yml` to the new `plugins/MagicBlock/data/bindings.json`.
* The old `bindings.yml` will be backed up as `bindings.yml.bak`. Please ensure there are no errors in the console during migration.

2. **`config.yml` Changes**
* **Strongly Recommended**: Back up your old `config.yml`, let the plugin generate a new one, and then manually transfer your previous settings to the new file.
* **GUI Config (`gui`)**: This section has changed significantly. All GUI-related text, button materials, slots, disabled states, etc., are now configured in `config.yml`.
* **New Config Options**: Added relevant options for `anti-duplication` and `favorites` features.

3. **Shop Integration Usage Change**
* If you use a shop plugin, please update its executed command to `mb addtimes %player% <times>`.

Refactor:

1.String comparison method reconstruction

2.Reconstruction of physical event monitoring method

3.Significantly improve performance

Feat:

1.Increase Break permissions

**3.1.4-3.1.5-3.1.6 Update Contents:**
**Fixes:**
1. Fixed compatibility issues with the residence plugin.
2. Fixed state updates for wood and oxides.
3. Optimized the reload function—now most configuration options can be reloaded using the reload command. See the config.yml file for details.
4. Fixed issues where connection blocks, such as glass panes and fences, did not update their state after being removed.

**Features:**
1. Added the permission node magicblock.use. By default, regular players do not have this permission; if the use permission is set to false, players cannot use any related features.
2. Performance optimization: added the command /mb perf to view performance usage.
3. i18n support: now when adding new blocks, you do not need to add corresponding language keys in the language file. The plugin comes with a complete block language key mapping table.

**Notes:**
1. If you encounter any issues and do not receive a reply within 24 hours, please open an issue at https://github.com/Syferie/MagicBlock/issues.
2. For feature requests, please open an issue first instead of sending messages. Feature update requests via messages are not guaranteed a reply, but issues will be replied to when time allows.
3. Please test relevant features yourself before updating. There is no guarantee that the plugin is bug-free.
4. The plugin will automatically complete missing configuration keys, but it is still recommended to review the latest config file for detailed configuration explanations: https://raw.githubusercontent.com/Syferie/MagicBlock/refs/heads/main/src/main/resources/config.yml

MagicBlock Plugin Update Summary - Version 3.1.4
English Version
This update includes the following improvements and fixes:

• New MySQL Support: Added cross-server data sharing to resolve issues with binding recall functionality in server clusters.
• New Binding System Toggle: Added a configuration option to enable or disable the binding feature.
• Progress Bar PAPI Variable: Implemented progress bar as a PlaceholderAPI variable for use in lore and other places.
• Compatibility Improvement: Adjusted the plugin to be compatible with Minecraft 1.18.
• Bug Fixes:
  • Fixed magic-lore not supporting strikethrough (&m), ensuring format codes do not affect detection.
  • Fixed FoliaLib compatibility and null pointer exception issues for improved stability.
• Version Update: Updated from 3.1.3 to 3.1.4, optimized build process to reduce plugin size.

Summary: This update enhances cross-server support, compatibility, and user experience while fixing multiple issues for better flexibility and stability.

本次更新包含以下改进和修复：

• 新增 MySQL 支持：实现跨服数据共享，解决群组服中绑定召回功能失效的问题。
• 新增绑定系统开关：在配置文件中添加选项，允许启用或禁用绑定功能。
• 进度条 PAPI 变量：将进度条作为 PlaceholderAPI 变量提供，可在 lore 等地方自由使用。
• 兼容性改进：将插件调整为兼容 Minecraft 1.18 版本。
• 错误修复：
  • 修复 magic-lore 不支持删除线 (&m) 的问题，确保格式代码不影响检测。
  • 修复 FoliaLib 兼容性及空指针异常问题，提升稳定性。
• 版本更新：从 3.1.3 更新至 3.1.4，优化构建过程以减小插件体积。

总结：本次更新提升了跨服支持、兼容性和用户体验，修复了多项问题，增强了插件的灵活性和稳定性。

```
**Version 3.1.3**
* **New Features / Enhancements:**
* Added a plugin version update prompt.
* Added configuration option: Magic blocks can now be configured to disappear when their time runs out (resolve #11).
* Added automatic detection and key completion for missing keys in the configuration file.
* Lore now supports PlaceholderAPI (PAPI) variables (resolve #10, resolve #13).
* **Bug Fixes / Improvements:**
* Folia compatibility: Implemented a location-aware scheduler for explosion cleanup (fix #15).
* Refactoring magicfood (fix #7).
**Version 3.1.2**
* **New Features / Improvements:**
* Improved the permission setting mechanism for more precise control.
* Enhanced the command completion feature for a smoother user experience.
* Added help prompts to assist users in understanding command usage.
* **Bug Fixes:**
* Fixed an issue where certain commands had incorrect permissions, ensuring proper permission validation.
* Resolved a bug where the `additems` command did not increase the maximum number of items as expected, ensuring the item count behaves correctly.
```

Fixed a bug in the GUI where clicking the next page triggers multiple,It is highly recommended that you use this version of the plug-in

**MagicBlock 3.1.0 Changelog**
**New Features:**
* MagicBlock items now support multi-line lores (thanks to suggestion #3).
* Added config option to allow/disallow players using MagicBlocks bound by other players.
* Added support for Folia server (resolves #6).
**Fixes:**
* Fixed connection issues between fences, walls, glass panes, etc.
* Fixed a bug where MagicBlocks would be accidentally disintegrated in furnaces and workbenches.
* Fixed a bug where MagicBlocks would be accidentally replaced when players clicked on an item in their backpack.
* Fixed pressure plate redstone behavior and prevented attached blocks from dropping unexpectedly (resolves #9).
**Improvements:**
* Improved the configuration description in config.
**In summary,** this update mainly adds support for Folia server, implements multi-line lore support for MagicBlock items, and fixes several important bugs.

Update Suggestions (important) :
This update has adjusted the comments and order of configuration items in config file, added the configuration option of multiple lines of Lore and the switch of whether the binding system allows players to use other players to bind blocks. It is recommended to backup the original config file and re-generate config for pasting and replacement.

prevent magic blocks from dropping during chain TNT explosions

prevent magic blocks from dropping during chain TNT explosions

At present, the plug-in has been open source, please check the latest version of the plug-in through Github page has the corresponding update content, in addition, if you like it, please give me a Star or score, thank you very much

MagicBlock-2.1.0 更新内容： fix： 1. 修复部分魔术方块可以被放入工作台中被分解的BUG 2. 修复部分魔术方块挖掘掉落经验值的BUG add： 1 .增加新配置项，现在可以配置通过mb get指令获取的魔术方块的默认使用次数，默认值如下，如需更改可自行添加此项配置 default-block-times: 1000000000 2. 增加指令 mb addtimes <数字> 手拿魔术方块，可以使用该指令为手中的方块增加指定的使用次数

MagicBlock v2.2.0更新内容 优化: 1) 优化mb get指令，增加一项可选参数[times]，例mb get 200获取可以使用200次的魔术方块 2）优化消息反馈，当魔术方块次数用尽时，聊天栏会有消息提示玩家次数用===== 新增: 新增魔术食物，指令:mb getfood <material> [times] 可以获取指定种类的魔术食物，并且可以通过指令参数指定该魔术食物的使用次数，通过配置文件配置指定食物单次回复饱食度值。不填写times参数则默认为0.1B次。简单来讲 获取一个可以使用多次的食物。

MagicBlock v2.2.1 修复： 修复附着方块（灯笼、火把等）的被附着方块被破坏时，附着方块会掉落的问题。

MagicBlock v2.2.2 修复： 修复部分情况下，切换方块导致的刷物BUG，十分建议更新。


MagicBlock-2.1.0 Update Notes:
Fixes:
1. Fixed a bug where some magic blocks could be placed in the workbench and decomposed.
2. Fixed a bug where some magic blocks would drop experience points when mined.
Additions:
1. Added a new configuration option to set the default usage times for magic blocks obtained through the "mb get" command. The default value is as follows, and can be changed by adding this configuration:
default-block-times: 1000000000
2. Added the command "mb addtimes <number>" which allows you to increase the usage times of the magic block in your hand.
MagicBlock v2.2.0 Update Notes:
Optimizations:
1. Optimized the "mb get" command by adding an optional parameter [times], e.g., "mb get 200" to get a magic block that can be used 200 times.
2. Improved message feedback. When a magic block's usage times run out, a message will notify the player in the chat.
Additions:
1. Added magic food. Command: "mb getfood <material> [times]" allows you to get a specified type of magic food and set its usage times through command parameters. The configuration file can specify the hunger value restored per use. If the [times] parameter is not specified, the default is 0.1B times. In short, you can get food that can be used multiple times.
MagicBlock v2.2.1 Fixes:
Fixed an issue where attached blocks (lanterns, torches, etc.) would drop when the block they were attached to was destroyed.
MagicBlock v2.2.2 Fixes:
Fixed a bug where switching blocks in certain situations would cause item duplication. Highly recommended to update.