RPNames

Version 1.2.0

Give yourself a custom, animated, and colorful roleplaying title above your name! All titles are synced with other players in multiplayer.

Features

• Fully In-Game GUI: No more editing config files! Press F8 (configurable) to open a stylish, animated menu and configure your title on the fly.
• Per-Character Profiles: Your title settings are saved for each character slot automatically.
• Network Synced: Other players with the mod (and CodeTalker) will see your custom title exactly as you designed it.

Rich Customization Options:

• Text Animations:
  • Static: A simple, non-moving title.
  • Scroll: The title reveals itself letter by letter, then reverses.
  • Marquee: Your title scrolls across a set width, like a news ticker.
  • Typewriter: Types out the title, pauses with a blinking cursor, backspaces, and repeats.
• Coloring Effects:
  • Single Color: Pick any color using an in-game color picker or by entering a hex code.
  • Gradient: A smooth transition between two colors.
    • Can be static or animated to pulse between the start and end colors.
    • In-game color pickers for start and end colors.
    • Adjustable animation spread/speed.
  • Rainbow: The entire title cycles through the colors of the rainbow.
  • Wave: A beautiful rainbow wave effect that flows through the text.
  • Static Rainbow: Applies a fixed rainbow pattern across the text.
• Formatting & Presets:
  • Choose from over 10 different bracket styles (or none at all).
  • Position the title on a new line, with or without a gap.
  • Select from a list of classic preset titles to get started quickly.
• Profile Management:
  • Copy/Paste: Easily copy your current design and paste it into another character's profile.

How to Use

1. Once in-game with your character loaded, press the F8 key to open the settings menu.
2. Type your desired title in the text box at the top.
3. Use the dropdown menus and sliders to customize the animation, coloring, and formatting.
4. When you are happy with your title, click "Set & Save Title" at the bottom. Your title will be applied and saved for the current character.
5. To remove a title, simply click the "Clear Title" button.

Installation

• Requires BepInEx.
• Download the latest release and unzip it.
• Place RPNames.dll into your BepInEx/plugins folder.

Dependencies

• CodeTalker (Required for Multiplayer): This mod relies on CodeTalker to send and receive title data between players.
  • If you are playing single-player, you do not need CodeTalker.
  • If you are playing multiplayer, every player who wants to see or show custom titles must have both RPNames and CodeTalker installed.

Configuration

The mod's configuration file is located at BepInEx/config/RPNames.cfg.

• Menu Key: You can change the key used to open the menu (F8 by default).
• CharacterProfiles: This stores all your profile data in JSON format. It is strongly recommended to only edit your titles through the in-game menu to avoid errors.

Changelog

1.3.2 - x.x.7

• UI: Title/Pronoun limit is now 32 -> 50 Chars max.
• Changed pictures on Readme.
• Fixed: Late-Join Sync issue.
• Fixed: 3 found Codetalker issues.

1.3 - x.x.1

• Feature: Added a dedicated Pronouns system. You can now add pronouns and select a bracket style for them in the settings menu, separate from the main title.
• Fixed: Resolved a critical desynchronization bug that caused player titles to randomly not appear for other players. The fix ensures title visibility is consistent for everyone in the lobby.
• UI: Minor layout improvements to the settings menu for clarity.
• Feature: Added full customization for pronouns. They can now have their own unique coloring, gradients, and animated effects, independent of the main title.
• Feature: Added a "Share Title Coloring" option for pronouns for easy color matching.
• UI: The settings menu has been reorganized with collapsible sections and a scrollbar to accommodate the new options without clutter.
• Fixed: (NOT RLLY A FIX I ONLY JUST TOUCHED THE README A LITTLE BIT YOU CAN IGNORE THIS LINE)

1.2.2

• Fixed: Resolved a bug that caused player titles to disappear for the host when changing maps.
• Fixed: Resolved a bug that caused the animation titles going crazy if mixed with rainbow/gradient animations.

1.2.1

• Fixed: Resolved a critical bug that caused the game to hang on the character screen when leaving one server and joining another. The mod's network state is now correctly reset on disconnect.
• Fixed: The mod's custom UI style no longer "bleeds" into the main menu or other UIs after disconnecting from a server.
• Fixed: Titles now display correctly for players who do not have a @GlobalNickname enabled.
• Fixed: Local player's title color now loads correctly on entering the game, instead of appearing black until re-saved.
• Added: A "Color Speed" slider to control the animation speed for Rainbow, Wave, and animated Gradient effects.

1.2.0

• Massive Network Overhaul: Replaced all network packets with highly efficient binary serialization to eliminate JSON overhead and drastically reduce packet size.
• Bundled Syncing & Client-Side Animations: Reworked the entire networking model to eliminate packet spam and reduce traffic on player join.
• Added Animation Speed Slider: You can now control the speed of all text animations.

1.0.0

• Initial release.