[{"data":1,"prerenderedAt":266},["ShallowReactive",2],{"docs-page-tutorials\u002Fminecraft\u002Fhow-to-install-plugins":3},{"id":4,"title":5,"body":6,"category":256,"deprecated":257,"description":258,"extension":259,"meta":260,"navigation":261,"path":262,"seo":263,"stem":264,"__hash__":265},"docs\u002Fko\u002Ftutorials\u002Fminecraft\u002Fhow-to-install-plugins.md","마인크래프트 플러그인은 어떻게 설치하고 관리하나요?",{"type":7,"value":8,"toc":247},"minimark",[9,18,23,28,49,65,69,117,129,133,153,160,164,181,184,188,196,230,238],[10,11,12,13,17],"p",{},"플러그인은 Paper, Spigot, CraftBukkit 같은 서버 구동기에 기능을 추가하는 ",[14,15,16],"code",{},".jar"," 파일입니다. Vanilla 서버나 Forge·Fabric 모드 로더에는 Paper 플러그인을 설치할 수 없습니다.",[19,20,22],"alert",{"type":21},"danger","\n플러그인은 인스턴스의 파일과 네트워크에 접근할 수 있습니다. 공식 배포처와 개발자를 확인하고, 출처를 신뢰할 수 없는 파일은 설치하지 마세요.\n",[24,25,27],"h2",{"id":26},"설치-전-확인","설치 전 확인",[29,30,31,40,43,46],"ol",{},[32,33,34,39],"li",{},[35,36,38],"a",{"href":37},"\u002Ftutorials\u002Fminecraft\u002Fbackup-and-restore","서버를 백업","합니다.",[32,41,42],{},"플러그인이 현재 Minecraft와 서버 구동기 버전을 지원하는지 확인합니다.",[32,44,45],{},"필수 의존성 플러그인이 있는지 확인합니다.",[32,47,48],{},"플러그인의 공식 설치·업데이트 안내와 변경 사항을 읽습니다.",[10,50,51,52,58,59,64],{},"Paper 플러그인은 ",[35,53,57],{"href":54,"rel":55},"https:\u002F\u002Fhangar.papermc.io\u002F",[56],"nofollow","Hangar",", ",[35,60,63],{"href":61,"rel":62},"https:\u002F\u002Fmodrinth.com\u002Fplugins",[56],"Modrinth"," 또는 개발자의 공식 GitHub 릴리스에서 찾을 수 있습니다.",[24,66,68],{"id":67},"플러그인-설치","플러그인 설치",[29,70,71,78,91,101,104,111],{},[32,72,73,74,77],{},"서버 콘솔에서 ",[14,75,76],{},"stop","을 입력하고 Java 프로세스가 완전히 종료될 때까지 기다립니다.",[32,79,80,81,83,84,87,88,90],{},"내려받은 파일이 ",[14,82,16],{},"인지 확인합니다. ",[14,85,86],{},".zip","으로 배포된다면 압축을 풀고 Paper 또는 Bukkit용 ",[14,89,16],{},"를 찾습니다.",[32,92,93,94,97,98,100],{},"서버 실행 파일과 같은 위치에 있는 ",[14,95,96],{},"plugins"," 폴더에 ",[14,99,16],{},"를 넣습니다.",[32,102,103],{},"서버를 시작합니다.",[32,105,106,107,110],{},"콘솔 또는 게임에서 ",[14,108,109],{},"\u002Fplugins","를 실행해 플러그인 이름이 정상 상태로 표시되는지 확인합니다.",[32,112,113,116],{},[14,114,115],{},"logs\u002Flatest.log","에서 해당 플러그인의 오류나 경고를 확인합니다.",[10,118,119,121,122,124,125,128],{},[14,120,96],{}," 폴더 안의 하위 폴더가 아니라 바로 아래에 ",[14,123,16],{}," 파일을 놓아야 합니다. 처음 실행한 뒤 생성되는 ",[14,126,127],{},"plugins\u002F플러그인이름"," 폴더에는 일반적으로 설정과 데이터가 저장됩니다.",[24,130,132],{"id":131},"플러그인-업데이트","플러그인 업데이트",[29,134,135,138,144,150],{},[32,136,137],{},"새 버전이 현재 서버와 호환되는지 확인합니다.",[32,139,140,141,143],{},"서버를 중지하고 플러그인 ",[14,142,16],{},"와 설정 폴더를 백업합니다.",[32,145,146,147,149],{},"기존 ",[14,148,16],{},"를 새 파일로 교체합니다. 같은 플러그인의 구버전과 신버전을 함께 두지 마세요.",[32,151,152],{},"서버를 시작하고 시작 로그와 플러그인 기능을 확인합니다.",[10,154,155,156,159],{},"운영 중인 서버에서 ",[14,157,158],{},"\u002Freload","로 플러그인을 다시 불러오지 마세요. Paper는 플러그인 변경 후 서버를 완전히 재시작하는 방식을 권장합니다.",[24,161,163],{"id":162},"플러그인-제거","플러그인 제거",[29,165,166,169,175,178],{},[32,167,168],{},"서버를 중지합니다.",[32,170,171,172,174],{},"플러그인 ",[14,173,16],{},"를 서버 폴더 밖의 임시 보관 위치로 이동합니다.",[32,176,177],{},"서버를 시작해 다른 플러그인과 서버 기능에 문제가 없는지 확인합니다.",[32,179,180],{},"더 이상 데이터가 필요하지 않은 것이 확인된 뒤에만 해당 플러그인의 설정 폴더를 정리합니다.",[10,182,183],{},"설정 폴더를 먼저 삭제하면 복구하기 어려울 수 있으므로 바로 지우지 않는 편이 안전합니다.",[24,185,187],{"id":186},"로드되지-않을-때","로드되지 않을 때",[10,189,190,192,193,195],{},[14,191,109],{},"에서 이름이 표시되지 않거나 비활성 상태라면 ",[14,194,115],{},"에서 다음 표현을 찾습니다.",[197,198,199,205,215,221],"ul",{},[32,200,201,204],{},[14,202,203],{},"UnknownDependencyException",": 필요한 의존성 플러그인이 없습니다.",[32,206,207,210,211,214],{},[14,208,209],{},"InvalidPluginException"," 또는 ",[14,212,213],{},"InvalidDescriptionException",": 잘못된 파일이거나 지원하지 않는 플러그인입니다.",[32,216,217,220],{},[14,218,219],{},"UnsupportedClassVersionError",": 플러그인이 더 높은 Java 버전을 요구합니다.",[32,222,223,226,227,229],{},[14,224,225],{},"Ambiguous plugin name",": 같은 플러그인의 ",[14,228,16],{},"가 두 개 이상 있습니다.",[10,231,232,233,237],{},"원인을 찾지 못했다면 ",[35,234,236],{"href":235},"\u002Ftutorials\u002Fminecraft\u002Ftroubleshooting\u002Fserver-wont-start","서버가 시작되지 않을 때","의 플러그인 분리 절차를 따르세요.",[10,239,240,241,246],{},"자세한 내용은 ",[35,242,245],{"href":243,"rel":244},"https:\u002F\u002Fdocs.papermc.io\u002Fpaper\u002Fadding-plugins\u002F",[56],"Paper 플러그인 설치 문서","에서 확인할 수 있습니다.",{"title":248,"searchDepth":249,"depth":249,"links":250},"",2,[251,252,253,254,255],{"id":26,"depth":249,"text":27},{"id":67,"depth":249,"text":68},{"id":131,"depth":249,"text":132},{"id":162,"depth":249,"text":163},{"id":186,"depth":249,"text":187},"Stella IT Console\u002FMinecraft",false,"Paper 서버에 플러그인을 안전하게 설치하고 업데이트·제거·점검하는 방법을 알아봅니다.","md",{},true,"\u002Fko\u002Ftutorials\u002Fminecraft\u002Fhow-to-install-plugins",{"title":5,"description":258},"ko\u002Ftutorials\u002Fminecraft\u002Fhow-to-install-plugins","2f1Bv3lJK1aroCqNNiktAbj8HhNfu1i39RmLogSTvAw",1784536164869]