EndyDev Read the docs
Esc

Web editor

The editor is a web page where you draw every rank’s badge. It runs in any desktop browser; there’s nothing to install.

Opening it

Run /erank editor in game (or in the console) and click the link. The link is private to your server and works for one hour; after that, run the command again for a new one. Everything you did is still there.

Opened from that link, the editor saves online as you work and can deploy to your server. The top bar says where your changes are: Unsaved changes, Saving…, All changes saved.

Opened any other way, it’s in offline mode: you can design ranks, they’re kept in that browser only, and Deploy and History are off until you open it again with /erank editor.

The browser also keeps a backup of your work. If it’s newer than what the server has (you closed the tab before it saved), the editor asks whether to restore it.

The screen

AreaWhat it’s for
Ranks (left)Every rank, in folders if you like. + makes a new one
Canvas (centre)The badge of the selected rank, with the drawing tools on its left
Layers (right)What the badge is made of, top of the list in front
Properties (right)The settings of the selected layer, and of the rank itself
Chat preview (bottom)Your ranks in a chat line, updated as you edit

Top right: Undo, Redo, Tour (replays the guided tour), History and Deploy.

Ranks and folders

  • + next to Ranks opens New rank: type a name, check the ID, and click a template.
  • The ID is what the placeholder uses (%erank_owner%): lowercase letters, digits and _, up to 32. It’s made from the name; change it before you click a template if you want another.
  • Each rank’s actions menu has Duplicate, Delete and Move to folder.
  • The folder button makes a folder. Drag ranks into it; double-click its name to rename it. Folders are only for you: they change nothing in game.
  • The grid button shows the ranks as a grid of badges; the search box filters them by name.

Templates

New rank has hundreds of finished badges, by tab:

  • Styles: every frame style (flat, bevel, double, pill, notched, ribbon, gradient, glossy, outline, shadowed, inset, neon, hex, stripe, plate, two-tone) in 12 palettes (Ruby, Amber, Gold, Emerald, Aqua, Sapphire, Amethyst, Slate, Rose, Mint, Copper, Midnight).
  • Themes: Staff & VIP, Donor tiers, Prestige, Rarity, Game modes, Fantasy, Gems & metals, Elements, Nature, Seasonal and Fun, with decorations already on them.

A template is only a starting point: every part of it is a layer you can change.

Layers

A badge is a stack of layers. The one at the top of the list is drawn in front. + in Layers adds one:

LayerWhat it isIts settings
FrameThe badge’s shape and backgroundStyle, palette, inner colour, width, space above and below, pattern
TextThe wordsText, position, solid colour or a top-to-bottom gradient, outline
Text shadowA shadow under the textColour, offset
HighlightA band of light across the badgeColour, position, height
IconA small picture, in its own box or notIcon from the library or your PNG, 1× or 2×, offset
PictureAny PNG of your ownThe image, 1× or 2×, position
DecorationPixels around or inside the frameKind (sparkles, flames, snow, drips, crown, vines… 25 kinds), colours, amount
PaintWhat you draw with the toolsClear, Flatten into this layer
GroupA folder of layers

Each layer has an eye (show or hide), a lock and an opacity. The buttons above the list group, duplicate, download as PNG and delete the selected layer; the search box finds a layer by name. Drag layers to change their order.

Space above and Space below (Frame) keep rows free for decorations that stick out, like flames, snow or drips.

Icons

The icon library has over 1,700 free pixel icons (weapons, potions, gems, armour, food…), searchable by name. Upload takes your own PNG, up to 64×24 px. Show the box puts the icon in a small box of the frame’s style, left of the badge.

Drawing tools

ToolKeyDoes
PencilBPaints pixels in the colour picked on the right
EraserEClears pixels
FillGFills an area of one colour
Colour pickerITakes a colour from the badge

Strokes go to the selected Paint layer; with another layer selected, they go to the topmost unlocked Paint layer. Brush size is in Java pixels: even sizes stay sharp on Bedrock. Under the canvas: the pixel grid, zoom and Fit to screen.

View switches between Java (what you edit) and Bedrock 1x, the half-size copy Bedrock players see.

The rank’s own settings

In the Rank section of the properties:

SettingWhat it does
NameShown in the editor
Rank IDThe placeholder’s id. Changing it gives the rank a new character; the old one stays reserved
CharacterIts code, e.g. U+E900. Copy \uE900 for config files, or Char for the character itself
PlaceholderCopies %erank_<id>%
Fine detail (Java)1 px shading for Java: metal bevels, smooth gradients, cut gems, patterns. Bedrock keeps the 2 px version
WidthFit content, or a fixed width: Java px, even, up to 256
HeightJava px, even, 8 to 64. Bedrock gets half

Badges taller than 24 px overlap the lines above and below in chat, TAB, the scoreboard and lore, because Minecraft keeps those rows the same height. Nametags are fine.

Glyph size (advanced)

Under the rank list. These apply to every rank:

SettingDefaultWhat it does
Height in chat12How tall badges are drawn in chat, in GUI pixels (1 to 24)
Baseline9How far the badge reaches above the text baseline. At most the height
Bedrock vertical offset0Moves the Bedrock copy up (negative) or down (positive), −6 to 6

Keyboard

KeysDoes
Ctrl + ZUndo (up to 200 steps)
Ctrl + Y, Ctrl + Shift + ZRedo
B, E, G, IPencil, eraser, fill, colour picker
Alt + 1 to Alt + 4Fold the ranks, layers, properties and chat panels
Ctrl + \Hide or show all the side panels
EscClose a dialog

On a Mac, Cmd works in place of Ctrl.

Deploy

Deploy saves the current ranks as a new version and shows a command:

Command
/erank apply AB12CD34

Run it in game or in the console within 10 minutes. The server then downloads the ranks, builds the resource packs and sends them to the players. If the code runs out, click Deploy again.

Each rank keeps its character for good, even after you change its look, so prefixes you already pasted show the new badge. An apply that would move a rank to another character is refused.

History

History lists every version you deployed, newest first. Restore loads one into the editor as your draft; nothing changes on the server until you deploy again. Characters never change when you restore, and Undo takes you back to where you were.

Credits

Credits & licenses, under the rank list, names the fonts and icon packs the editor uses and their licenses.