ForgeTowns Changelog

v0.2.0-alpha (2025-04-18) – Alpha Menu Sync & NeoForge Networking Update

⚠️ IMPORTANT: This is an ALPHA release and may not work correctly. Use for testing only! ⚠️

This update brings major improvements to menu synchronization, networking, and NeoForge 1.21.1 compatibility. It is still an alpha version and may contain bugs or incomplete features.

---

Improvements & Fixes

• Menu Synchronization Handshake

  • The Town Menu now waits for up-to-date town data before opening, preventing stale or missing information.
  • Added a handshake system: the client confirms receipt of fresh town data before the menu opens.

• Networking & Packet Direction

  • Introduced SyncConfirmPacket for client-to-server sync confirmation.
  • All packets are now registered with the correct direction for NeoForge 1.21.1, fixing previous network errors and disconnects.

• Server-Driven Menu Logic

  • The server queues menu opens and only triggers them after the client confirms data sync.
  • Prevents race conditions and improves UI reliability.

• Error Handling & Stability

  • Fixed NullPointerExceptions and disconnects related to missing menu data.
  • Improved error messages for non-town members and sync failures.
  • Debug logging added for easier troubleshooting.

• Compatibility

  • Further migration to NeoForge 1.21.1 APIs.
  • Improved packet registration, menu opening, and event handling.

---

Features (unchanged from v0.1.0-alpha)

• Town creation and management system
• Chunk claiming functionality
• Plot management with customizable pricing
• Nation creation and management
• Basic town economy with upkeep costs
• Simple GUI for town management

---

Known Issues

• Alpha Quality: Many features are still experimental or incomplete.
• NeoForge 1.21.1: Some compatibility issues remain (especially with items, capabilities, and registries).
• Item Handling: Some item/block features may not function correctly due to upstream API changes.
• Capability System: Integration is still in progress.
• Block Entity & Player Interaction: Some features may be broken due to ongoing migration.
• Network System: Some edge cases may cause sync delays or UI glitches, especially under high latency.
• General: Expect bugs and incomplete features—please back up your worlds!

---

Configuration

• Server owners can modify settings in config/forgetowns-server.properties
• Adjustable town creation costs, upkeep, and size limits
• Configurable nation settings

---

Next Steps

• Continue fixing compatibility issues with NeoForge 1.21.1
• Improve GUI functionality and appearance
• Add more advanced town and nation management features
• Enhance plot system capabilities
• Complete the migration of all systems to new NeoForge APIs

---

Please report any bugs or issues you encounter. This mod is under active development, and your feedback is valuable!