v0.6.1

v0.6.0의 호스트 장애 인수와 이관에서 발견한 문제를 고친 미리보기 릴리스입니다. Windows ZIP에는 Java 25가 포함되어 있습니다.

꼭 업데이트하세요

v0.6.0에는 인수 등으로 호스트가 된 직후 다음 일이 생길 수 있는 문제가 있었습니다.

• 호스트가 상태 확인(health)에 답하지 않아 다른 PC가 멀쩡한 호스트를 인수하고, 인수한 쪽도 같은 상태가 되어 번갈아 인수합니다.
• 실행 중인 월드를 저장 절차 없이 커밋해 공유 월드에 올리고, 그 직후 호스트가 "다른 노드가 락을 가져갔습니다"로 스스로 내려갑니다.

참가자 전원의 mcd를 v0.6.1로 맞춰 주세요. 락 형식은 v0.6.0과 같아서 섞어 써도 월드가 갈라지지는 않지만, v0.6.0 PC가 호스트가 되면 위 문제가 그대로 생깁니다. v0.6.0으로 플레이한 월드는 원격 저장소 이력에 호스팅 중에 생긴 unsaved changes found at startup 커밋이 있는지 확인해 보세요.

고친 것

• 호스트가 되는 동안 관찰 루프가 자기 락 상태를 지우고 월드 폴더를 건드리던 경합을 고쳤습니다(위 문제의 원인).
• tailnet으로 들어온 플레이어가 나가도 Paper에 약 30초 동안 접속 중으로 남던 문제를 고쳤습니다.
• 호스트가 나가서 서버를 넘길 때, 경쟁에서 진 PC의 플레이어가 새 호스트가 열리기 전에 끊기던 문제를 고쳤습니다(tailnet 사용 시).
• 넘기는 동안 transfer를 보내고 2초 만에 서버를 닫아, 느린 회선에서 막 접속한 플레이어가 옮겨 가지 못하던 문제를 고쳤습니다. 이제 모두 떠날 때까지 최대 30초 기다립니다.
• 정상 종료 중인 호스트가 마지막 저장을 올리는 동안 상태 확인에 답하지 않아, 느린 회선에서 다른 PC가 인수할 수 있던 문제를 고쳤습니다.
• 원격 저장소가 응답 없이 끊기면 호스트가 수 분간 멈춰 있던 문제를 고쳤습니다(git 작업 30초 제한).
• 호스트가 바뀌는 동안 서버 목록에서 "연결할 수 없음"으로 보이던 문제를 고쳤습니다(tailnet 사용 시).

업데이트 방법

ZIP을 풀고 mcd/mcd.exe를 실행하세요. 앱 안의 업데이트 안내를 따라도 됩니다. 기존 월드와 설정은 그대로 유지됩니다.

검증 및 한계

• 새 도커 실험실에서 컨테이너마다 PC 하나로 실제 구성(tailnet, 같은 포트)을 만들어 handoff, 느린 회선, DERP 중계만 가능한 경우, 버전 혼합, 멈춘 호스트, 네트워크 분할을 확인했습니다. 모든 장애 시나리오에서 writer가 동시에 둘이 되거나 공유 이력이 거꾸로 가지 않았습니다.
• 단위 테스트 전체와 Paper E2E(호스트 이관, 첫 접속 대기, 빠른 장애 인수)를 통과했습니다.
• 실험실은 Linux 컨테이너와 git daemon이라 Windows 고유 동작과 GitHub의 실제 조건은 따로 확인해야 합니다. 시나리오는 한 번에서 세 번씩 돌렸습니다.
• tailnet만 끊긴 호스트는 다른 PC에서 죽은 것으로 보여 인수당하고, 그 PC의 플레이어는 튕깁니다. 월드는 갈라지지 않습니다.

상세 기록: E11

첨부 파일: mcd-windows.zip, mcd-windows.zip.sha256.

v0.6.0

이번 버전은 빠른 호스트 장애 인수와 월드·플러그인 관리 기능을 추가한 미리보기 릴리스입니다. Windows ZIP에는 Java 25가 포함되어 있습니다.

주요 변경

• VPN health-check를 5초 간격으로 수행하고 3회 연속 실패하면 장애를 의심합니다. 재접속 시 Git 소유권을 확인해 인수하고, 기존 writer 종료를 위해 30초 기다린 뒤 서버를 시작합니다.
• 기존 writer는 원격 소유권을 20초간 확인하지 못하거나 소유권을 잃으면 Paper를 종료합니다. 별도 watchdog이 관리 스레드 정지에도 실행 허가 만료를 감시합니다.
• GUI의 월드·플러그인 관리에서 폴더·ZIP 월드 교체, 변경 전 백업 복구, 플러그인 JAR 추가·교체·제거를 지원합니다. CLI에도 동일한 관리 명령을 추가했습니다.
• 관리 작업은 서버가 종료된 동안만 적용합니다. 별도 사본과 관리 락을 사용해 부분 변경을 공유하지 않고, 변경 전 상태를 원격에 백업합니다.
• 플러그인 JAR를 모든 호스트에 공유하고 해시·의존성을 검사합니다. 일반 스냅샷에 수동으로 넣은 JAR가 섞이지 않게 했습니다.
• 같은 표시 이름의 다른 PC와 같은 로컬 사본의 중복 실행을 구분하고, 기존 버전 올리기 명령도 로컬 실행 잠금을 확인합니다.

업데이트 안내

참가자 전원의 mcd를 종료하고 v0.6.0으로 맞춘 뒤 시작하세요. 락 형식이 변경되어 이전 앱과 혼용하지 않습니다.

ZIP을 풀고 mcd/mcd.exe를 실행하세요. 기존 월드·설정은 유지됩니다. 월드 교체와 플러그인 변경은 호스트 서버를 종료한 뒤 진행하세요.

검증 및 한계

• 전체 테스트 95개 중 실패 0, 환경 조건에 따른 건너뜀 3개. 이후 추가한 로컬 잠금 회귀 테스트를 포함해 버전 올리기 테스트 4개도 통과했습니다.
• 실제 Paper 26.1.2/26.2에서 장애 인수, 이전 writer 종료, 호스트 이관·크래시 복구, 월드·플러그인 적용을 확인했습니다.
• 로컬 두 노드 시험에서 장애 후 재접속 완료는 약 56초·74초였습니다. 실제 VPN의 시간 상한을 보장하지 않습니다.
• 실제 친구 VPN, 절전·VM 정지 복귀는 추가 검증 대상입니다. GUI는 화면 렌더링을 확인했으며 실제 클릭 흐름 자동화는 수행하지 못했습니다.
• 마지막 스냅샷 이후 최대 10분의 진행은 공유되지 않았을 수 있습니다. 임의 플러그인의 SQLite·외부 DB 데이터까지 무손실 이관을 보장하지 않습니다.

상세 검증 기록: E10

첨부 파일: mcd-windows.zip, mcd-windows.zip.sha256.

v0.5.0

친구가 GitHub 계정 없이 초대 코드로 참가할 수 있게 했고, mcd 창을 새로 꾸몄으며, 호스트를 넘기는 시간을 줄였다. 사용법은 README에 있다.

받기

v0.2.0 이상을 쓰고 있다면 mcd를 켤 때 업데이트를 물어본다(CLI는 mcd-cli update). 처음이라면 mcd-windows.zip을 풀고 mcd/mcd.exe를 실행한다. 기존 설정과 월드는 그대로 쓰인다.

서명되지 않은 실행 파일이라 처음 실행할 때 Windows SmartScreen 경고가 뜰 수 있다("추가 정보" → "실행").

바뀐 것

• GitHub 계정 없이 초대 코드로 참가한다. 월드마다 그 repo 하나에만 쓰는 deploy key(SSH)를 두고, 친구는 그 키가 든 초대 코드(mcd1.로 시작)를 '월드 추가 → 친구의 월드에 참가'에 붙여 넣는다.
  • 친구 초대 버튼: 초대 코드를 복사한다. 지금까지 토큰으로 쓰던 월드는 처음 누를 때 deploy key 등록을 안내하고, 등록하면 그 PC도 키로 접속하도록 바뀐다.
  • 키 바꾸기: 새 키로 바꾼 뒤 GitHub에서 예전 키를 지우면 지금까지의 초대 코드가 끊긴다.
  • 새 월드도 토큰 없이 만든다. github.com/new에서 빈 private repo를 만들고 주소를 넣으면 deploy key 등록을 안내한다. 키는 GitHub 웹에서 등록한다(토큰으로 등록한 키는 그 토큰을 지우면 함께 지워지기 때문).
  • 예전 방식(collaborator 초대 + 토큰)으로 추가한 월드도 그대로 쓸 수 있다. 설정의 GitHub 토큰은 이제 선택 항목이다.
• mcd 창을 새로 꾸몄다. Windows의 라이트/다크 설정을 따르고, 상태 카드에 지금 상태(호스트 없음, 지금 호스트가 누구인지, 이 PC가 서버를 띄우는 중, 접속 인원)와 접속 주소가 나온다. 로그와 Paper 콘솔은 접어 둔다. 안내 문구는 존댓말로 바꿨다.
• 호스트를 넘기는 시간을 줄였다(실측 약 35초 → 22초). 서버 파일(Mojang jar 받기와 패치)을 월드를 열 때 미리 준비해서, 처음 서버가 되는 PC에서 20초 가까이 더 걸리던 것을 없앴다. 대신 월드를 처음 열 때 20초 안팎이 더 걸린다.
• 넘기는 동안 남은 플레이어를 잠깐 얼린다. 넘기기 직전 저장한 뒤 5~8초 동안의 플레이(놓은 블록, 인벤토리 변화)는 새 서버에 넘어가지 않는데, 그동안 움직이거나 블록을 다루지 못하게 하고 "서버를 옮기는 중"을 띄운다.

같은 월드의 친구들에게

• 초대 코드로 참가하려면 이 버전(v0.5.0) 이상이 필요하다.
• 월드 주인이 월드를 deploy key로 바꿔도, 예전 버전에서 토큰으로 접속하던 친구는 그대로 들어올 수 있다. 다만 같은 월드를 쓰는 사람끼리는 버전을 맞추기를 권한다.

알려진 한계

• 초대 코드를 가진 사람은 누구나 월드를 읽고 쓸 수 있고, 한 사람만 골라 내보낼 수 없다(키를 바꾸고 남은 사람에게 새 코드를 보낸다). 공개된 곳에 올리지 않는다.
• deploy key(SSH)는 git 명령마다 연결을 새로 맺어서, 토큰(https)보다 호스트 넘기기가 몇 초 길다(실측 약 27초).
• 넘기는 동안 날기는 막지 못한다(그동안의 이동은 넘어가지 않으므로 잃는 것은 없다).
• 아직 실제 원격 친구 환경(인터넷 너머 NAT)에서는 확인하지 않았다.
• 호스트 PC가 갑자기 꺼지면 다른 PC가 이어받기까지 최대 10분 걸린다.
• tailnet 인증 키는 월드 repo에 들어가므로 초대받은 사람에게 보이고, GitHub 토큰과 deploy key는 설정 파일에 평문으로 저장된다.
• 자동 업데이트의 해시 검증은 다운로드가 깨지지 않았는지만 보장한다(코드 서명 없음). 설치 파일(.msi)은 없다(zip을 풀어서 쓴다).

mcd-windows.zip SHA-256: 7ac143ea65450553b960dab7443f5e1abc45277f7c23d5e667b1bf84688f6dfe

v0.4.0

mcd 창에서 여러 월드를 오가고 설정을 바꿀 수 있게 했고, 월드 버전을 올린 뒤의 중요한 버그를 고쳤다. 사용법은 README에 있다.

받기

v0.2.0 이상을 쓰고 있다면 mcd를 켤 때 업데이트를 물어본다(CLI는 mcd-cli update). 처음이라면 mcd-windows.zip을 풀고 mcd/mcd.exe를 실행한다. 기존 설정과 월드는 그대로 쓰인다.

서명되지 않은 실행 파일이라 처음 실행할 때 Windows SmartScreen 경고가 뜰 수 있다("추가 정보" → "실행").

바뀐 것

• 월드 버전을 올린 뒤에도 켜 둔 mcd가 옛 버전으로 서버를 띄우던 문제를 고쳤다. mcd는 켤 때 읽은 마인크래프트(Paper) 버전을 끌 때까지 썼다. 이제 서버가 될 때마다 월드의 버전을 다시 확인한다. 같은 월드를 쓰는 친구들 모두 이 버전으로 업데이트하기를 권한다.
• mcd 창에서 할 수 있는 것이 늘었다.
  • 월드 목록: 여러 월드를 오간다. 다른 월드를 고르면 지금 월드를 저장하고(호스트였다면 접속 중인 사람에게 넘기고) 바꾼다.
  • 월드 추가: 새 월드를 만들거나 친구의 월드에 참가한다.
  • 목록에서 빼기: GitHub의 월드와 이 PC의 사본은 지우지 않는다.
  • 버전 올리기: 지금 월드의 마인크래프트 버전을 올린다(되돌릴 수 없음, 누가 플레이 중이면 안 됨).
  • 설정: 내 이름, GitHub 토큰, 내 서버 주소를 바꾼다. 토큰은 GitHub에 확인한 뒤에 저장한다.

알려진 한계

• 아직 실제 원격 친구 환경(인터넷 너머 NAT)에서는 확인하지 않았다(같은 PC의 VM과 Headscale로 확인).
• 호스트를 넘길 때 나가는 PC의 플레이어도 같이 끊긴다.
• 호스트 PC가 갑자기 꺼지면 다른 PC가 이어받기까지 최대 10분 걸린다.
• tailnet 인증 키는 월드 repo에 들어가므로 collaborator에게 보이고, GitHub 토큰은 설정 파일에 평문으로 저장된다.
• 자동 업데이트의 해시 검증은 다운로드가 깨지지 않았는지만 보장한다(코드 서명 없음).
• 설치 파일(.msi)은 없다(zip을 풀어서 쓴다).

mcd-windows.zip SHA-256: 7cf60b7e86282699cb324547a81be32e6a0da196a1e6cbe12229d3b6f1a57b5b

v0.3.1

v0.3.0의 버그 수정. 사용법은 README에 있다.

받기

v0.2.0 이상을 쓰고 있다면 mcd를 켤 때 업데이트를 물어본다(CLI는 mcd-cli update). 처음이라면 mcd-windows.zip을 풀고 mcd/mcd.exe를 실행한다.

서명되지 않은 실행 파일이라 처음 실행할 때 Windows SmartScreen 경고가 뜰 수 있다("추가 정보" → "실행").

바뀐 것

• 같은 PC에서 mcd 두 개(예: GUI와 CLI)가 같은 Paper 버전을 동시에 받으면 한쪽이 "해시가 다르다"로 꺼지던 문제를 고쳤다. 받는 중인 파일을 서로 덮어쓰고 있었다.
• 마인크래프트 26.2에서 호스트 이관을 정품 클라이언트로 확인했다. 호스트를 끄고 35초 만에 다음 호스트로 옮겨 같은 위치에서 이어졌고, 월드는 갈라지지 않았다.

알려진 한계

• 아직 실제 원격 친구 환경(인터넷 너머 NAT)에서는 확인하지 않았다(같은 PC의 VM과 Headscale로 확인).
• 호스트를 넘길 때 나가는 PC의 플레이어도 같이 끊긴다.
• 호스트 PC가 갑자기 꺼지면 다른 PC가 이어받기까지 최대 10분 걸린다.
• tailnet 인증 키는 월드 repo에 들어가므로 collaborator에게 보이고, GitHub 토큰은 설정 파일에 평문으로 저장된다.
• 자동 업데이트의 해시 검증은 다운로드가 깨지지 않았는지만 보장한다(코드 서명 없음).
• 설치 파일(.msi)은 없다(zip을 풀어서 쓴다).

mcd-windows.zip SHA-256: 6260e934c77aceebe73ceead9692f2aa3c66b64585e9a110e7aed1a3fb71e047

v0.3.0

새 월드의 마인크래프트 버전을 26.2로 올렸다. 사용법은 README에 있다.

받기

v0.2.0을 쓰고 있다면 mcd를 켤 때 업데이트를 물어본다(CLI는 mcd-cli update). 처음이라면 mcd-windows.zip을 풀고 mcd/mcd.exe를 실행한다.

서명되지 않은 실행 파일이라 처음 실행할 때 Windows SmartScreen 경고가 뜰 수 있다("추가 정보" → "실행").

바뀐 것

• 새 월드는 마인크래프트 26.2(Paper 26.2-133)로 만들어진다. 26.1.2는 Paper 지원이 끝났다(2026-07-26). 정품 26.2 클라이언트로 중계 대기(첫 기동 32초), 정품 인증, 플레이를 확인했다.
• 기존 월드는 그대로다. 월드의 버전은 월드가 정하므로 26.1.2 월드는 계속 26.1.2로 돈다. 올리려면 모두 나간 상태에서 mcd-cli upgrade-paper --paper 26.2(되돌리기는 불가). 26.1.2 월드를 26.2로 여는 업그레이드는 에러 없이 되는 것을 확인했다.
• mcd-cli init --paper <버전>으로 새 월드의 버전을 고를 수 있다(버전만 주면 그 버전의 최신 안정 빌드).
• 26.2는 더 이상 "시험하지 않은 버전" 경고가 뜨지 않는다.

알려진 한계

• 아직 실제 원격 친구 환경(인터넷 너머 NAT)에서는 확인하지 않았다(같은 PC의 VM과 Headscale로 확인).
• 자동 테스트 봇이 26.1까지만 지원해서, 호스트 이관 같은 여러 명 시나리오는 26.1.2에서 자동 테스트했고 26.2에서는 콘솔 동작 호환성 테스트와 1인 정품 접속으로 확인했다.
• 호스트 PC가 갑자기 꺼지면 다른 PC가 이어받기까지 최대 10분 걸린다.
• tailnet 인증 키는 월드 repo에 들어가므로 collaborator에게 보이고, GitHub 토큰은 설정 파일에 평문으로 저장된다.
• 자동 업데이트의 해시 검증은 다운로드가 깨지지 않았는지만 보장한다(코드 서명 없음).
• 설치 파일(.msi)은 없다(zip을 풀어서 쓴다).

mcd-windows.zip SHA-256: 6fb63a3298474631edbcd0a98a81267958a6cc3a79b0bd2878ddfe3f820d4aa9

v0.2.0 (미리보기)

v0.1.0의 알려진 한계 두 가지를 고치고, 자동 업데이트와 서버 버전 관리를 더했다. 사용법은 README에 있다.

받기

mcd-windows.zip을 풀고 mcd/mcd.exe를 실행한다. v0.1.0을 쓰고 있었다면 이번 한 번은 직접 바꿔야 한다(자동 업데이트가 이 버전부터 들어 있다). 설정(%USERPROFILE%\.mcd)과 월드는 그대로 쓰인다.

서명되지 않은 실행 파일이라 처음 실행할 때 Windows SmartScreen 경고가 뜰 수 있다("추가 정보" → "실행").

바뀐 것

• 처음 접속이 끊기지 않는다. 서버가 뜰 때까지(최대 3분) 중계가 접속을 붙잡아 둔다. 그 PC에서 처음 서버를 띄울 때(30~40초)도 접속 중 화면에서 기다렸다가 들어간다. 정품 마인크래프트 26.1.2 클라이언트로 35초 첫 기동을 끊김 없이 통과했고, 중계를 거친 정품 인증도 확인했다.
• 서버 목록을 여는 것만으로는 서버가 뜨지 않는다. 아무도 없으면 목록에 "mcd: 접속하면 서버가 시작됩니다"가 보이고, 누가 플레이 중이면 그 서버의 상태가 보인다.
• 자동 업데이트. mcd를 켤 때 새 버전이 있으면 물어보고, 동의하면 받아서 SHA-256으로 검증한 뒤 mcd를 껐다가(호스트였다면 평소처럼 저장하고 넘김) 바꾼 다음 다시 켠다. CLI는 mcd-cli update.
• 서버(마인크래프트) 버전은 앱이 아니라 월드가 정한다. 월드 주인이 mcd-cli upgrade-paper --paper <버전>으로 올릴 수 있다(되돌리기는 불가). 앱은 그 버전의 Paper를 받아 검증하고 버전별로 보관한다.
• 연결에 실패하면 "시간 초과" 대신 이유가 적힌 메시지로 끊는다.

알려진 한계

• 아직 실제 원격 친구 환경(인터넷 너머 NAT)에서는 확인하지 않았다(같은 PC의 VM과 Headscale로 확인).
• 호스트 PC가 갑자기 꺼지면 다른 PC가 이어받기까지 최대 10분 걸린다.
• tailnet 인증 키는 월드 repo에 들어가므로 collaborator에게 보이고, GitHub 토큰은 설정 파일에 평문으로 저장된다.
• 자동 업데이트의 해시 검증은 다운로드가 깨지지 않았는지만 보장한다(코드 서명 없음).
• 설치 파일(.msi)은 없다(zip을 풀어서 쓴다).

mcd-windows.zip SHA-256: 3ec2f181f77f0c22f17e1460bd1b00591084c6c2f9765b1a429561052e7a65e1

v0.1.0 (미리보기)

상시 서버 없이 친구들과 하나의 마인크래프트 월드를 공유하는 mcd의 첫 미리보기 릴리스다. 사용법은 README, 동작 방식은 ARCHITECTURE에 있다.

받기

mcd-windows.zip을 풀고 mcd/mcd.exe(GUI)를 실행한다. Java 런타임이 들어 있어서 따로 설치할 것이 없다. mcd/mcd-cli.exe는 같은 기능의 CLI다.

• Windows 10/11
• 마인크래프트 Java Edition: 새 월드는 26.1.2(26.1, 26.1.1 클라이언트도 접속됨)
• GitHub 계정과 repo 권한 토큰(월드 보관용, 메인과 분리한 계정 권장)
• 인터넷 너머의 친구와 할 때만: 월드 주인의 Tailscale 재사용 가능 인증 키(친구는 필요 없음)

서명되지 않은 실행 파일이라 처음 실행할 때 Windows SmartScreen 경고가 뜰 수 있다("추가 정보" → "실행").

들어 있는 것

• 누가 먼저 켜든 최신 월드: 접속하는 사람의 PC가 Paper 서버가 되고, 월드는 GitHub private repo에 버전으로 보관된다.
• 주소는 항상 localhost:25565: mcd의 중계가 현재 호스트로 이어주고, 호스트가 없으면 그 PC를 호스트로 만든다.
• 월드가 갈라지지 않음: git의 force 없는 push를 락(compare-and-swap)으로 써서 서버는 하나만 뜬다. 크래시 후 남은 변경은 recovery 브랜치로만 간다.
• 호스트가 나가도 계속 플레이: 접속 중인 플레이어를 transfer로 다음 호스트에게 자동으로 옮긴다.
• 빈 서버는 스스로 꺼짐: 모두 나가면 5분 뒤 월드를 올리고 내려간다. 플레이 중에도 10분마다 올라간다.
• 인터넷 너머 연결: Tailscale의 tsnet을 내장해서 친구는 설치나 로그인 없이 접속된다.
• 서버 버전은 월드가 정함: mcd-cli upgrade-paper --paper <버전>으로 월드의 마인크래프트 버전을 올릴 수 있다(되돌리기는 불가).
• GUI 첫 실행 마법사(새 월드 만들기 또는 친구의 월드 참가), CLI.

확인한 것

단위 테스트와, 실제 Paper 서버와 헤드리스 봇으로 돌리는 E2E(P0 시나리오 5개, mcd 크래시, transfer, tailnet, 호스트 이관)가 통과했다. 인터넷 너머 연결은 같은 PC의 VM과 Headscale로 확인했다.

알려진 한계

• 새 PC에서 처음 서버를 띄울 때는 첫 접속이 "시간 초과"로 끊길 수 있다. 서버 파일을 준비하느라 클라이언트의 대기 시간(약 30초)을 넘기기 때문이다. 다시 접속하면 된다. 다음 버전에서 고친다.
• 멀티플레이 서버 목록을 여는 것만으로 그 PC가 호스트가 될 수 있다. 서버 목록의 상태 확인(ping)도 접속으로 처리하기 때문이다. 아무도 들어오지 않으면 5분 뒤 다시 꺼진다. 다음 버전에서 고친다.
• 아직 실제 원격 친구 환경과 정품 클라이언트로는 확인하지 않았다.
• 호스트 PC가 갑자기 꺼지면 다른 PC가 이어받기까지 최대 10분 걸린다.
• tailnet 인증 키는 월드 repo에 들어가므로 collaborator에게 보이고, GitHub 토큰은 설정 파일에 평문으로 저장된다.
• 설치 파일(.msi)은 없다(zip을 풀어서 쓴다).

mcd-windows.zip SHA-256: bb24d592892eacbbf7fd58079dbede6a7439a88d70d0122aaa135d06dae9baae