플러그인 사진

플러그인 소개

Bluemap 플러그인 웹사이트에서 현재 마인크래프트 월드의 모습을 3차원으로 확인할 수 있는 플러그인입니다.

적용 예시 사이트

https://bluecolored.de/bluemap/#world

config 파일 설명

1. core.conf 파일

core.conf 파일은 Bluemap 플러그인의 중요 설정을 변경할 수 있는 파일입니다.

이 파일은 버킷 폴더 내의 plugins/bluemap 폴더 내에 존재하는 파일입니다.

해당 파일을 텍스트 에디터로 열 경우 아래와 같은 내용이 기본적으로 작성되어 있습니다. (기본값은 아래 코드 블록을 확인해 주세요)

accept-download: false
renderThreadCount: -2
metrics: true
data: "bluemap"

1.  accept download
   • bluemap 플러그인을 정상적으로 사용하기 위해서는 이를 true로 변경해 주어야 합니다,
2.  renderThreadCount
   • 얼마나 많은 render thread(process)들을 bluemap 플러그인이 생성할지 설정하는 옵션입니다.
   • 음수로 설정할 경우, 서버가 구동되는 컴퓨터의 코어 개수에서 작성된 값만큼 뺀 값 만큼 스레드가 생성됩니다.
     • 만약 컴퓨터가 8코어일 경우 기본적으로 render thread는 6개가 생성됩니다. (renderThreadCount의 값이 -2인 경우)
   • 서버의 퍼포먼스가 걱정되신다면 1로 설정하는 것을 추천드립니다.
3.  metrics
   • 서버 플러그인 정보를 수집하는 metrics 관련 설정입니다.
4.  data
   • data 값과 폴더의 이름은 동일해야 합니다.

2. render.conf 파일

render.conf 파일은 맵을 렌더링 하는 것과 관련한 설정을 지정할 수 있는 파일입니다.

core.conf 파일과 마찬가지로 /plugins/bluemap 파일에 기본적으로 존재합니다.

아래는 처음 render.conf 파일을 편집기로 열었을 때 작성되어 있는 설정들입니다. (기본값은 아래 코드 블록을 확인해 주세요)

webroot: "bluemap/web"
useCookies: true
enableFreeFlight: true
maps: [
  {
    id: "world"
    name: "World"
    world: "world"

    # Optional advanced config fields:
    startPos: [500, -820]
    skyColor: "#7dabff"
    ambientLight: 0
    renderCaves: false
    minX: -4000
    maxX: 4000
    minZ: -4000
    maxZ: 4000
    minY: 50
    maxY: 126
    renderEdges: true
    useCompression: true
    ignoreMissingLightData: false
  },
  {
    # 이곳에는 id와 name, 그리고 world 값이 다른 월드에 대한 정보가 작성됩니다.
  }
]

1. webroot
   • 렌더링 한 맵에 대한 정보와 웹 앱(웹페이지에 관한 정보라고 생각하시면 편합니다)이 어디 폴더에 저장될지 설정합니다.
2. useCookires
   • 웹 지도 페이지에서 쿠키를 사용할지 설정하는 항목입니다.
   • 쿠키는 유저 개인이 설정해 놓은 세팅을 저장하는 용도로만 사용됩니다. (조감도, 실제 플레이에 유사한 시점 설정 등)
3. enableFreeFlight
   • 웹 지도 내 1인칭 시점에서 공중에서 서버 월드를 조경할 수 있는지 설정하는 항목입니다.
4. maps
   • 이 설정을 바탕으로 원하는 만큼의 맵을 웹에서 볼 수 있게 설정할 수 있습니다.

1. id
   • 맵의 id를 설정하는 부분입니다. 영어 소문자와 _만 사용할 수 있습니다.
   • map 항목 내에서 id는 유일해야 합니다.
2. name
   • 웹에서 해당 맵을 어떻게 표시할지 설정하는 영역입니다.
3. world
   • 렌더링한 월드 폴더의 명칭입니다.
4. startPos
   • x축과 z축에 대해서 처음 웹 지도에 들어갔을 때 표시될 좌표를 설정할 수 있습니다.
5. skyColor
   • css 스타일의 hex 포맷으로 하늘의 색상을 설정할 수 있습니다
   • 이 설정을 활용해 네더와 엔더 월드의 색상을 웹 지도 상에서 각각 어두운 빨간색, 그리고 검은색으로 변경할 수 있습니다.
6. ambientLight
   • 실제 게임 속의 광원 효과는 생각하지 않고 모든 블록이 최대 밝기인 것처럼 맵을 표시할지 설정하는 기능입니다.
   • false일 경우 게임 내 밝기에 맞추어 표시됩니다.
7. renderCaves
   • 밝기가 0인 부분은 렌더링할지 설정하는 기능입니다.
   • false일 경우 밝기가 0인 부분은 렌더링을 하지 않습니다.
8. minX, minY, minZ, maxX, maxY, maxZ
   • 렌더링할 월드의 최대 최소 좌표의 값을 설정하는 옵션입니다.
9. renderEdges:
   • 월드의 가장자리도 렌더링이 될지 설정하는 옵션입니다
10. useCompression
    • 타일에 대한 압축을 수행하는 옵션입니다. (이 옵션을 활성화하면 약 80% 정도 용량이 감소합니다)
    • 이 옵션을 끄는 것은 매우 매우 추천하지 않습니다
11. ignoreMissingLightData
    • 해당 지역에 빛 정보가 존재하지 않더라도 렌더링을 수행하는 옵션입니다.
    •  true로 설정할 경우 아래와 같이 나타납니다.
      • 해당 청크들은 모두 밝기 15인 것처럼 임의적으로 웹사이트 상에 표시됩니다.
      • 해당 청크들은 플레이어가 야간 설정을 하더라도 모두 밝기 15로 간주됩니다.
      • renderCaves 옵션이 false이더라도, 해당 청크 내의 동굴들은 렌더링됩니다.

3. plugin.conf 파일

plugin.conf 파일은 서버와 상호작용을 하는 것과 관련한 설정을 관리하는 파일입니다.

core.conf 파일과 마찬가지로 /plugins/bluemap 파일에 기본적으로 존재합니다.

아래는 처음 plugin.conf 파일을 편집기로 열었을 때 작성되어 있는 설정들입니다. (기본값은 아래 코드 블록을 확인해 주세요)

liveUpdates: true
skinDownload: true
hiddenGameModes: [
  "spectator"
]
hideInvisible: true
hideSneaking: false
fullUpdateInterval: 1440

1. liveUpdates
   • 실시간으로 업데이트된 정보가 필요하지 않다면, false로 설정하세요.
2. skinDownload
   • 웹 지도 상에서 플레이어를 표시할 때 개별 스킨을 적용할지 설정하는 옵션입니다.
3. hiddenGameModes
   • 여기에 작성된 게임모드인 플레이어는 웹지도 상에서 표시되지 않습니다.
4. hideInvisible
   • 투명 상태인 플레이어를 웹지도에 표시하지 않을지 설정합니다.
5. hideSneaking
   • 웅크리고 있는 플레이어를 웹지도 상에서 표시하지 않을지 설정합니다.
6. fullUpdateInterval
   • 전체 맵 업데이트 간격을 설정합니다.

4. webserver.conf 파일

webserver.conf 파일은 웹 지도 자체와 관련한 설정을 관리하는 파일입니다.

core.conf 파일과 마찬가지로 /plugins/bluemap 파일에 기본적으로 존재합니다.

아래는 처음 webserver.conf 파일을 편집기로 열었을 때 작성되어 있는 설정들입니다. (기본값은 아래 코드 블록을 확인해 주세요)

enabled: true
webroot: "bluemap/web"
ip: "123.45.6.78"
port: 8100
maxConnectionCount: 100

1. enabled
   • 웹 지도를 활성화할 지 선택하는 옵션입니다.
2. webroot
   • 웹에 호스팅할 루트 폴더를 설정합니다.
   • render.conf 파일의 webroot와 동일한 값을 가져야 합니다.
3. ip
   • 웹 지도의 IP주소를 결정하는 곳입니다.
4. port
   • 포트를 설정하는 곳입니다.
5. maxConnectionCount
   • 해당 사이트에 동시에 접속할 수 있는 최대 인원 수를 설정합니다.

명령어

다운로드 링크

https://www.spigotmc.org/resources/bluemap.83557/

위 링크에서 Download Now 버튼을 클릭하신 후 버킷 폴더 내의 plugins 폴더에 적용하시면 가능합니다!

​​