CosmeticPerks

A lightweight cosmetic commands mod for NeoForge 1.21.1, built for servers that want to offer fun rank perks without the bloat of a full cosmetics suite. Every command is self-contained, toggleable via config, and integrates cleanly with any NeoForge-compatible permission plugin.

Features

/nick — Set your own display name with full color code support using & codes (e.g. &6[VIP] &eSteve). Nicknames persist across restarts and show up in chat automatically.

/nicka — Admin command to set another player's nickname.

/nickreset — Remove your nickname and return to your real username.

/hat — Wear any item in your hand as a cosmetic helmet. Swaps with your current helmet so nothing is lost.

/sit — Sit down on the spot using an invisible armor stand mount. Type /sit again to stand up.

/glow — Toggle the glowing outline effect on yourself, visible to all nearby players.

/trail — Attach a particle trail to yourself. Available types: hearts, flames, sparkles, smoke, magic, snowflakes. Visible server-wide.

/chatcolor — Colorize all your chat messages with a chosen color. Use "none" to clear it.

Permission Integration

All commands use NeoForge's PermissionAPI with the following nodes:

• k1perks.nick
• k1perks.nickreset
• k1perks.nicka
• k1perks.hat
• k1perks.sit
• k1perks.glow
• k1perks.trail
• k1perks.chatcolor

These nodes are automatically picked up by FTB Ranks. Assign them to ranks in your ftbranks.snbt file. Without a permission plugin, all commands default to requiring operator level 2.

Config

On first launch the mod generates configs/K1Perks/cosmeticperks.toml. Each command can be individually disabled by setting it to false — disabled commands are completely unregistered and won't appear in tab-complete. Restart the server after editing.

Requirements

• NeoForge 21.1.227 (Minecraft 1.21.1)
• Java 21
• Server-side only — no client mod required