마인크래프트 플러그인

WolfyUtils

by WolfyScript · 다운로드 16만

WolfyUtils 다운로드

이 사이트는 파일을 직접 제공하지 않습니다. 제작자가 올린 Modrinth 공식 페이지에서 최신 버전을 안전하게 받으세요.

WolfyUtils 소개

WolfyUtils는 Spigot 기반 플러그인을 위한 핵심 API와 유틸리티 모음입니다. 직접 게임 기능을 추가하는 플러그인이 아니라, 다른 플러그인이 인벤토리 GUI, 다국어 메시지, JSON 설정 같은 기능을 쉽게 구현하도록 돕는 라이브러리 성격의 플러그인입니다. 이 페이지에서 받는 파일은 WolfyUtilities의 Spigot 구현판입니다.

대표적으로 커스텀 제작대 레시피를 만드는 CustomCrafting이 WolfyUtils에 크게 의존합니다. CustomCrafting은 이 라이브러리의 인벤토리 API로 게임 안의 레시피 편집 화면을 만들고, JSON 유틸리티로 레시피와 아이템을 저장·불러옵니다. 그래서 서버 관리자 입장에서는 보통 이런 플러그인을 쓰기 위한 필수 구성 요소로 WolfyUtils를 설치하게 됩니다.

WolfyUtils 정보

항목	내용
종류	마인크래프트 플러그인 (라이브러리)
제작자	WolfyScript
지원 버전	1.16.5 ~ 1.21.8
서버 플랫폼	Bukkit, Paper, Purpur, Spigot
카테고리	라이브러리, 관리, 유틸리티
다운로드	약 16만 2천 회
최초 공개	2023-06-25
최근 업데이트	2025-09-21
라이선스	GPL-3.0-or-later
배포처	Modrinth

주요 특징

인벤토리 GUI API - 게임 안에서 쓰는 메뉴 화면을 함수형 방식으로 만들 수 있습니다.
다국어 지원 - JSON 언어 파일을 불러와 GUI와 메시지를 여러 언어로 보여 줄 수 있습니다.
채팅 기능 - 번역 가능한 메시지, 클릭 이벤트 콜백 등을 지원하며 3.16.1 이상에서는 Adventure 구현을 씁니다.
레지스트리 - 커스텀 아이템 등 모든 콘텐츠를 고유한 네임스페이스 키로 등록하고, 다른 플러그인이 확장할 수 있습니다.
풍부한 유틸리티 - Jackson 기반 JSON 처리, HOCON 설정, 파티클 효과, 가중치 랜덤, 플레이어 머리 텍스처, 기본 MySQL 연결, ItemBuilder, 플레이어별 데이터 저장 등을 제공합니다.

서버 설정과 사용 방법

WolfyUtils는 Bukkit, Spigot, Paper, Purpur 서버에서 동작합니다. 서버 관리자가 따로 조작할 명령어는 자료에 나와 있지 않으며, 대개 이 라이브러리를 요구하는 플러그인과 함께 plugins 폴더에 넣어 두기만 하면 됩니다.

구조적으로 API는 플러그인마다 하나씩 인스턴스가 만들어지는 방식이고, 유틸리티는 플러그인과 무관하게 어디서나 쓸 수 있습니다. 레지스트리는 WolfyUtilities 핵심에 묶여 있지만 어디서든 접근할 수 있습니다. 개발자라면 이 구조를 이해해 두면 자신의 플러그인에 연결하기 쉽습니다.

CustomCrafting처럼 WolfyUtils를 요구하는 플러그인과 버전을 맞춰 설치합니다.
라이브러리 플러그인은 단독으로는 눈에 띄는 기능이 거의 없는 것이 정상입니다.
지원 범위가 1.21.8까지이므로 더 최신 서버에서는 호환 여부를 먼저 확인하세요.

이런 분께 추천합니다

WolfyUtils는 일반 플레이어보다는 서버를 꾸리는 사람과 플러그인을 만드는 사람에게 의미가 큰 프로젝트입니다.

CustomCrafting 등 WolfyScript 계열 플러그인을 쓰려는 서버 관리자
인벤토리 메뉴를 빠르게 만들고 싶은 Spigot 플러그인 개발자
JSON·HOCON 설정과 다국어 메시지를 체계적으로 관리하고 싶은 분
커스텀 아이템을 레지스트리 방식으로 다루고 싶은 개발자

다운로드 및 설치 방법

Bukkit·Spigot·Paper·Purpur 중 하나로 서버를 준비합니다.
페이지의 Modrinth에서 다운로드 버튼으로 이동해 서버 버전에 맞는 WolfyUtils 파일을 받습니다.
받은 .jar 파일을 서버 폴더의 plugins에 넣습니다. 이 라이브러리를 요구하는 플러그인도 함께 넣습니다.
서버를 재시작하고 콘솔에 오류 없이 불러와졌는지 확인합니다.

첫 실행 때 plugins 폴더 안에 관련 설정 폴더가 만들어질 수 있습니다. 플러그인은 서버 전용이므로 싱글플레이 클라이언트에는 설치하지 않습니다. 의존 플러그인과 라이브러리 버전이 서로 맞지 않으면 불러오기 오류가 날 수 있으니 업데이트할 때는 함께 올리는 것이 안전합니다.

자주 묻는 질문

WolfyUtils만 설치하면 무엇이 달라지나요?

단독으로는 눈에 보이는 게임 기능이 거의 없습니다. 이 라이브러리를 사용하는 다른 플러그인이 있어야 의미가 생깁니다.

어떤 플러그인이 WolfyUtils를 쓰나요?

자료에 소개된 대표 사례는 CustomCrafting입니다. 레시피 편집 화면과 레시피 저장 기능에 이 라이브러리를 활용합니다.

최신 마인크래프트 버전에서도 쓸 수 있나요?

현재 표기된 지원 범위는 1.16.5부터 1.21.8까지입니다. 그 이후 버전 서버라면 배포처에서 새 버전이 있는지 먼저 확인하세요.

MySQL을 꼭 써야 하나요?

아닙니다. 기본 MySQL 연결은 유틸리티 중 하나로 제공될 뿐이며, 실제 사용 여부는 이 라이브러리를 쓰는 플러그인에 달려 있습니다.

Paper 서버에서도 문제없이 쓸 수 있나요?

지원 플랫폼에 Paper와 Purpur가 포함되어 있습니다. Spigot을 기반으로 하는 서버라면 대부분 같은 방식으로 설치하면 되며, 서버 버전이 지원 범위 안에 있는지만 확인하면 됩니다.

업데이트는 어떻게 하는 것이 좋나요?

라이브러리형 플러그인은 의존하는 플러그인과 짝을 맞추는 것이 가장 중요합니다. 일반적으로 서버를 멈춘 뒤 기존 파일을 새 파일로 교체하고, 의존 플러그인도 필요하면 함께 업데이트한 다음 재시작하는 순서가 안전합니다. 작업 전에 plugins 폴더를 백업해 두면 문제가 생겼을 때 빠르게 되돌릴 수 있습니다.

마무리

WolfyUtils는 겉으로 드러나지 않지만 여러 플러그인이 기대는 기반 라이브러리입니다. GUI, 다국어, JSON, 레지스트리 등 플러그인 제작에 자주 필요한 기능을 한곳에 모아 두었습니다. 의존 플러그인과 서버 버전을 맞춰 설치하면 큰 손이 가지 않으니, 필요한 플러그인이 요구할 때 함께 준비해 두세요.