A very helpful/useful guide for Project Heartbeat – Creating Script and Resources
Basics
First of all, I would highly recommend playing the game via the command prompt. The game will operate just like normal, however, the command prompt window will remain open and display game logs in real time.
You can:
Go to the game’s installation location within the File Explorer, click on the URL bar at the top, type in ‘cmd’, and press enter.
Enter the code “project heartbeat”, including the double quotes.
Alternatively, if you know the exact location of the file where the game is stored you can type it into the command prompt from anywhere.
Then press Enter. The game should begin normally but leave the command prompt window open. Based on the graphics settings you may need to press alt-tab (or click) on the command prompt on your taskbar.
Go to the editor. Tools -> Song Editor
Open a song. If you don’t have a song created already and don’t know how you can get it done, follow these steps:
https://steamcommunity.com/sharedfiles/filedetails/?id=2997068764 – [steamcommunity.com]
Click on the Scripts tab. The fourth tab is on the right toolbox.
The menu is very simple. You can run a script by pressing the button beside it, and open the script manager GUI by clicking the big button at the bottom.
Click on “Manage Scripts.’
When you launch this menu for the first time, it’s likely to be blank but I filled in an example script so you can see all the buttons.
Top-left Button Row:
- Save: Saves the current script
- Save as: Saves the current script as a brand new file
- New Script: Creates a brand new script, leaving the script body.
- Open Script Folder : Opens the folder containing the scripts in the Explorer file
Script List:
- Script Name: Clicking this allows you to change the name, then press enter to save
- Open Script: Opens the script in the body of the script
- Duplicate Script: Creates a duplicate of the script
- Remove Script: Deletes the script (doesn’t empty the body of the script).
This is the time to put your knowledge to the test. Create an entirely new script and make it exactly the same as the one above. You can copy-paste this script if you’d like to:
extends ScriptRunnerScript; func run_script(): print("Hello World!") return OK
After saving your script, close the script manager. Click the “Execute script” button.
If you’re running Project Heartbeat through command prompt you should see “Hello World!” show up in the command prompt window.
Congratulations! Congratulations! You’ve learned the basics of the Script Management. Use the following tips to create your own scripts.
Resources
If you’re just beginning to learn about programming, or you want to look around and see how the syntax differs this is a good video to watch:

Documentation for GDScript:
You can make use of the built-in GDScript features:
https://docs.godotengine.org/en/stable/classes/[email protected] – [godotengine.org]
Lino’s script (guy who developed the editor):
https://github.com/linobigatti/TAC – [github.com]
ScriptRunnerScript functions
WIP
Name | Argument(s) | Returns | Description |
---|---|---|---|
run_script() | N/A | Pass | Runs the script. Your own scripts should be executed after this. |
Other Editor Functions
Technically, you can use any of the functions listed in Editor.gd or EditorModule.gd
Do this at your own risk.
Classes
WIP
Timing Points
HBBaseNote
HBBPMChange
HBChartSection
HBDoubleNote
HBDurationNoteData
HBIntroSkipMarker
HBNoteData
HBSustainNote
HBTimingChange
HBTimingPoint
Other
HBChart
HBSong
HBEditor
ScriptRunnerScript
Your time spent on reading Project Heartbeat – Creating Script and Resources is greatly appreciated. This post was inspired by the wonderful work of Hinae. If you have any ideas for improving this content, do share your thoughts in the comments. Enjoy your day, and remember to visit us daily for fresh posts!
- Check All Project Heartbeat Posts List
Leave a Reply