Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 96 additions & 3 deletions wiki/modding/characters/editor-features.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,100 @@
---
author: Frakits
author: WinkMouse
desc: This page explains how to use the character editor
lastUpdated: 2024-08-26T13:35:32.000Z
lastUpdated: 2025-11-15T16:09:05.000Z
title: Character Editor Features
---
# Additional oh fuck this is not the chart editor file
# Character Editor Features

When opening the character editor, we will be greeted with something like this:
<img width="1919" height="1032" alt="image" src="https://github.com/user-attachments/assets/48cec5be-00a9-44c9-83ea-d78c6ea9548e" />

This might seem a little overwhelming, but we will go trough each one of the items with care

You can move around the stage by dragging it around, you can use the mouse scroll wheel to zoom, and you can even drag the character animation to edit its offset without needing to write them down (Can be disabled by going to the "Offsets" tab at the top of the editor and unchecking "Drag offsets with mouse?"

<img width="544" height="292" alt="image" src="https://github.com/user-attachments/assets/4bad47ec-9d04-49e9-abc6-fe4a3ce525d5" />


The most important thing here are the animations, you can add as many as you like, but its recommended that you add at least an idle and singing poses (left, down, up, right)

As the character editor is still a little buggy, if you´re making a character, add all the animations first without changing their offsets, then save the character and reload the character editor state (F5), when youre done with that, you can edit the offsets without the risk of the engine crashing.

We will now go trough this part of the editor:

<img width="459" height="240" alt="image" src="https://github.com/user-attachments/assets/090d3f49-8cf8-48dc-935b-f55e25e424f7" />

The "Position" parameters are self explanatory, they change the position of your character in the stage. Please do not mistake the **"Position"** parameters with the **"Offsets"** parameter of each animation, as the "Position" parameter changes where your character is located in the stage, **including animations**

The "Camera Position" parameters change where the camera will go when a "Camera Movement" event is called onto this character, its reccomended you place the camera position near the face of your character. Aditionally, this blue cross will help you know where your camera will go when the event is called

<img width="69" height="64" alt="image" src="https://github.com/user-attachments/assets/bea2dde6-c52b-438e-9e5b-bff46fb78663" />


The "Scale" parameter changes the scale (size) of your character.

The "Flipped?" checkbox changes the direction your character is facing, useful if your character is facing the wrong direction

The "Antialiased?" Parameter is a little bit more complex, it changes wether the pixels should be smoothed out or not, if youre making a normal character, leave this on, but if youre making a pixelated character, turn this off so the pixelart isnt ruined

<img width="1754" height="973" alt="image" src="https://github.com/user-attachments/assets/3478bd0f-5bcd-40e8-aea4-7bb900868264" />

<img width="1703" height="981" alt="image" src="https://github.com/user-attachments/assets/1f79424d-12b7-4f70-a1d9-278287cedef4" />

Notice the slight difference in the pixels.

The "Test Character As:" tab changes how will the character be shown in the stage editor.

This isnt too important outside making a character.

The "Char Designed As:" tab however changes how the character will be shown in game

Make sure its the same as the type of character you´re making (If you´re making a player character, set it to BOYFRIEND, if not, set it to "DAD")

### Edit Info window

The "Edit Info" window allows you to edit other parameters of the character

<img width="851" height="439" alt="image" src="https://github.com/user-attachments/assets/d63ba650-5370-4e4f-8c60-94e396738ca8" />

- The "icon" parameter sets the icon of your character shown in the healthbar and in the freeplay menu

The game will look for the following route to find the icon: "Codename Engine\mods\your-modimages\icons\your-character/icon.png"

Make sure to name the icon of your character in the "your-character" folder exactly "icon.png", otherwise, the engine will not recognize it as an icon

- The "color" parameter changes the color of the character´s region in the healthbar

Aditionally, you can press the color picker button alongside the icon preview to choose the color automatically

- The "Sing Duration" parameter changes how many beats a singing animation will remain on its last frame before going back to idle

It´s recommended you set it to 4 or 8

- You can also add custom values in the "Custom Values" tab

### Edit Character Sprite Window

Pretty self explanatory, this allows you to change the sprite used for a character.

## Animations window

The animations window looks something like this

<img width="469" height="689" alt="image" src="https://github.com/user-attachments/assets/b0645e13-565d-4ea9-99c6-c5c7c1e4acb2" />

This is where all of your animations will be saved, with their respective prefixes

You can press the green "+" button to add an animation

You can press the green play button or space to play the current animation, you can click a certain animation or use **W** and **S** to cycle trough them

The little ghost button will show the first frame of the selected animation at a lower opacacity. Useful for setting animation offsets.

The red bin button will delete the animation entirely

The pencil will show more detailed info about the animation, as shown here

<img width="444" height="215" alt="image" src="https://github.com/user-attachments/assets/e4842354-82ce-4c68-8bfa-373fe675c4fd" />

The parameters are the same as the anim nodes on the previous page.