NameBending

Installation

• Install MelonLoader v0.7.2+
• Drop Mods and UserData folders into Rumble Source Directory
• Play the game

Description

This mod allows you to set your username and title to anything you like. No more character limits or boring, static names.

Your custom username and title will only show up to others who also have the mod!

Features

• Much higher character limit (~8,000)
• Variations: Automatically switch between variations every scene load
• Animation: Cycle through different frames in real time
• Custom fonts: Choose from 11 preset fonts
• Alt text: Text to show to those who do not have the mod
• Standard limits apply (static, 1-71 characters)
• Does not work on titles
• Images:
• Insert image links to have them show up
• Must be verified in the Discord first

Usage

Simple Configuration

• Open the UI (F9 on the keyboard)
• Go to the Simple Config tab
• Make sure the Enable Simple Config box is checked
• Input the values you want to change
• Refresh your name

Advanced Configuration

• Rename the provided JSON files to remove the word TEMPLATE (UserData/NameBending/customBentNameTEMPLATE.json and UserData/NameBending/customBentTitleTEMPLATE.json)
• Open them in your favorite text editor and replace the default values with your specifications

You can preview your customizations by going to the Name Plate category in the UI and enabling Nameplate Preview.

Changes you make with this mod will only show up in certain places (name plates, the MatchInfo board, RumbleHUD plates) and not on in others: (park board, leaderboard, friends list).

If you change your custom name or title while the game is open, press N to update it. This hotkey can be changed in the UI settings.

JSON Format

The provided JSON file templates should get you started in the JSON files. Here is a comprehensive guide to the formatting:

customBentName.json/customBentTitle.json

doRandomVariations: false

Whether to choose variations randomly, or in order

variations

The different possibilities of names/titles to show up when names are refreshed (such as on scene loads)

weight: "1"

Formatted as a string, but is a number that represents the liklihood of a variation to be randomly chosen relative to all the other weights. If set to HOST, will be equivalent to a value of 1 when user is the host, and 0 if client. CLIENT produces opposite results

altText: ""

Only available for names. The text that users who do not have the mod will see on your nameplate, as well as some other places such as the MatchInfo board or RumbleHUD plates

prohibitSaving: false

If set to true, others will not automatically save your name to a file (overriding the Save Names To File advanced setting)

frameDuration: 1000

An integer that describes how long each frame of your animation will last. Set in milliseconds, so 1000 is equivalent to 1 frame per second

loopFrames: true

When disabled, your animation will play once and freeze on the final frame

interpolation: false

When enabled, fields that are set within frames will interpolate their values to smoothly animate between them

loopInterpolation: true

When enabled along with interpolation and loopFrames, will allow the final frame to interpolate back to the first frame

enableFields: true

Enables field processing

autoScaling: true

Can be disabled to prevent the automatic squishing that is applied to text in nameplates when it gets to long

frames

See Frames

fonts

See Fonts

fields

See Fields

depths

See Depths

images

See Images

You can make sure your JSON is correct with a validator like JSON Lint

Frames

Frames are used to create animations. They are defined with an index (the part of the animation they appear in) and a string (the frame itself). Each frame is like a regular name, but the mod will cycle through them to create an animation. The index numbers are usually defined in order (0, 1, 2, 3...) but they can skip numbers to hold on frames for longer.

Frames Example

{

"altText