개인 자료란 (JE)

  서버 커뮤니티

Profile 구마공방 대표칭호 없음

sweetenpotato 7a2769d1b82447b1956af5605a67d372

Profile

자료 자바 에디션(JE) 플러그인 일반

웹에서 사실적인 마인크래프트 지도를 확인해보자! Bluemap

2021.12.04 조회 수 3838 추천 수 1
장르 웹 연동 
게임버전 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1 
API 스피곳, 페이퍼, 퍼퍼, 에어플레인 
원산지 해외 
개발자 TBlueF 
저작권 The MIT License 
자료 출처 https://www.spigotmc.org/resources/bluemap.83557/ 
소스 https://github.com/BlueMap-Minecraft/BlueMap 

플러그인 사진

65570efc89113d549b184c921412529a.png


플러그인 소개

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
    • 해당 사이트에 동시에 접속할 수 있는 최대 인원 수를 설정합니다.


명령어

명령어
퍼미션
설명
/bluemapbluemap.status렌더링 상황을 표시합니다.
/bluemap versionbluemap.version플러그인의 버전과 시스템 정보를 표시합니다.
/bluemap helpbluemap.help플러그인에 대한 명령어 목록을 표시합니다.
/bluemap reloadbluemap.reload모든 자원을 다시 불러옵니다.
/bluemap mapsbluemap.statusBluemap에 로드된 맵을 모두 표시합니다.
/bluemap worldsbluemap.statusBluemap에 로드된 맵을 모두 표시합니다.
/bluemap stopbluemap.stop모든 렌더링을 중지합니다.
/bluemap startbluemap.start모든 렌더링을 시작합니다.
/bluemap unfreeze <맵 아이디>bluemap.freeze해당 맵의 업데이트 중지를 해제합니다.
/bluemap freeze <맵 아이디>bluemap.freeze해당 맵의 업데이트를 영구적으로 중지합니다.
/bluemap purge <맵 아이디>bluemap.purge해당 맵에 대한 정보를 모두 제거합니다
/bluemap marker create <마커 아이디> <맵 아이디> [x y z] <라벨>bluemap.marker맵에 마커를 추가합니다.
/bluemap marker remove <마커 아이디>bluemap.marker맵에 마커를 삭제합니다.
/bluemap marker listbluemap.marker
마커를 모두 표시합니다.


다운로드 링크

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


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






Warning
댓글이 없습니다.

새로운 댓글을 등록해 주세요!

뉴스 및 창작물
/files/thumbnails/520/751/003/262x150.crop.jpg?20240328020349

레드스톤

마인크래프트 노트블록으로 만든 『 Bling‐Bang‐Bang‐Born 』 1

Sonttukk

2024-03-23

1

/files/thumbnails/467/742/003/262x150.crop.jpg?20240311163123

레드스톤

[노트블럭커버] MILGRAM -ミルグラム(밀그램)- / 아마네 「숙청 행진」 제 2심 2

리비온

2024-03-11

0

/files/thumbnails/846/741/003/262x150.crop.jpg?20240310221214

레드스톤

워든 vs 라마 200마리 1

GlassesFilm

2024-03-10

0

/files/thumbnails/542/739/003/262x150.crop.jpg?20240309070457

레드스톤

[고인의 명복을 빕니다][노트블럭]드래곤볼 GT 오프닝 - 점점 마음이 끌려

리비온

2024-03-09

0

/files/thumbnails/326/738/003/262x150.crop.jpg?20240328020414

레드스톤

마인크래프트 노트블록으로 만든 『 Build Our Machine 』

Sonttukk

2024-03-07

0

/files/thumbnails/952/735/003/262x150.crop.jpg?20240303230423

소식

복잡한 설치 없이 마크 애드온을 즐겨보세요! 새로운 블록, 몹, 조합법 등!

도라

2024-03-03

0

/files/thumbnails/212/735/003/262x150.crop.jpg?20240303113438

레드스톤

성장속도 실험

GlassesFilm

2024-03-03

3

/files/thumbnails/111/733/003/262x150.crop.jpg?20240301193451

레드스톤

라마침으로 농사하기 1

GlassesFilm

2024-03-01

1

/files/thumbnails/093/728/003/262x150.crop.jpg?20240226012153

레드스톤

라마샤워기

GlassesFilm

2024-02-26

0

/files/thumbnails/681/707/003/262x150.crop.jpg?20240206210005

레드스톤

리즈시절 노트블럭 곡 모음 1

리비온

2024-02-06

1

/files/thumbnails/874/702/003/262x150.crop.jpg?20240201204044

레드스톤

[노트블럭커버] Green Greens - Kirby Super Star OST 1

리비온

2024-02-01

2

/files/thumbnails/910/696/003/262x150.crop.jpg?20240127130234

소식

구리 열쇠의 사용처가 공개되었습니다! "금고 블록 공개!!" 4

이쁘니송이

2024-01-27

0