KFactions

KFactions

Modern • Lightweight • GUI-Based

The perfect plug-and-play solution for Minecraft 1.21

KFactions removes complex land claiming to focus on social teaming and raiding. With full GUI management, custom Hex colors, and PlaceholderAPI support, it is designed for modern Survival and SMP servers.

---

✨ Key Features

• 100% GUI Management
  Forget memorizing complex commands. Players can manage invites, kick members, view info, and change settings entirely through immersive "Glass Pane" style menus.

• Built-in Chat Tags
  Faction tags appear automatically in chat and the tab list right out of the box. No external chat manager plugins required! (Can be toggled off).

• Custom Hex Colors
  Give factions a unique identity. Supports standard colors and full Hex Codes (e.g., #00FFFF) via a visual color selector.

• Integrated Chat Modes
  Instantly toggle between Public Chat and private Faction Chat using /cf and /cp.

• PlaceholderAPI Support
  Seamlessly hook into plugins like EssentialsChat, TAB, and scoreboards using placeholders like %kfactions_tag%.

• No Land Claiming
  Intentionally built without claiming mechanics to encourage "Open PvP" and raiding.

• Lightweight & Fast
  Optimized for performance with flat-file storage (YAML). No database setup required.

---

📜 Commands

Alias: /faction also works!

General

• /f - Opens the main faction GUI menu.
• /f create - Creates a new faction.
• /f join - Joins an existing faction.
• /f leave - Leaves your current faction.
• /f list - Opens a GUI listing all active factions.
• /f info [name] - Displays detailed faction info.

Management

• /f invite - Invites a player (or opens Invite GUI).
• /f kick - Kicks a member.
• /f delete - Permanently disbands your faction (Owner only).
• /f modify color - Changes faction color.
• /f modify owner - Transfers ownership.

Chat

• /chat <public|faction> - Toggles chat mode.
• /cp - Shortcut for Public Chat.
• /cf - Shortcut for Faction Chat.

Admin

• /f reload - Reloads config files.
• /f toggletags - Globally toggles faction tags.

---

🧩 Placeholders

Requires PlaceholderAPI installed.

• %kfactions_name%
  Returns the raw name of the faction (e.g., Vikings).

• %kfactions_tag%
  Returns the formatted tag with brackets and color (e.g., [Vikings]).

• %kfactions_color%
  Returns the raw color code or Hex (e.g., #FF0000).

• %kfactions_role%
  Returns the player's role (Owner/Member).