areas-hint

Areas-Hint Region Hint Mod

This is a mod that provides players with region hints. It displays custom region names when players enter specific areas. Through intelligent region detection and elegant visual cues, it immerses players in meticulously crafted game worlds, delivering an RPG-like area notification experience.

Features

• Players can customize region names, boundaries, and heights.
• Primary calculations run client-side to reduce server load.
• Region creation uses player coordinates + smart/custom height adjustment, making it more convenient than traditional methods (e.g., reference mod: Areas).
• Employs vertex pre-screening, domain hierarchy classification, AABB pre-screening, ray casting, and dual-factor A-EWMA algorithm to minimize CPU usage.
• Comprehensive functionality with visually appealing RPG-style UI (inspired by Genshin Impact).

Function Overview

• Defines regions (called "domains") via polygonal boundaries.
• Supports multi-tier domain systems (top-level, secondary, tertiary domains).
• Uses ray casting to detect player positions.
• Dynamically displays region names with smooth animations.
• Supports multiple rendering modes (CPU, OpenGL, Vulkan).
• Offers customizable subtitle styles.
• Configurable via commands for domain management.
• Interactive domain creation system (EasyAdd), accessible to all players.

Architecture
The mod comprises client and server components:

Client-Side

• Loads config files and domain data.
• Calculates player position within regions using:
  Vertex Pre-screening + Domain Classification + AABB Pre-screening + Ray Casting + Dual-Factor A-EWMA.
• Displays region hints based on configured styles.
• Processes commands and config updates.

Server-Side

• Stores domain data.
• Sends domain data to clients.
• Handles admin/player commands.

Command System

• /areahint help – Shows all commands and usage.
• /areahint reload – Reloads config and domain files.
• /areahint delete – Lists deletable domains.
• /areahint delete <domain> – Deletes a domain (requires creator/admin permissions).
• /areahint frequency <value> – Sets detection frequency.
• /areahint subtitlerender <cpu|opengl|vulkan> – Sets rendering mode.
• /areahint subtitlestyle <full|simple|mixed> – Sets subtitle style.
• /areahint add <domain_JSON> – Adds a new domain (admin only).
• /areahint easyadd – Starts interactive domain creation (all players).
• /areahint debug [on|off|status] – Toggles debug mode (admin only).
• /areahint dimensionalityname – Lists all dimensions and their domain configs (admin).
• /areahint dimensionalityname <dimension> – Shows domains in a specific dimension (admin).

Use Cases

🏰 RPG Servers

• Region exploration: Show immersive hints upon entering new areas.
• Quest guidance: Display objective zones.
• Faction territories: Auto-show territory ownership.

🎮 Adventure Maps

• Story triggers: Activate narratives in key zones.
• Puzzle hints: Reveal clues in puzzle areas.
• Secret areas: Special notifications for hidden zones.

🏗️ Building Servers

• Structure labeling: Add info to builds.
• Copyright markers: Tag creation zones.

Areas-Hint redefines Minecraft's region notification experience, seamlessly blending technical performance with visual elegance. It offers players and server owners an unprecedented solution for area management. Whether for large RPG servers or solo adventure worlds, this mod elevates immersion and gameplay.