한글화 작업

한글화 작업은 플러그인 개발자가 특정 메세지를 수정 할 수 있도록 로캘 파일을 빼 둔 상태에서 해당 파일을 수정하는 행위를 뜻합니다.

한글화 작업은 메세지를 기본적으로 메세지를 파일에서 수정한 이후 인게임 리로드를 하고 해당 메세지를 볼 수 있는 액션을 시행하여 메세지가 잘 리로드되었는지 확인합니다.

보통 메세지 같은 경우 서버 자체 제작 플러그인을 포함하여 대부분 플러그인이 서버 리붓 없는 리로드를 지원하긴 하지만 만약 정상작동하지 않는 경우 서버를 한번 재시작 해 보고, 그럼에도 되지 않는 경우 Key값이 잘못되었거나 콘솔에 에러가 뜨고 있는지 확인해 볼 필요가 있습니다.

Color Code ( formatting code )

마인크래프트에서는 기본 색을 지원합니다. 리스트는 위키에 나와 있습니다.

Formatting codes – Minecraft WikiMinecraft Wiki

원래 기본 formatting code prefix 는 § 이지만 서버 플러그인을 포함한 (사실상) 요즘 모든 플러그인들은 & 로도 작동하도록 코딩되어 있습니다. 최소한 제 서버에서 사용하는 모든 플러그인은 됩니다.

Hex Color

Hex Color 은 rgb 값이 존재하는 색 표현법입니다.

마인크래프트에서 Hex Color 은

RGB Birdflop - Minecraft RGB Gradient Creatorwww.birdflop.com

사이트를 참조하면 색을 사용하는데 많은 도움을 받을 수 있습니다.

Hex Color 같은 경우는 #333333 형식은 거의 항상 동일하지만 플러그인에 따라

<#333333>
<&#333333>
[#333333]

형식으로 조금 다르게 사용되는 경우가 있습니다. 이는 docs 를 참조하거나 다른 config 이 되어있는 것을 보고 눈치껏 따라하면 됩니다.

Placeholder

Placeholder 은 해당 텍스트가 그대로 사용자 UI 에 보이는 것이 아니라 그 문자열이 특정 데이터값으로 치환되는 것을 뜻합니다.

예를 들어 SigShop 의 localization.yml 중 하나를 보겠습니다.

  TRANSACTION_RECEIVED_AMOUNT: "&a● &f받은 금액: &a{amount}&f {currency}"

해당 문구는 재화를받았을 때 유저가 보는 문구입니다.

{amount} 는 획득한 재화의 숫자, 그리고 {currency} 에는 해당 통화의 이름이 자동으로 치환됩니다.

그러므로 치환된 이후에는 예를 들어

  TRANSACTION_RECEIVED_AMOUNT: "&a● &f받은 금액: &a10000&f 젤리"

형식으로 문구가 보이게 됩니다.

placeholder은 안의 내용물을 번역하여서는 안되고, placeholder 안의 변수명에 따라 이것이 어떤 데이터를 받아 치환할 지 예상하는데 도움을 줄 수 있습니다.

가끔 외부 플러그인 같은 경우 placeholder 의 이름을 배려없이 적는 경우가 존재하긴 합니다.

ex) {num} , {var} , {variable_23} , %s

그 경우 key 값을 보고 적당히 유추하고 인게임에서 확인하는 수 밖에 없긴 합니다.

.