첫번째 컨픽 작업하기

1. 서버에 대해 전반적으로 이해하기

• 마인크래프트 서버가 돌아가는 전반적인 방법에 대해 이해

• yml 과 json 파일 구조에 대해 이해하고 key 와 value 에 대해 이해하기

위 내용을 설명한 https://cafe.naver.com/minecraftgame/1832902 를 한번 읽어본 이후 yml 과 json 에 대해 설명이 부족한 경우 검색 등을 통해 해당 파일에 있는 것들이 어떤 것인지 이해합니다.

2. docs 열기

보통 플러그인은 config 가 무엇을 뜻하는지, 그리고 어떻게 제작해야 하는지 설명하는 docs가 
존재합니다. 플러그인 사용자, 다시 말해 컨픽을 하는 인원이 더 많은 자유도를 가지고 컨픽을 할 수 
있을수록 docs가 길어지고 수정을 많이 가해도 되지 않을 때는 짧거나 컨픽의 주석(comment) 으로만
적혀 있는 경우도 있습니다.

이번 튜토리얼에서는 서버 상점 플러그인인 SigShop 과 다양한 기능이 모여있는 코어 플러그인인 
CMI 의 컨픽을 하나씩 변경해 보겠습니다.

우선 Sigshop 은 서버 자체 제작 플러그인이므로 docs 가 이 위키 안에 존재합니다.

상점 기본 이해하기 | 개발진 위키sigcraft.gitbook.io

CMI 는 서드파티 플러그인이고 거대한 플러그인이므로 docs 를 위한 사이트가 따로 존재합니다.

CMIZrips

3. CMI 에서 문구 하나 변경해 보기

보통 플러그인에서는 서버 내에서 유저에게 보이는 메세지들을 파일을 통해 수정 할 수 있도록 프로그래밍 해 놓습니다. 이를 변경하는 것을 보통 한글화 라고 부르고 이 메세지 파일을 Locale (로캘) 파일이라고 부릅니다.

로캘 파일의 이름은 제각각이지만 보통 message, localization, translation 과 같이 메세지를 연상 할 수 있는 파일명으로 되어있는 경우가 많습니다. 하지만 규칙이 있는건 아니라 개발자 마음대로이긴 합니다.

CMI 에서 로캘 파일은 CMI/Translations/Locale_KO.yml 에 있습니다.

Translation 내부에 파일이 여러개 있는데 여기서 KO(Korean) 을 사용하는 이유는 CMI/config.yml 에서 그리 하도록 지정하였기 때문입니다.

이번 시도에서는 sethome 내부 문구 하나를 변경해 보도록 하겠습니다. 해당 파일을 내 컴퓨터로 다운로드 받은 이후 ctrl+f 로 balance 를 찾아

  balance:
    help:
      info: '&eCheck money balance'
      args: (playerName)
    info:
      balance: '&eBalance: &6[money]'
      balanceOther: '&6[playerDisplayName] &ebalance: &6[money]'

이 파트를 확인한 후 게임 내에서 /cmi balance 를 통해 다음 메세지 '&eBalance: &6[money]' 가 잘 뜨는지 확인합니다. 여기서 [ ] 으로 둘러져 있는 [money] 는 내가 보유하고 있는 돈이 표시되게 되는 placeholder , 그리고 & 뒤에 따라오는 &e, &6은 색 코드라고 합니다. 이 부분에 대해서는 한글화 파트에서 자세하게 기술하겠습니다.

이제 이 메세지를 원하는대로 변경한 이후 게임 내에서 /cmi reload 이후 /cmi balance 를 통해 원하는대로 변경되었는지 확인합니다.

단 [money] 는 placeholder 의 역할을 하고 있기 때문에 번역하거나 변경해서는 안됩니다.

잠깐! 만약 컴퓨터에 이미 해당 파일을 들고와서 작업하고 있다면 당연히 내가 저장한 파일은 내 컴퓨터에 존재합니다. 변경된 파일을 ftp 를 통해 서버에 집어넣어야 내가 변경한 변경점이 서버의 파일에 제대로 쓰이게 됩니다.

믿기지 않겠지만 컨픽 작업을 많이 하다 보면 종종 이 부분을 까먹고 왜 안되는 거지 하면서 화가 날 때가 있습니다.

4. SigShop

이번에는 좀더 흥미로운 수치 변경에 도전해 보도록 하겠습니다.

상점의 아이템은 모두 SigShop/ShopStaticData.yml 에서 관리됩니다.

이 파일을 탐색하여 MAIN_MINING 파트를 확인합니다. 이 부분은 서버의 블럭 상점을 구성하는 컨픽입니다.

MAIN_MINING: #BUY-SELL RATIO 5
  'GENERAL':
    'NAME': '&f𠅖'
    'START_INDEX': 1
    'NPC_ID': 0
    'TAX_RATE': 0.05
    'REQ_FAME': 0
    'DYNAMIC': false
  'STONE':
    'ITEMSTACK': 'VANILLA STONE'
    'BASE_BUY': 6
    'BASE_SELL': 1.2
.. 중략

여기서 확인해 보면 BASE_BUY 가 6 , BASE_SELL 이 1.2로 설정되어 있는 것을 확인 할 수 있습니다.

여기서 6과 1.2 숫자를 원하는 것으로 변경한 이후 게임 내에서

/shopadmin reload 를 진행한 이후 상점을 다시 열어서 구매나 판매가격이 변경되었는지 확인합니다.

5. 마무리

와! 첫번째 컨픽 수정을 함께 시도해 보았습니다.

모든 컨픽 작업은 방금 한 것과 크게 다르지 않습니다. 간단하게 다시 정리하여 컨픽 작업은 다음과 같이 이루어집니다.

1. 컨픽이 어떻게 구성되었고 어떤 역할을 하는 것인지에 대해 이해한다.

2. 컨픽을 올바른 방법으로 변경하고 게임 내에서 그 변경점을 적용할 수 있는 명령어를 통해 ( 보통 ~~ reload ) 적용시킵니다.

3. 내가 변경하고자 했던 것이 제대로 게임 내에서 돌아가는지 확인합니다.