MailManager 플러그인 설명서 / Plugin Documentation
개요 / Overview
MailManager는 플레이어 간 아이템 메일 송수신을 GUI로 간편하게 처리할 수 있도록 도와주는 마인크래프트 서버용 플러그인입니다.
MailManager is a Minecraft server plugin that allows players to send and receive item-based mail through an intuitive GUI system.
명령어 / Command 설명 / Description
/mail 메일함 열기 / Open mailbox
/mail send <player> 해당 플레이어에게 메일 보내기 / Send mail to player
/mail sendall 전체 플레이어에게 메일 보내기 / Send mail to all
/mail sendall exclude 특정 대상 제외하고 전체에게 보내기 / Send to all
except certain players
/mail reset <player> 해당 플레이어의 메일 초기화 / Reset player’s mailbox
/mail notify 메일 알림 ON/OFF / Toggle notifications
/mail reload 설정 파일 다시 불러오기 / Reload config files
권한에 따라 명령어 사용이 제한될 수 있습니다.
Some commands may require specific permissions.
GUI 구성 / GUI Overview
MailGUI (메일함 / Mailbox)
yaml
language : en_us
notify:
default-enabled : true
gui-items:
mail-send:
material : PAPER
name : "§fSend Mail"
lore :
- "§7Compose a new mail"
# Optional additional settings below:
# Custom model data for resource packs
# custom-model-data: 1001
# Item damage value (applies if 0 or greater)
# damage: 5
# Player name for head item (for skin)
# skull-owner: "Notch"
# UUID-based skin for head item
# skull-uuid: "123e4567-e89b-12d3-a456-426614174000"
# Base64 texture for head item
# skull-base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6..."
previous-page:
material : ARROW
name : "§fPrevious Page"
lore :
- "§7Go to the previous page"
next-page:
material : ARROW
name : "§fNext Page"
lore :
- "§7Go to the next page"
setting:
material : COMPARATOR
name : "§fSettings"
lore :
- "§7Change mail reception settings"
blacklist:
material : BOOK
name : "§fBlacklist"
lore :
- "§7Manage blocked recipients"
send-gui-time:
material : CLOCK
name : "§fSet Expiration"
lore :
- "§7Set mail expiration time"
send-gui-target:
material : PLAYER_HEAD
name : "§fSet Recipient"
lore :
- "§7Choose who to send mail to"
exclude:
material : BARRIER
name : "§fSet Exclusions"
lore :
- "§7Select recipients to exclude"
confirm:
material : GREEN_WOOL
name : "§fSend"
lore :
- "§7Send the configured mail"
permanent:
material : CLOCK
name : "§fPermanent"
lore :
- "§7Do not set an expiration time"
select-complete:
material : LIME_DYE
name : "§fDone"
lore :
- "§7Confirm your selection and go back"
back:
material : BARRIER
name : "§fBack"
lore :
- "§7Return to the previous screen"
search-bar:
material : OAK_SIGN
name : "§fSearch"
lore :
- "§7Type a player name in chat to search"
항목에는 material, custom-model-data, damage, owner 등을 사용할 수 있습니다.
You may customize material, custom-model-data, damage, owner, and use color codes.
lang.yml 예시 / Example
yaml
gui:
mail:
title : "§fInbox"
blacklisted : "§cThis player has blocked your mail"
deleted : "§cMail deleted"
received : "§aMail received"
mail-send:
title : "§fSend Mail"
time : "§cSet Expiration"
time-lore : "§7Set how long this mail will be valid"
target : "§eSet Target"
target-lore : "§7Select who to send the mail to"
send : "§aSend"
send-lore : "§7Send the mail"
mail-sendall:
title : "§fSend to All"
mail-time:
title : "§fSet Expiration"
permanent-set : "§aExpiration removed"
unit:
second : "Seconds"
minute : "Minutes"
hour : "Hours"
day : "Days"
month : "Months"
year : "Years"
mail-target:
title : "§fSelect Target"
cannot-target-self : "§cYou can't target yourself"
sendall-exclude:
title : "§fExclusion List"
excluded : "§cExcluded"
included : "§aIncluded"
cannot-exclude-self : "§cYou can't exclude yourself"
blacklist:
title : "§fBlocked Players"
blocked : "§cBlocked"
allowed : "§aAllowed"
cannot-block-self : "§cYou can't block yourself"
removed : " has been removed from the block list"
added : " has been added to the block list"
mail-setting:
title : "⚙ Mail Settings"
notify-on : "§aMail Notification: ON"
notify-off : "§7Mail Notification: OFF"
notify-lore : "§7Enable or disable mail notifications"
notify-enabled : "§aMail notifications enabled"
notify-disabled : "§7Mail notifications disabled"
mail:
notify-received : "§aYou have received a new mail"
invalid-args : "§cUnable to send mail"
sent-all : "§aSent mail to {count} players."
sent-single : "§aMail sent successfully."
from : "§aFrom: "
sent-at : "§aSent at: "
expires : "§cExpires on: "
only-player : "§cThis command can only be used by players"
player-not-found : "§cPlayer not found"
reload-success : "§aConfiguration and data reloaded"
reset-success : "§cMail data has been reset for the player"
format:
unit:
second : "{value} seconds"
minute : "{value} minutes"
hour : "{value} hours"
day : "{value} days"
month : "{value} months"
year : "{value} years"
permanent : "Permanent"
다국어 파일은 ko_kr.yml, en_us.yml 등으로 확장 가능합니다.
Multilingual support available via ko_kr.yml, en_us.yml, etc.
개요 / Overview
MailManager는 플레이어 간 아이템 메일 송수신을 GUI로 간편하게 처리할 수 있도록 도와주는 마인크래프트 서버용 플러그인입니다.
MailManager is a Minecraft server plugin that allows players to send and receive item-based mail through an intuitive GUI system.
- 유효 기간 설정 / Expiration timer
- 대상 지정 / Recipient selection
- 전체 전송 기능 / Send to all players
- 블랙리스트 설정 / Blacklist system
- 메일 수신 알림 / Mail notifications
- 다국어 메시지 및 GUI 커스터마이징 지원 / Full multilingual and GUI item customization support
명령어 / Command 설명 / Description
/mail 메일함 열기 / Open mailbox
/mail send <player> 해당 플레이어에게 메일 보내기 / Send mail to player
/mail sendall 전체 플레이어에게 메일 보내기 / Send mail to all
/mail sendall exclude 특정 대상 제외하고 전체에게 보내기 / Send to all
except certain players
/mail reset <player> 해당 플레이어의 메일 초기화 / Reset player’s mailbox
/mail notify 메일 알림 ON/OFF / Toggle notifications
/mail reload 설정 파일 다시 불러오기 / Reload config files
권한에 따라 명령어 사용이 제한될 수 있습니다.
Some commands may require specific permissions.
GUI 구성 / GUI Overview
MailGUI (메일함 / Mailbox)
- 메일 확인 및 수령 / View & claim mail
- 페이지 전환 / Pagination (prev/next)
- 쉬프트 우클릭 시 삭제 / Shift + right-click = delete
- 유효 기간 설정 버튼 / Set expiration (opens MailTimeSelectGUI)
- 대상 변경 버튼 / Select recipient (opens MailTargetSelectGUI)
- 아이템 입력 슬롯 / Item input slot (slot 14)
- 보내기 버튼 클릭 시 /mail give 명령 실행 / Executes /mail give when sending
- 년/월/일/시/분/초 단위 조정 / Editable units: Year to Second
- 좌클릭 감소 / Left-click = decrease
- 우클릭 증가 / Right-click = increase
- "영구" 버튼 / Permanent button
- "결정" 클릭 시 돌아감 / Confirm returns to send menu
- 접속 기록이 있는 플레이어 표시 / Shows players who joined the server
- 자기 자신은 선택 불가 / Cannot select yourself
- 차단 시 해당 유저에게서 메일 수신 차단 / Blocks mail from selected users
- 자기 자신은 차단 불가 / Cannot block yourself
yaml
Code (YAML):
language : en_us
notify:
default-enabled : true
gui-items:
mail-send:
material : PAPER
name : "§fSend Mail"
lore :
- "§7Compose a new mail"
# Optional additional settings below:
# Custom model data for resource packs
# custom-model-data: 1001
# Item damage value (applies if 0 or greater)
# damage: 5
# Player name for head item (for skin)
# skull-owner: "Notch"
# UUID-based skin for head item
# skull-uuid: "123e4567-e89b-12d3-a456-426614174000"
# Base64 texture for head item
# skull-base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6..."
previous-page:
material : ARROW
name : "§fPrevious Page"
lore :
- "§7Go to the previous page"
next-page:
material : ARROW
name : "§fNext Page"
lore :
- "§7Go to the next page"
setting:
material : COMPARATOR
name : "§fSettings"
lore :
- "§7Change mail reception settings"
blacklist:
material : BOOK
name : "§fBlacklist"
lore :
- "§7Manage blocked recipients"
send-gui-time:
material : CLOCK
name : "§fSet Expiration"
lore :
- "§7Set mail expiration time"
send-gui-target:
material : PLAYER_HEAD
name : "§fSet Recipient"
lore :
- "§7Choose who to send mail to"
exclude:
material : BARRIER
name : "§fSet Exclusions"
lore :
- "§7Select recipients to exclude"
confirm:
material : GREEN_WOOL
name : "§fSend"
lore :
- "§7Send the configured mail"
permanent:
material : CLOCK
name : "§fPermanent"
lore :
- "§7Do not set an expiration time"
select-complete:
material : LIME_DYE
name : "§fDone"
lore :
- "§7Confirm your selection and go back"
back:
material : BARRIER
name : "§fBack"
lore :
- "§7Return to the previous screen"
search-bar:
material : OAK_SIGN
name : "§fSearch"
lore :
- "§7Type a player name in chat to search"
You may customize material, custom-model-data, damage, owner, and use color codes.
lang.yml 예시 / Example
yaml
Code (YAML):
gui:
mail:
title : "§fInbox"
blacklisted : "§cThis player has blocked your mail"
deleted : "§cMail deleted"
received : "§aMail received"
mail-send:
title : "§fSend Mail"
time : "§cSet Expiration"
time-lore : "§7Set how long this mail will be valid"
target : "§eSet Target"
target-lore : "§7Select who to send the mail to"
send : "§aSend"
send-lore : "§7Send the mail"
mail-sendall:
title : "§fSend to All"
mail-time:
title : "§fSet Expiration"
permanent-set : "§aExpiration removed"
unit:
second : "Seconds"
minute : "Minutes"
hour : "Hours"
day : "Days"
month : "Months"
year : "Years"
mail-target:
title : "§fSelect Target"
cannot-target-self : "§cYou can't target yourself"
sendall-exclude:
title : "§fExclusion List"
excluded : "§cExcluded"
included : "§aIncluded"
cannot-exclude-self : "§cYou can't exclude yourself"
blacklist:
title : "§fBlocked Players"
blocked : "§cBlocked"
allowed : "§aAllowed"
cannot-block-self : "§cYou can't block yourself"
removed : " has been removed from the block list"
added : " has been added to the block list"
mail-setting:
title : "⚙ Mail Settings"
notify-on : "§aMail Notification: ON"
notify-off : "§7Mail Notification: OFF"
notify-lore : "§7Enable or disable mail notifications"
notify-enabled : "§aMail notifications enabled"
notify-disabled : "§7Mail notifications disabled"
mail:
notify-received : "§aYou have received a new mail"
invalid-args : "§cUnable to send mail"
sent-all : "§aSent mail to {count} players."
sent-single : "§aMail sent successfully."
from : "§aFrom: "
sent-at : "§aSent at: "
expires : "§cExpires on: "
only-player : "§cThis command can only be used by players"
player-not-found : "§cPlayer not found"
reload-success : "§aConfiguration and data reloaded"
reset-success : "§cMail data has been reset for the player"
format:
unit:
second : "{value} seconds"
minute : "{value} minutes"
hour : "{value} hours"
day : "{value} days"
month : "{value} months"
year : "{value} years"
permanent : "Permanent"
다국어 파일은 ko_kr.yml, en_us.yml 등으로 확장 가능합니다.
Multilingual support available via ko_kr.yml, en_us.yml, etc.
Resource Information
Author:
----------
Total Downloads:
55
First Release:
May 2, 2025
Last Update:
May 3, 2025
Category:
---------------
All-Time Rating:
4 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings