🎨 Ratatoulli - Colored Names & Ranks

Transform your server's player nametags with custom colors, stunning effects, and rank titles!

Ratatoulli is the ultimate nametag customization mod for Vintage Story servers. Reward your supporters, distinguish staff members, and add visual flair to your community with fully customizable colored names and rank displays.

✨ Key Features

• Custom Colored Names - Assign unique colors to any player using hex codes or named colors
• Rank System - Display titles like "Supporter", "VIP", "Moderator" above or below player names
• Easy Commands - Simple admin commands for managing all aspects of nametags
• Highly Configurable - Customize colors, sizes, positions, backgrounds, borders, and more

🎯 Perfect For

• Ko-fi Rewards - Give supporters custom colors and exclusive ranks
• Staff Identification - Distinguish moderators, admins, and helpers
• VIP Systems - Highlight premium members with flashy effects
• Event Winners - Reward competition champions with special titles

👑 Rank System

Display custom titles above or below player names to show roles, achievements, or supporter status. Ranks are fully customizable and work seamlessly with all color effects.

Example Ranks:

• Supporter
• VIP Member
• Moderator
• Gold Patron
• Event Champion
• Master Builder

🎨 Available Colors

Named Colors:
red, green, blue, yellow, cyan, magenta, white, orange, pink, purple, lime, gold, silver, darkred, darkgreen, darkblue, lightblue, lightgreen

Hex Colors:
Use any color with #RRGGBB format (e.g., #FF0000 for red)
Supports transparency with #RRGGBBAA format

⚙️ Commands

All commands require server admin privileges

Basic Color Commands

/colorname add <player> <color>
Assign a solid color to a player's name

/colorname remove <player>
Remove custom color from a player

/colorname list
View all players with custom colors and ranks

Rank Commands

/colorname rank <player> <rankName>
Set a rank/title for a player

/colorname removerank <player>
Remove a rank from a player

Information Commands

/colorname codes
Display all available color codes

/colorname effects
Show information about all effects

💡 Usage Examples

Ko-fi Supporter Setup

/colorname add Alice Red
/colorname rank Alice Supporter
Result: Alice gets a gold name with "Supporter" displayed above it

🔧 Configuration

The mod creates a configuration file at ModConfig/Ratatoulli.json with extensive customization options:

Nametag Appearance

• Background Color - Customize the nametag background
• Text Padding - Adjust spacing around text
• Border Style - Configure border width, color, and radius
• Drop Shadow - Enable or disable shadows

Rank Display

• Rank Position - Display ranks above or below names
• Rank Color - Customize rank text color
• Rank Scale - Adjust rank text size (default 75% of name size)

📋 Configuration Example

{
  "EnableColoredNames": true,
  "NameTagSettings": {
    "BackgroundColor": [0.0, 0.0, 0.0, 0.6],
    "DefaultTextColor": [1.0, 1.0, 1.0, 1.0],
    "TextPadding": 3,
    "BorderRadius": 3.0,
    "DropShadow": true,
    "BorderWidth": 1.0,
    "BorderColor": [0.0, 0.0, 0.0, 0.8],
    "RankPosition": "Above",
    "RankColor": [0.8, 0.8, 0.8, 1.0],
    "RankScale": 0.75
  }
}

🔒 Permissions

All commands require the controlserver privilege (admin access). Players cannot modify their own names - this keeps the system fair and exclusive.

🌟 Technical Highlights

• Performance Optimized - Efficient caching for smooth animations
• Cairo Graphics - High-quality text rendering with proper anti-aliasing
• Harmony Patches - Clean integration without conflicts
• Backwards Compatible - Works with existing VS entitlement system
• Persistent Storage - Colors and ranks saved across server restarts

⚡ Priority System

The mod applies nametag styles in this order:

1. Custom Colors - Set via mod commands (highest priority)
2. VS Entitlements - Official supporter/dev colors (if no custom color)
3. Default White - Standard color for everyone else

💬 Support & Feedback

Found a bug? Have a feature request? Want to show off your awesome nametag designs?
Join the discussion and share your feedback!

🎯 Quick Start Guide

Want to get started immediately?

1. Install the mod
2. Join your server as admin
3. Try: /colorname add YourName gold
4. Try: /colorname rank YourName Admin
5. Explore more effects with /colorname effects

Transform your server today with Ratatoulli! 🎨✨