InsightHUD

🚀 InsightHUD – Update Changelog V1.1.0

This update expands InsightHUD beyond a customizable in-game HUD and introduces new tools for server owners, players, and developers.

🛠️ New: Server Configuration Support

• Added a server-side config.properties file (Folder: Davinciio_InsightHUD)
• Server owners can now define global default settings
• These defaults are automatically applied when a player joins the server for the first time
• Configuration file now includes clear English comments for every available setting
• Invalid or broken config values are now safely ignored and replaced with internal fallback values
• This ensures the HUD continues to function even if the config file contains unsupported values

🔒 New: Force Mode for Server Owners

• Added optional force mode to the server configuration
• When enabled, server-defined settings override player preferences
• Players can no longer freely change forced settings in the UI
• Useful for curated servers, roleplay servers, hardcore servers, or consistent visual setups

🌍 New Language Support

• Added full Brazilian Portuguese language support
• Expanded localization coverage for a wider international audience
• InsightHUD is now available in:
  • English
  • German
  • French
  • Spanish
  • Brazilian Portuguese

🔌 New: Developer API

• Added a public InsightHUD API for third-party mod integrations
• External mods can now add custom HUD content without modifying the core mod
• API includes:
  • Custom Info Providers for additional HUD lines and messages
  • Observation Contributors for extending target/context detection
  • Read-only Context Snapshots for safe access to current HUD state
  • World Time / Location Snapshots for time, phase, moon, region, zone, and biome fallback
  • Change Events for relevant state transitions
• The API is designed with performance, stability, and safe integration in mind

🧠 Developer Notes / API Overview

InsightHUD integrations are intended to be lightweight, snapshot-based, and non-invasive.

• Use the API to add small, contextual HUD information
• Read from provided snapshots instead of performing your own expensive world logic
• Avoid chunk scans, worldgen access, file IO, network requests, or heavy calculations in callbacks
• Use namespaced IDs such as mymod:machine_status or mymod:night_warning
• Register providers on startup and unregister them on shutdown

Example integration concept:

• Show custom machine state from another mod
• Add warnings during night time in specific regions
• Display custom animal or structure information in the existing HUD flow

The goal of the API is not to replace the HUD, but to let other mods extend InsightHUD safely and cleanly.

♻️ New Reload Command

• Added /insighthudreload to reload the server configuration without restarting the server
• Added alias: /ihsreload
• Allows faster iteration and easier administration for server owners

⚙️ Configuration Improvements

• Improved config file generation
• Added human-readable comments for supported properties
• Corrected documented HUD position values to match actual supported values
• Improved resilience against invalid configuration entries
• Internal defaults are now used automatically when config values are missing or invalid

🎨 HUD & Settings Improvements

• Server-controlled settings now integrate more cleanly with the existing settings system
• New-player defaults are applied in a more predictable way
• Improved consistency between player settings, server defaults, and forced settings

🧱 Stability & Architecture Improvements

• Hardened API behavior for safer third-party integrations
• Improved fail-safe handling in multiple config-related paths
• Continued focus on InsightHUD’s core design goals:
  • Lightweight
  • Modular
  • Performance-first
  • No gameplay impact

📌 Commands

• /insighthudsettings – Opens the InsightHUD settings page
• /ihs – Alias for settings
• /insighthudreload – Reloads server configuration
• /ihsreload – Alias for reload

💬 Summary

• Added server-side configuration support
• Added force mode for server owners
• Added Brazilian Portuguese localization
• Added a public developer API
• Added reload command and alias
• Improved config safety and fallback behavior
• Improved overall integration architecture

You don’t just see the world — you understand it.