목차

🖥️ 커스텀 태그 적용하기

1. C##'s Mod Server의 커스텀 태그 배포 포럼 채널에서 사용할 태그를 찾아주세요.
2. (얼불춤 설치 폴더)/Mods/Overlayer/Modules/Scripting/Scripts 폴더에 사용할 태그가 있는 파일을 다운로드 받아주세요.
3. 얼불춤을 실행해주시면, 이제 해당 태그를 일반적인 태그와 똑같이 사용할 수 있습니다!
   • 만약 얼불춤이 켜져있었다면, 껐다 킬 필요 없이 스크립트 다시 로드 버튼을 눌러주세요.

🛠️ 커스텀 태그 만들기

<aside> 📢 커스텀 태그 제작 전 안내

현재 커스텀 태그로 지원되는 언어는 JS(JavaScript), Python 총 2개 언어입니다.

때문에 아래 내용은 JS 또는 Python에 대한 배경지식이 필요하며, 해당 언어의 기초 내용(함수까지)을 배우고 오는 것을 추천드립니다.

</aside>

1. 코드 에디터 설치

우선 코드를 작성하기 위해, 코드 에디터를 설치해주세요. 이미 설치되어있다면 이 과정은 넘어가도 좋습니다.

추천하는 에디터는 Visual Studio Code입니다!

• @Runas 가 직접 만든 “IntelliOverlayer”라는 자동완성 확장 프로그램을 함께 사용하면 더 좋습니다.

cf. 만약 코드 수정 외에 별도 기능(자동 완성 / 하이라이팅 / …) 이 필요 없다면 에디터 대신 메모장으로 진행하셔도 좋습니다.

2. 함수 만들기

오버레이어의 텍스트에서 태그는 지정된 함수의 반환값을 보여줍니다.

커스텀 태그에서의 함수는 일반적인 함수와 똑같지만, 오버레이어에서 제공하는 모든 태그를 함수의 형태로 함께 쓸 수 있다는 차이점이 있습니다.

• 커스텀 태그의 함수에서 사용할 수 있는 오버레이어 내장 함수의 목록은 🖥️ 커스텀 태그 적용하기 에서 언급한 Scripts 폴더 안의 “Impl.js” (또는 Impl.py) 파일을 참고해주세요!

이 함수들을 이용해 다양한 함수를 만들 수 있습니다.

ex) Early, Late 판정 합치기 (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. 태그 등록하기

RegisterTag 라는 함수를 이용해 오버레이어에 자신의 커스텀 태그를 등록할 수 있습니다.

RegisterTag 함수의 매개변수는 총 3개로, 각각 “태그의 이름”, “실행할 함수”, “Not Playing 텍스트에서 사용 가능 여부”입니다.

• ex. RegisterTag("good", Good, true); ⇒ 위에서 만든 “Good” 함수를 “good”이라는 태그로 등록

스크립트의 맨 밑줄에 위에서 만든 함수를 등록하는 코드를 작성해주시면 코드는 완성입니다!

↓↓↓ 예시 코드 ↓↓↓

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

RegisterTag("good", Good, true);

작성한 코드를 🖥️ 커스텀 태그 적용하기 를 참고해 적용해주시면 완성입니다!