FastGUI 6.9.8 更新日志

更新时间

2026-01-20

版本信息

• 当前版本：6.9.8
• 上一版本：6.8.6

更新内容（中文）

1. 新增功能

• 添加 FGCD 命令系统：新增 /fgcd 命令，支持玩家创建、删除和列出命令事件
• FGCD 命令支持持久化存储，重启服务器后仍然生效
• FGCD 命令支持世界特定命令事件，不同世界可配置不同命令

2. NPC 功能优化

• 优化 NPC 交互系统：修改 NPC 点击事件处理逻辑
• 修复 NPC 命令执行问题：解决 NPC 命令执行器设置不正确的问题
• 更新 NPC NBT 结构：优化 NPC 数据存储结构，支持权限等级和执行器信息

3. 交互物品功能优化

• 修改交互物品处理：优化 ButtonItem 点击事件
• 修复权限检查问题：解决非 OP 玩家无法使用 OP 权限物品的问题
• 优化命令参数解析：修复带引号命令的参数解析问题

4. 其他优化

• 更新 UI 权限系统：支持通过 np/op 设置权限节点，控制谁可以打开特定 UI
• 优化命令补全：改进 /fg 命令的自动补全功能
• 修复命令格式错误：更新 /fg set 命令参数格式为 /fg set id <源UI名> <要改的名字>

5. 版本兼容性

• 全面支持 1.21.x：此版本已在所有 1.21.x 版本进行测试
• 稳定性提升：修复多个稳定性问题，提升插件运行可靠性

更新内容（English）

1. New Features

• Added FGCD Command System：Added /fgcd command to create, delete, and list command events
• FGCD commands support persistent storage, surviving server restarts
• FGCD commands support world-specific command events, different worlds can have different commands

2. NPC Function Optimization

• Optimized NPC Interaction System：Modified NPC click event handling logic
• Fixed NPC Command Execution：Resolved issues with NPC command executor settings
• Updated NPC NBT Structure：Optimized NPC data storage structure, supporting permission levels and executor information

3. Interactive Item Function Optimization

• Modified Interactive Item Handling：Optimized ButtonItem click events
• Fixed Permission Check Issues：Resolved problems with non-OP players using OP permission items
• Optimized Command Parameter Parsing：Fixed parameter parsing for quoted commands

4. Other Optimizations

• Updated UI Permission System：Added support for setting np/op permission nodes for UIs, controlling who can open specific UIs
• Improved Command Completion：Enhanced auto-completion for /fg commands
• Fixed Command Format Errors：Updated /fg set command parameter format to /fg set id <source_ui_name> <new_name>

5. Version Compatibility

• Full Support for 1.21.x：This version has been tested on all 1.21.x versions
• Stability Improvements：Fixed multiple stability issues, enhancing plugin reliability

测试状态

• ✅ 已在所有 1.21.x 版本测试通过
• ✅ 新增功能测试完成
• ✅ 修复的问题已验证
• ✅ 性能优化已确认

注意事项

• 建议在更新前备份原有数据
• 本版本与之前版本完全兼容，无需额外配置
• 如需帮助，请使用 /fg help 命令查看帮助信息

FastGUI v6.8.6 Update Log

New Features

1. Container Compatibility

• Supports UI interfaces for small chests, large chests, dispensers, and droppers
• Removed support for hopper containers (due to technical limitations preventing stable compatibility)
• No longer supports UI interfaces for other container types

2. UI Interface Optimization

• Dispenser/dropper interfaces use a clean 9-slot single row layout
• Optimized UI data storage format for improved loading efficiency
• Removed compatibility layers for old UI data versions, focusing on version 5 UI data format

3. User Experience

• Added version too low prompt to help users understand they need to recreate UI
• Improved error messages to provide clearer operation guidance
• Supports multilingual display, all prompts have both Chinese and English translations

Notes

• When using /fg add command, you can only create UI on supported containers
• UI created in old versions will automatically use the default container type (chest)
• Dispenser/dropper interfaces use a 9-slot single row layout, no longer attempts to restore 3x3 structure

*Note: This version focuses on stable usage of core containers and no longer provides full container compatibility. Additionally, we have updated the language files. The server may need to delete the lang folder and regenerate it to synchronize the translations.

FastGUI v5.8.6 Update Log

New Features

1. Cache Management Command

• Added /fg refresh command: Added functionality to clear all cached loaded UIs
• Cache clearing feedback: Displays the number of cleared UIs after command execution
• Debug logging support: Records detailed information about cache clearing operations when debug mode is enabled

Feature Details

/fg refresh Command

• Functionality: Clears all cached loaded UIs, forcing reload from files on next access
• Purpose: Allows administrators to force the plugin to re-read UI files when they've been modified externally
• Permission requirement: Requires fastgui.admin permission
• Feedback information: Shows the number of cleared UIs to help administrators understand the scope of the operation
• Debug information: When debug mode is enabled, logs which administrator performed the cache clearing and how many UIs were affected

Bug Fixes

1. Language File Extraction Issue

• Fixed issue where only en.yml was extracted on first install: Now both zh.yml and en.yml language files are extracted
• Fixed default language setting issue: Default language is now correctly set to zh.yml instead of en.yml
• Root cause: In the LanguageManager.extractDefaultLanguageFilesIfNeeded method, previously only the en.yml file was extracted, not the zh.yml file

2. Removed Redundant Interface Command

• Removed /fg set Interface command: Because the Display functionality has already replaced the Interface functionality
• Simplified command structure: Now only ID and Display property setting options are retained
• Updated help information: Removed Interface-related help text

Compatibility

• Minecraft Version: 1.13 - 1.20
• Dependencies: No additional dependencies required
• Backward Compatibility: Fully compatible with existing UI files and configurations

*Note: Language files have been updated. Server administrators need to delete the lang folder to allow the plugin to regenerate it with the new translations.

FastGUI v5.7.6 Update Log

Release Date: December 21, 2025

Major Updates

1. UI Data Structure Optimization

• Added Display Name Field: Added a display name field to the header of UI DAT files
• Improved Name Management: Interface display names are now stored independently from filenames, providing a more flexible naming system
• Backward Compatibility: Existing UI files are automatically compatible with the new structure, and old files will automatically add the display name field on first access

2. /fg set Command Enhancement

• Display Name Update: The /fg set <interface_name> id <newID> command now updates both filename and display name
• Independent Display Name Setting: Added /fg set <interface_name> display <display_name> subcommand to set interface display name separately
• Smart Name Handling: When only setting ID, the display name automatically updates to the new ID; when setting display name, the filename remains unchanged

3. UI Display System Improvement

• Dynamic Name Reading: When players open an interface, the system now reads and displays from the display name field in the DAT file
• Enhanced Multi-language Support: Display names support multi-language variable replacement, such as {player}, {time}, etc.
• Name Formatting: Support for color codes and formatting codes in display names

Technical Improvements

• Data Structure Optimization: Restructured DAT file format, adding version identifier and display name field
• Memory Usage Optimization: Improved UI data loading and caching mechanisms
• Enhanced Error Handling: Added more comprehensive file corruption detection and repair mechanisms
• Performance Boost: Optimized UI opening and name reading performance

Compatibility Notes

• This version is fully compatible with existing interface data and configuration files
• After upgrade, existing UI files will automatically add display name field on first access (defaulting to filename)
• New display name functionality does not affect existing plugins and commands
• Table.dat registration information will automatically update to support the new display name system

Known Issues

• None

Upgrade Recommendations

1. Backup existing FastGUI data folder
2. Stop the server
3. Replace plugin files
4. Start the server and check console logs
5. Test interface renaming and display name setting functionality
6. Verify normal opening and display of existing interfaces

New Command Examples

# Rename interface (updates both filename and display name)
/fg set oldname id newname

# Set only display name (filename unchanged)
/fg set myui display "My Custom Interface"

# Set display name with color codes
/fg set myui display "&6&lGolden Interface"

FastGUI v4.7.6 Update Log

Release Date: December 21, 2025

Major Fixes

1. /fg set Command Fix

• Fixed issue where /fg set command did not update Table.dat registration information when modifying interface names
• Fixed issue where interface renaming did not synchronize folder names in "FastGUI\Fast GUI Database Folder"
• Fixed issue where interface renaming did not synchronize .dat data file names
• Now executing /fg set <interface_name> id <newID> command will completely update all related files and registration information

2. Multi-language Switching Bug Fix

• Fixed issue where custom language files (like jp.yml) appeared in command tab completion but showed "not found" when switching
• Improved language file loading mechanism to ensure language file list is reloaded before switching languages
• Removed zh/en language code restrictions, now supports any custom language files
• Optimized language switching error messages, now maintains current language instead of forcing default language

3. Code Structure Optimization

• Complete Removal of JSON Compatibility Code:
  • Removed JSON string parameters and processing logic from ERRORNULL.NULL
  • Removed JSON parsing methods from ERRORNULL.NULL (ERRORNULL.NULL, ERRORNULL.NULL)
  • Removed JSON compatibility check code from ERRORNULL.NULL
  • Updated all related comments, changing JSON format to NBT format
• Unified use of NBT tag system for managing item properties, improving code consistency and performance
• Optimized item creation and property setting processes
• Reduced code redundancy and improved maintainability

Technical Improvements

• NBT System Unification: All item properties are now completely managed through NBT tags, no longer relying on JSON strings
• Enhanced Error Handling: Improved error handling mechanisms during language switching and interface renaming processes
• Performance Optimization: Reduced unnecessary string parsing and object creation
• Code Comment Updates: Updated all outdated comments to ensure documentation remains consistent with code

Compatibility Notes

• This version is fully compatible with existing interface data and configuration files
• After upgrade, existing JSON format items will be automatically converted to NBT format (if they exist)
• Language file format remains unchanged, but it's recommended to check the integrity of custom language files

Known Issues

• None

Upgrade Recommendations

1. Backup existing FastGUI data folder
2. Stop the server
3. Replace plugin files
4. Start the server and check console logs
5. Test language switching and interface renaming functionality