AlignmentBar - Reputation System for Minecraft

AlignmentBar is a fully customizable Minecraft mod that enables tracking of your reputation (alignment) with various factions, regions, or groups within the game world.

The mod offers the following capabilities:

Reputation display interface above character heads showing faction attitudes toward the player. Special faction management screen that organizes them by regions, tracks alignment progress, and displays inter-faction relationships. Pledge system allowing players to officially join specific factions. Complete synchronization of faction data on the server - clients don't need to pre-install faction files.

Mod Features

📊 Personalized reputation tracking for each faction 🏹 Enemy and ally detection among mobs (configurable) 🛡️ Rank system and progression within factions 🗺️ Regional categorization 🤝 Inter-faction relationships (allies/enemies/neutral) 📡 Multiplayer support - faction data automatically synchronizes from server to clients 🎨 Custom faction logos displayed in interfaces and labels

Getting Started (JSON Setup)

To use the mod, you need to create JSON files defining your factions. Place them in the following directories:

Singleplayer: config/alignmentbar/factions/ Multiplayer (Server): config/alignmentbar/factions/

Example Faction JSON File:

{
  "id": "knights_order",
  "name": "Knights of Valor",
  "color": "#4C9AFF",
  "description": "An ancient order sworn to protect the realm.",
  "logo": "alignmentbar:faction_logos/knights.png",
  "region": "Central Kingdom",
  "ranks": [
    { "id": "initiate", "name": "Initiate", "alignment": 50.0 },
    { "id": "knight", "name": "Knight", "alignment": 150.0 },
    { "id": "paladin", "name": "Paladin", "alignment": 300.0 }
  ],
  "enemies": [
    { "entity": "minecraft:zombie" },
    { "entity": "minecraft:skeleton" }
  ],
  "allies": [
    { "entity": "minecraft:villager" }
  ]
}

What Can Be Customized:

id: Unique internal identifier name: Display name color: HEX color for interface description: Text displayed in faction screen logo: ResourceLocation for logo texture region: Grouping factions by geographical or thematic regions ranks: Defining alignment threshold values and rank names enemies/allies: Entities affecting reputation increase/decrease

Developer Notes

Reputation can be increased through actions you define (such as killing mobs, completing quests, etc.). Faction relationships and reputation levels are persistently tracked for each player. Works in both singleplayer and multiplayer modes.

Important: The mod doesn't work "out of the box." You, as the server or modpack author, must define your own factions through JSON files. This allows customizing AlignmentBar for any RPG, faction wars, or immersive gameplay experience.