VirnorArmor

A Minecraft plugin that colors player armor based on faction relations or PlaceholderAPI placeholders.

Version: 1.5.0
Minecraft: 1.8.x - 1.21.x (Single JAR!)
Requires: ProtocolLib, PlaceholderAPI

Features

• 🎨 Per-viewer armor coloring - Each player sees armor colors based on their own faction relation
• ⚔️ SaberFactions support - Uses relational placeholders for accurate faction colors
• 🔌 PlaceholderAPI support - Use any PAPI placeholder for colors
• ⚡ ProtocolLib powered - Smooth packet-based armor updates
• 🛡️ Configurable armor types - Choose which armor types to colorize
• 🎮 In-game settings GUI - Players can customize their experience
• 🎯 Custom colors - Players can choose preset colors or enter custom RGB
• 🔄 Multi-version support - Works on 1.8 through 1.21 with a single JAR

Commands

Command	Description	Permission
/va	Opens settings menu	virnorarmor.use
/va menu	Opens settings menu	virnorarmor.use
/va info	Shows plugin info	-
/va reload	Reloads config	virnorarmor.admin

Permissions

Permission	Description	Default
virnorarmor.*	All permissions	op
virnorarmor.use	Access to settings menu	true
virnorarmor.admin	Admin commands	op

Installation

1. Download VirnorArmor.jar
2. Install ProtocolLib
3. Install PlaceholderAPI
4. (Optional) Install faction plugin expansions: /papi ecloud download Factions
5. Place VirnorArmor.jar in your plugins folder
6. Restart server
7. Configure config.yml

Configuration

Color Modes

SaberFactions Mode (per-viewer):

color-system:
  mode: "saberfactions"
  saberfactions-placeholder: "%rel_factionsuuid_relation_color%"

PAPI Mode (single color):

color-system:
  mode: "papi"
  papi-placeholder: "%luckperms_prefix%"

Armor Types

Enable/disable coloring for specific armor types:

armor-types:
  leather: true
  chainmail: true
  iron: true
  golden: true
  diamond: true
  netherite: true
  turtle: false
  elytra: false
  paper: true

Faction Colors

Customize colors for each relation:

faction-colors:
  MEMBER:    # Same faction - Green
    red: 85
    green: 255
    blue: 85
  ALLY:      # Allied faction - Pink
    red: 255
    green: 85
    blue: 255
  TRUCE:     # Truce - Purple
    red: 170
    green: 0
    blue: 170
  NEUTRAL:   # Neutral - White
    red: 255
    green: 255
    blue: 255
  ENEMY:     # Enemy - Red
    red: 255
    green: 85
    blue: 85

Player Settings

Players can open /va menu to:

• Toggle own armor visibility
• Toggle others' armor visibility
• Choose own armor color:
  • Use name color (default)
  • Select preset color
  • Enter custom RGB values

Dependencies

• Required: ProtocolLib, PlaceholderAPI
• Optional: SaberFactions, Factions, LuckPerms

Support

• GitHub Issues: Report a bug

License

MIT License