Describe Your Problem Here

Oct 13, 2025 by wbrum.org 60 views

Introduction

Creating a new stage in a game development project can be an exciting but challenging task, especially for newbies. In this article, we will focus on how to make background characters in a .json stage synchronize with the beat of the music. We will explore the possible solutions and provide a step-by-step guide on how to achieve this.

Describe Your Problem Here

As a newbie, you may have encountered the problem of creating a .json stage using the stage editor provided by Psych Engine. You added an animated object (BG_characters) as the background characters, but they don't synchronize with the beat of the music. Regardless of the BPM (beats per minute) you set in the song, the characters move at the same speed and not to the beat of the song. You may have read in the documentation that not specifying the fps (frames per second) and modifying the "danceevery" can solve this problem. However, you may have also seen this problem fixed in forums with OnStepHit or OnBeatHit, but those are for stages made with .lua and you want to avoid using .lua.

Your .json Stage Code

Here is your .json stage code:

{
	"camera_boyfriend": [
		0,
		0
	],
	"_editorMeta": {
		"boyfriend": "bf",
		"gf": "gf",
		"dad": "dad"
	},
	"preload": {
		"images/stage_light": 2,
		"images/stagecurtains": 2,
		"images/stagefront": 3,
		"images/stageback": 3
	},
	"girlfriend": [
		400,
		130
	],
	"stageUI": "",
	"boyfriend": [
		770,
		100
	],
	"camera_girlfriend": [
		0,
		0
	],
	"defaultZoom": 0.9,
	"objects": [
		{
			"x": -281,
			"y": 269,
			"scale": [
				1,
				1
			],
			"danceEvery": 0.25,
			"image": "BG_characters",
			"flipX": false,
			"filters": 3,
			"color": "FFFFFF",
			"angle": 0,
			"name": "BG_characters",
			"firstAnimation": "BG_characters",
			"antialiasing": true,
			"flipY": false,
			"scroll": [
				1.5,
				1
			],
			"alpha": 1,
			"animations": [
				{
					"loop": true,
					"offsets": null,
					"anim": "BG_characters",
					"name": "",
					"indices": []
				}
			],
			"type": "animatedSprite"
		},
		{
			"type": "gf"
		},
		{
			"type": "dad"
		},
		{
			"type": "boyfriend"
		}
	],
	"camera_speed": 1,
	"directory": "week1",
	"opponent": [
		100,
		100
	],
	"camera_opponent": [
		0,
		0
	],
	"hide_girlfriend": false
}

Are You Modding a Build from Source or with Lua?

You are modding a build from source with Lua.

What is Your Build Target?

Your build target is Windows x64.

Did You Edit Anything in This Build? If So, Mention or Summarize Your Changes.

You did not edit anything in this build.

Possible Solutions

There are several possible solutions to this problem:

Not Specifying the FPS: If you don't specify the FPS in your .json stage code, the animated object (BG_characters) will move at the same speed regardless of the BPM. To fix this, you need to specify the FPS in your .json stage code.
Modifying the "danceevery": The "danceevery" property in your .json stage code controls how often the animated object (BG_characters) will dance. To fix this, you need to modify the "danceevery" property to match the BPM of your song.
Using OnStepHit or OnBeatHit: These are events in .lua that can be used to synchronize the animated object (BG_characters) with the beat of the music. However, since you are using .json, you cannot use these events.

Step-by-Step Guide

Here is a step-by-step guide on how to fix the problem:

Step 1: Specify the FPS

To specify the FPS in your .json stage code, you need to add the "fps" property to the "objects" array. Here is an example:

"objects": [
	{
		"x": -281,
		"y": 269,
		"scale": [
			1,
			1
		],
		"danceEvery": 0.25,
		"image": "BG_characters",
		"flipX": false,
		"filters": 3,
		"color": "FFFFFF",
		"angle": 0,
		"name": "BG_characters",
		"firstAnimation": "BG_characters",
		"antialiasing": true,
		"flipY": false,
		"scroll": [
			1.5,
			1
		],
		"alpha": 1,
		"animations": [
			{
				"loop": true,
				"offsets": null,
				"anim": "BG_characters",
				"name": "",
				"indices": []
			}
		],
		"type": "animatedSprite",
		"fps": 60 // Specify the FPS
	},
	{
		"type": "gf"
	},
	{
		"type": "dad"
	},
	{
		"type": "boyfriend"
	}
],

Step 2: Modify the "danceevery" Property

To modify the "danceevery" property, you need to change the value to match the BPM of your song. For example, if your song has a BPM of 120, you can change the "danceevery" property to 0.5:

"danceEvery": 0.5 // Modify the "danceevery" property

Step 3: Test Your Stage

After making the changes, you need to test your stage to see if the animated object (BG_characters) is now synchronized with the beat of the music.

Conclusion

Q: What is the problem with background characters not synchronizing with the beat of the music in a .json stage?

A: The problem is that the background characters are moving at the same speed regardless of the BPM (beats per minute) of the song. This can make the stage look unprofessional and unengaging.

Q: Why can't I use OnStepHit or OnBeatHit in a .json stage?

A: OnStepHit and OnBeatHit are events in .lua that can be used to synchronize the background characters with the beat of the music. However, since you are using .json, you cannot use these events.

Q: How do I specify the FPS in my .json stage code?

A: To specify the FPS in your .json stage code, you need to add the "fps" property to the "objects" array. Here is an example:

"objects": [
	{
		"x": -281,
		"y": 269,
		"scale": [
			1,
			1
		],
		"danceEvery": 0.25,
		"image": "BG_characters",
		"flipX": false,
		"filters": 3,
		"color": "FFFFFF",
		"angle": 0,
		"name": "BG_characters",
		"firstAnimation": "BG_characters",
		"antialiasing": true,
		"flipY": false,
		"scroll": [
			1.5,
			1
		],
		"alpha": 1,
		"animations": [
			{
				"loop": true,
				"offsets": null,
				"anim": "BG_characters",
				"name": "",
				"indices": []
			}
		],
		"type": "animatedSprite",
		"fps": 60 // Specify the FPS
	},
	{
		"type": "gf"
	},
	{
		"type": "dad"
	},
	{
		"type": "boyfriend"
	}
],

Q: How do I modify the "danceevery" property to match the BPM of my song?

A: To modify the "danceevery" property, you need to change the value to match the BPM of your song. For example, if your song has a BPM of 120, you can change the "danceevery" property to 0.5:

"danceEvery": 0.5 // Modify the "danceevery" property

Q: What if I'm still having trouble synchronizing my background characters with the beat of the music?

A: If you're still having trouble synchronizing your background characters with the beat of the music, you may want to try using a different animation or adjusting the timing of your animation. You can also try using a different method to synchronize your background characters, such as using a script or a plugin.

Q: Can I use a script or a plugin to synchronize my background characters with the beat of the music?

A: Yes, you can use a script or a plugin to synchronize your background characters with the beat of the music. There are many scripts and plugins available that can help you achieve this.

Q: How do I know if my background characters are synchronized with the beat of the music?

A: To know if your background characters are synchronized with the beat of the music, you can test your stage by playing the song and observing the movement of the background characters. If they are moving in sync with the beat of the music, then you have successfully synchronized them.

Conclusion

In conclusion, synchronizing background characters with the beat of the music in a .json stage can be a challenging task, but with the right techniques and tools, it can be achieved. By specifying the FPS, modifying the "danceevery" property, and using scripts or plugins, you can create a stage with synchronized background characters that will engage and entertain your audience.