Cactbot을 커스터마이징하고 싶어요. (User 폴더 사용 방법)

Cactbot 플러그인은 사용자가 직접 js나 css 파일 등을 수정해서 사용할 수 있게 하는 고급 커스터마이징 기능을 제공합니다. 물론 대부분의 일반 유저분들께서는 그냥 기본 버전 상태 그대로 사용하시겠지만,  웹 개발에 조예가 있으신 분들은 약간의 수정으로도 내 취향에 맞는 Cactbot 오버레이를 만들 수 있습니다.

 

해루봇에서는 플러그인 업데이트를 시도할 때 기존 파일 및 폴더를 완전히 삭제하고, 새로 폴더를 만들고 파일을 다운로드해서 폴더에 넣고 연결합니다. 이렇게 하지 않으면 사용하지 않는 더미 파일들이 생길 수도 있고 예기치 않은 오류를 발생시킬 수도 있습니다. 실제로도 그런 사례들이 있어서 업데이트 로직이 기존에는 덮어쓰기였지만 이제는 삭제 후 재설치가 된 것입니다. 구 해루봇에서도 마찬가지였습니다. 

 

하지만 Cactbot 플러그인처럼 심화 커스터마이징이 가능한 경우에는 해루봇의 업데이트 방식이 매우 불편할 수 있습니다. 업데이트만 하면 다시 커스터마이징한 파일을 적용해야 하거든요. 이런 불편함을 해결하기 위해 Cactbot의 User 폴더를 사용할 수 있습니다. 

 

This directory holds user-defined configuration for UI modules.

Each file should be named <module>.js for variables and <module>.css for
layout/style settings where <module> is the name of the module that will
load the config.

Copy and rename the <module>-example.js file to <module>.js for an easy
starting point.

Cactbot 개발자 quisquous님이 작성한 User 폴더에 대한 설명입니다.

 

대충 요약 및 초월 번역하자면 Cactbot에서 사용하는 UI 모듈(=Cactbot의 오버레이 스킨) 중 수정하고 싶은 파일을 모듈명.확장자로 저장해서 User 폴더에 넣어두면 사용자 설정을 적용한다는 뜻입니다. 

 

Cactbot UI 모듈

js에서 데이터를 추가/수정할 수도 있고, css로 스타일을 지정할 수도 있습니다. 이 문서의 주제는 코드 작성에 대한 안내가 아니니 자세한 설명은 생략하겠습니다. 각자 유저 폴더 내 예시 파일을 참고하여 수정하도록 하시고요. 

 

구 해루봇에서는 User 폴더에 대한 처리가 없어서 일부 유저들께서는 경로를 다른 곳으로 변경해서 사용 중이셨는데요. 신 해루봇에서는 User 폴더 경로가 cactbot 폴더 경로 하위로 설정돼 있으면 ACT 폴더 하위 Resources 폴더로 경로를 변경한다고 유저들에게 안내합니다. 이 사실을 언제 안내하냐면 해루봇을 설치하고 cactbot 업데이트 버튼을 최초로 클릭했을 때 안내합니다. 아마 대충 보고 넘기신 분들은 이미 경로가 변경돼 있을 겁니다. 아무튼 그때 경로를 옮겨 주시는 것이 좋습니다.

 

현재 ACT가 인식하는 Cactbot의 유저 폴더 경로 (=사용자 디렉토리)

ACT에서 유저 폴더가 어딘지 확인할 수 있습니다. 스크린샷에 표시한 부분이 보이시나요?

바로 이 경로에 여러분들이 수정한 파일을 저장하시고 ACT를 실행하시면 되겠습니다.

 

이제 이 컴퓨터의 Cactbot은 user 폴더 안에 있는 파일의 설정으로 적용됩니다.

이곳에 파일을 넣어두면 해루봇에서 cactbot을  업데이트를 해도 삭제되지 않고 유지됩니다. 그리고 수정 사항도 잘 반영됩니다.

반드시 파일명은 ui 폴더의 파일명과 동일해야 합니다. 다르면 유저 수정 사항이 적용이 되지 않습니다.

 

그리고 만약에 이 유저 폴더가 ACT 폴더가 아닌 외부 경로에 있다면 반드시 ACT 폴더 내로 옮겨 주시기 바랍니다.

그렇지 않으면 해루봇 백업 및 복원에서 누락될 수도 있어요.

 

GitHub - quisquous/cactbot: FFXIV JavaScript Raiding Overlay

위 사이트에서 커스터마이징 가이드를 안내하고 있습니다.

 

커스터마이징 기능은 엄청나게 강력한 기능입니다. 내가 원하는 문구를 타임라인에 추가할 수도 있고, 각자 공대에 맞는 위치를 알림으로 설정할 수도 있고, 글자 크기를 줄이거나 키우거나 더 나아가서 다소 투박한 디자인을 세련되게 스타일링할 수도 있죠.

 

참고로 코드를 잘못 작성해서 에러가 나면 사용을 못 하게 될 수도 있으니 신중하게 작업하셔야 합니다. 커스터마이징은 앞서 말했듯 심화 단계입니다. 반드시 문제가 발생했을 때 "직접" 해결할 수 있는 분들만 시도하시기 바랍니다. 커스터마이징 에러로 인한 문의 메일은 받지 않습니다.