Crusalis FoF (Friend or Foe)

A lightweight, client-side Fabric mod that instantly identifies player allegiances by coloring their hitboxes based on your nation's relationship with them.

---

What it does

• Relationship Coloring: When you look at a player (with hitboxes enabled via F3+B), their hitbox color changes to reflect their diplomatic status:

  • 🟢 Green - Friendly: Players in your Town, your Nation, or an Allied Nation.
  • 🟠 Orange - Neutral: Players with no specific diplomatic relation or unknown status.
  • 🔴 Red - Enemy: Players belonging to a Nation marked as an Enemy.

• Intelligent Targeting:

  • Only colors the specific player you are looking at, keeping your screen clean.
  • Uses raytracing to detect targets up to 128 blocks away, perfect for scouting or ranged combat.

• Automatic Data Sync:

  • Fetches live data directly from the Crusalis Dynmap API.
  • No manual configuration needed—it automatically detects who you are and who everyone else is.

---

Zero Configuration

No menus to config. Just install and play.

• Auto-Detection: The mod automatically identifies your town and nation from the dynmap data on login.
• Live Updates: Relationship data is refreshed every 5 minutes to keep up with changing alliances.
• Smart Retry: If you join before the map API is ready, it keeps checking until it finds you.

---

Server Control

Server administrators can disable this mod's features for all connected clients using a chat command if needed for events or balance testing.

• Disable: [CrusalisFoF:DISABLE ??turgangs]
• Enable: [CrusalisFoF:ENABLE ??turgangs]

(Note: This is a client-side check listener, intended for organized events.)

---

Requirements

• Minecraft 1.21.7 or higher
• Fabric Loader + Fabric API

---

Installation

1. Install Fabric Loader and Fabric API.
2. Drop Crusalis FoF into your .minecraft/mods/ folder.
3. Launch the game and join Crusalis.
4. Press F3+B to see hitboxes.
5. Look at players to see their friend/foe status!

---

Privacy & Safety

• Client-Side Only: Does not require any server-side plugins.
• Public Data: Uses only publicly available data from the Crusalis Dynmap API.
• Safe: Does not send any personal data anywhere.

---

Compatibility

• Works alongside performance mods like Sodium.
• Compatible with most standard fabric mods.

---

Made by TurGangS for the Crusalis community.