Changelog

All notable changes to the BlockEditor mod will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2025-10-19

🎉 Initial Release

BlockEditor is now available! A powerful Minecraft mod for creating custom colored blocks with WorldEdit integration.

✨ Added

Core Features

• Custom block creation GUI accessible with keybind (default: G)
• Support for 8 different block types: Wool, Stone, Dirt, Sand, Concrete, Deepslate, Wood, and Base Dynamic Block
• Hex color input system supporting any 6-digit color code (e.g., FF0000 for red)
• Real-time color preview in the GUI interface
• Smart numbered user block system (user_wool1, user_stone1, etc.)
• Automatic block assignment and organization

WorldEdit Integration

• Full compatibility with WorldEdit commands
• Use custom blocks in any WorldEdit operation:
  • //set blockeditor:user_wool1
  • //replace stone blockeditor:user_stone1
  • //walls blockeditor:user_concrete1
• Seamless integration with existing WorldEdit workflows

Persistence System

• Custom blocks persist across world saves and reloads
• Server restart compatibility
• Automatic data synchronization between client and server
• NBT-based storage for reliable data preservation

Commands System

• /be clear - Removes all custom user blocks from the world
• /be refresh - Refreshes custom block colors in a 16-block radius around player
• Operator-level permissions required for commands (OP level 2)

User Experience

• Pick block functionality (middle-click) for custom blocks in creative mode
• Intuitive GUI with search functionality for block types
• Color picker with hex code input
• Visual block preview before creation
• Smooth client-server synchronization

🔧 Technical Implementation

Performance Optimizations

• Smart color application system that only runs when needed
• Efficient block entity management
• Minimal server impact with optimized data storage
• Clean console output with reduced debug logging
• Background-free GUI rendering for better performance

Compatibility

• Minecraft 1.20.1 support
• Forge 47.4.0+ compatibility
• Java 17+ requirement
• Works in both single-player and multiplayer environments
• No external mod dependencies (WorldEdit optional)

Architecture

• Modular block system supporting easy expansion
• Registry-based user block management
• Client-side color registration for proper rendering
• Server-side authoritative data storage
• Event-driven WorldEdit integration

🎮 Keybinds

• G - Open Block Editor GUI (configurable in controls settings)

📋 Supported Block Types

• Dynamic Block (base type)
• Wool variants
• Stone variants
• Dirt variants
• Sand variants
• Concrete variants
• Deepslate variants
• Wood variants

🌐 Multiplayer Features

• Full server compatibility
• Proper client-server synchronization
• Shared custom block registry across all players
• Admin controls via commands
• No client-side modifications required for players

📦 Installation Requirements

• Minecraft: 1.20.1
• Mod Loader: Forge 47.4.0 or higher
• Java: Java 17 or newer
• Optional: WorldEdit (for enhanced building capabilities)

🔮 Future Roadmap

• Additional block type support
• Texture customization options
• Color palette presets
• Advanced WorldEdit command integration
• Multiple Minecraft version support

📝 Notes for Version 1.0.0

This initial release represents a complete and stable implementation of the BlockEditor concept. All core features are fully functional and thoroughly tested in both single-player and multiplayer environments.

Known Limitations:

• Limited to 8 base block types (expandable in future versions)
• Hex color input only (no RGB sliders yet)
• Manual refresh required in rare client desync cases

Stability:

• Extensively tested with large WorldEdit operations
• Memory efficient for worlds with thousands of custom blocks
• Compatible with most popular Minecraft mods

Ready for production use on servers and in creative builds! 🚀