Skip to content

Player editor

DatGamerYoloYT edited this page May 3, 2025 · 7 revisions

Playable characters

Those are new type of characters, which can be selected from character select screen and change the songs available in Freeplay.

Editor for those is accessible from the master debug menu under the name of "Player editor"

This editor saves characters in the same format V-Slice (Base game) uses, which means you could also use this as an aid in creating custom characters for V-Slice mods.

Char select editor

Upon opening you should see the screen like this: editor

It looks similar to the original character selection screen with an additional window.

"Player" section

pl1

Name

The real name of your character (also known as it's "id"). It determinates which chill character and nametag to use.

In case you're confused about the exact paths for those assets, feel free to open the game from "cmd.exe" and look into the logs.

Readable name

The human readable name for your character to be used for... something (In V-Slice [base game], this is used for the "You can now play as" screen.)

Show unassigned songs

If checked, this character will also own any song, that isn't owned by any character ("freeplayCharacter" is empty in the manifest)

Position

Sets the position of character in the select screen. I won't explain it any further, so just play around and see for yourself.

Reload

Reloads the character from the available characters either in your mod, or in the base P-Slice.

It loads "<name>.json" character file.

Anims preview

Opens up animation previewer for your character's "chill" sprite.

Edit freeplay

Opens up editor for the freeplay part of your character.

"Girlfrend" section

gf

Anims preview

Opens up animation previewer for your gf's "chill" sprite.

Reload

Reloads gf's sprite from provided "Asset path" loading with JSFL metadata from "JSFL anim folder".

Asset path

The path to your gf's atlas sprite. It's originated from either "mods/<your-mod>/images/" or "assets/shared/images"

JSFL anim folder

The path to the JSFL folder with metadata used to define her sliding movement. Funkin Crew would probably be able to tell more about this format.

Use visualiser

Whethever or not your gf character supports visualiser.

How does that work? I dunno, but I know Nene has visualiser, so you could look into her FLA files to figure that out.

Animation previewer

anim view

It allows you to to preview the animations of your characters. It does that by gathering available "labels" from your atlas sprites and showing them in the menu on the left.

Controls for it are located in the help menu (in the bottom right corner)

Results screen editor

anim view

Here you can edit the animations for your character on the result screen. You can click F1 to bring the window with useful key binds in the editor.

  • For Atlas sprites, the animations played is "" (which corresponds to it's main symbol)
  • For Sparrow sprites, the animation is created form an empty prefix (all declared frames are used)

"General" section

Rank

Selects the rating you want to edit animation for. Changing this will reload all props.

Object

Selects an object you want to edit. You can head to the "Properties" to change the properties of the selected object (or use keyboard/touch buttons)

Rank music

The path to the music to be played on the selected rank results screen. The path must point to a directory (just like in V-Slice)

New sparrow

Makes new sparrow sprite. You can then select it from the "Objects" list.

New atlas

Makes new Animate atlas sprite. You can then select it from the "Objects" list.

"Properties" section

Empty Sparrow Atlas

Depending on the type of object chosen on the "Objects" list, the available options will differ.

Image path

The path to the image for the sprite

  • For sparrow sprites that is .png/.xml file names
  • For Atlas sprites that is a directory to the sprite's texture data

Offsets

Changes the sprite's position. You can also move those with

Delay

Changes time this sprite should wait before playing it's animation.

Scale

Changed this sprite's scale. The editor might not reflect changes to this value properly. Exiting and reopening it should fix the issue for now.

Start label

If provided, this will be the label this sprite uses to play the animation for the first time.

Loopable

If checked, allows this sprite to loop either on a given label, or a frame number.

Loop frame

The frame this sprite should start on when the animation loops. Useful if you have a start and loop frames in one animation.

Loop label

If provided, this will be the label this sprite uses to loop the animation (instead of loop frame).

Freeplay editor

freeplay

This section lets you customise the way your character will appear in the freeplay. You can look into a help page here to see the controls for the anim preview (which has some additional functionality here).

"General" section

gen

Asset path

Path to your freeplat DJ. It's originated from either "mods/<your-mod>/images/" or "assets/shared/images".

Reload

Reloads your freeplay DJ sprite from the "Asset path".

Scroll texts

Those are texts, that scroll behind your DJ. They are dynymically updated, which means that you can easily preview different texts and see how they fit.

"DJ Editor" section

dj

Note: I haven't tested those

Here you can edit key frames for "Victory" ("fistPump" anim) and "Loss" ("loss" anim) when getting a new rank. Please note that these are frame indexes, where anim previewer displaus frame numbers instead (indexes start from 0, frame numbers start from 1)

"Intro" frames loop before slamming the freeplay card back into the freeplay.

"Loop" frames play after the "Intro", after which the DJ returns back to "Idle" animation.

Left are the start frames, and right are the end frames. You can additionally put "-1" as a end frame. In this case the animation will play till it's last frame.

"Animation" section

anims

This acts as a way to manage animation contained within your DJ. This section will update with animation previewer.

Name

The name for this animation. That's the name freeplay will search animations by.

Prefix

The name of the animation in the atlas sprite. Most likely it'll be the name of the symbolcontained within the sprite.

If you set an incorrect prefix here, the animation's name in the preview will turn red and no animation will play.

Offsets (x,y)

Changes the offsets for the active animation. This can also be done with animation previewer.

New

Creates a new blank animation. You can have up to 20 animations defined.

Delete

Deletes currently selected animation. You need to have at least one animation left, otherwise you won't be able to remove it.

Clone this wiki locally