목차

🖥️ How to adapt custom tags

1. Search for the tag you want in Custom tags forum (in C##'s Mod Server)
2. Download custom tag file in (ADOFAI Folder)/Mods/Overlayer/Modules/Scripting/Scripts
3. After that, you can use that tag the same as general tags!
   • If you downloaded it with ADOFAI on, you don’t need to re-launch it. Just click “Reload Script” button!

🛠️ How to make custom tags

<aside> 📢 Currently, we support only JS(JavaScript) & Python for making custom tags.

So this document requires base JS (or Python) knowledge, and we recommend that you learn the basics (~ function) before you read this.

</aside>

1. Install Code editor

At first, you should install code editor to write code. You can skip this if you already installed one.

My recommendation is Visual Studio Code!

• You can use “IntelliOverlayer” Extension by @Runas, which provides autocomplete & hover docs!

cf. If you don’t need any features(highlighting, autocomplete, …) except writing code, you can even use your default text editor (like notepad in windows)!

2. Make a function

Each tag in overlayer text shows the return value of linked function.

Functions in custom tags are the same as general functions, but there is a difference that you can use tags provided by Overlayer together in the form of a function.

• For a list of overlayer built-in functions, check for Impl.js (or Impl.py) in Scripts folder (which I mentioned in 🖥️ How to adapt custom tags)

You can make various function with tags!

ex) Merge Early, Late judgement (EPerfect!, LPerfect! ⇒ Good // Early!, Late! ⇒ Bad // Early!!, Late!!, Multipress!! ⇒ Miss)

function Good() {
	return CurEP() + CurLP();
}

function Bad() {
	return CurVE() + CurVL();
}

function Miss() {
	return CurTE() + CurTL() + Multipress();
}

3. Register tag

You can register your custom tags to overlayer with RegisterTag function.

RegisterTag takes 3 arguments: name of tag, function to link, and availability in Not Playing text.

• ex. RegisterTag("good", Good, true); ⇒ register “good” tag with function “Good” (which we defined above)

Write the registering codes at the bottom of the script, and you are done!

↓↓↓ Example Code ↓↓↓

function Good() {
	return CurEP() + CurLP();
}

RegisterTag("good", Good, true);

Now, adapt your custom tags with 🖥️ How to adapt custom tags!