InsightHUD

🧠 Core Features

🔍 Entity Insight System

• Displays real-time behavior and state of entities
• Detects conditions like alerted, tamed, idle, or hostile
• Enhanced NPC understanding with context-aware roles and capabilities
• Prioritizes accurate context using a multi-source resolver system
• Provides clear, structured information directly in-game

---

🐾 NPC & Creature Immersion

• Fully reworked NPC and creature detection system
• Supports HyCitizens NPCs with deep integration
• Displays custom NPC names from HyCitizens instead of generic entity names
• Displays behavior, mood, and activity in a natural way
• Capability system for interactions such as tameable, pettable, rideable, and tradable
• Smart icon handling – no more broken or empty icon slots
• NPCs can have custom icons instead of a question mark
• Automatic fallback to no-icon layouts for better immersion

---

🛒 Shop Integration

• Supports YetAnotherShop integration
• Displays linked shop information directly in the HUD
• Shows the actual shop name instead of only the linked block or entity name
• Improved HUD header handling for third-party shop and interaction systems
• Designed to keep shop information clean, readable, and immersive

---

🌾 Farming HUD

• Shows crop growth status at a glance
• Highlights when crops are ready to harvest
• Clean and minimal display without clutter
• Designed for efficient farming workflows

---

⚙️ Processing & Workbench Insights

• Displays processing progress for benches and stations
• Visual feedback for active and idle states
• Helps you track production without opening interfaces
• Supports multiple container and workbench types
• Improved layout spacing for processing stations, salvagers, tanneries, and similar benches

---

📦 Container Insights

• Displays container contents directly in the HUD when available
• Improved spacing for chests and item containers with visible contents
• Adaptive height handling keeps item previews readable without unnecessary empty space

---

🎨 Clean & Immersive HUD

• Structured layout with clear hierarchy (header + content)
• Minimal, readable design that fits naturally into the game
• Adaptive layout – automatically removes unused UI elements
• Adjustable position and offsets
• Customizable HUD scale, spacing, icon size, and behavior
• Selectable HUD background styles for a more personalized look

---

⚙️ Advanced Settings UI

• Modern multi-column layout
• Sliders for precise control such as size, distance, spacing, offsets, and icon size
• Dropdowns for position, language, and HUD background style
• Reworked options aligned with immersive gameplay semantics
• Designed for fast and intuitive configuration

---

🛠️ Server Configuration

• Server owners can define global default settings
• Defaults are automatically applied on first player join
• Optional force mode to enforce settings for all players
• Server-side defaults also support HUD appearance options such as background style
• Fail-safe config system – invalid values are ignored safely

---

🔌 Developer API

• Public API for third-party mod integrations
• Add custom HUD information via Info Providers
• Extend detection using Observation Contributors
• Access context safely via read-only snapshots
• Flexible header handling for custom integrations
• Designed for performance and stability

---

🌍 Localization Support

• Available in:
  • English
  • German
  • French
  • Spanish
  • Brazilian Portuguese
• Fully integrated language system
• Localized settings labels for HUD appearance options

---

🧠 Smart Architecture

• Modular system with:
  • Behavior resolvers
  • State detection
  • Info providers
  • Observation contributors
  • Debug tools
• Optimized for performance and stability
• Built for extensibility and future features

---

Commands

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

---

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