MailManager

리소스팩 제공자 - 초련

Resourcepack Creator - 초련

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.

• 유효 기간 설정 / Expiration timer
  
  
• 대상 지정 / Recipient selection
  
  
• 전체 전송 기능 / Send to all players
  
  
• 블랙리스트 설정 / Blacklist system
  
  
• 메일 수신 알림 / Mail notifications
  
  
• 다국어 메시지 및 GUI 커스터마이징 지원 / Full multilingual and GUI item customization support

명령어 / Commands

명령어 / 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

✉ MailSendGUI (메일 보내기 / Send Mail)

• 유효 기간 설정 버튼 / Set expiration (opens MailTimeSelectGUI)
  
  
• 대상 변경 버튼 / Select recipient (opens MailTargetSelectGUI)
  
  
• 아이템 입력 슬롯 / Item input slot (slot 14)
  
  
• 보내기 버튼 클릭 시 /mail give 명령 실행 / Executes /mail give when sending

⏳ MailTimeSelectGUI (유효기간 설정 / Expiration Time)

• 년/월/일/시/분/초 단위 조정 / Editable units: Year to Second
  
  
• 좌클릭 감소 / Left-click = decrease
  
  
• 우클릭 증가 / Right-click = increase
  
  
• "영구" 버튼 / Permanent button
  
  
• "결정" 클릭 시 돌아감 / Confirm returns to send menu

MailTargetSelectGUI (대상 선택 / Recipient Selection)

• 접속 기록이 있는 플레이어 표시 / Shows players who joined the server
  
  
• 자기 자신은 선택 불가 / Cannot select yourself

BlacklistSelectGUI (차단 목록 / Blacklist)

• 차단 시 해당 유저에게서 메일 수신 차단 / Blocks mail from selected users
  
  
• 자기 자신은 차단 불가 / Cannot block yourself

config.yml 예시 / Example
yaml

items:
  mail:
    gui:
      send-button:
        material: WRITABLE_BOOK
        custom-model-data: 0
        damage: 0
        hide-flags:
          - HIDE_ENCHANTS
          - HIDE_ATTRIBUTES
          - HIDE_UNBREAKABLE
          - HIDE_DESTROYS
          - HIDE_PLACED_ON
          - HIDE_POTION_EFFECTS
      setting-button:
        material: COMPARATOR
        custom-model-data: 0
        damage: 0
        hide-flags: false
        unbreakable: false
  page:
    next-button:
      material: ARROW
      custom-model-data: 0
      damage: 0
      hide-flags: false
    previous-button:
      material: ARROW
      custom-model-data: 0
      damage: 0
      hide-flags: false
  back-button:
    material: BARRIER
    custom-model-data: 0
    damage: 0
    hide-flags: false
  setting:
    notify-on:
      material: LIME_DYE
      custom-model-data: 0
      damage: 0
      hide-flags: false
    notify-off:
      material: GRAY_DYE
      custom-model-data: 0
      damage: 0
      hide-flags: false
    blacklist:
      material: BARRIER
      custom-model-data: 0
      damage: 0
      hide-flags: false
    language:
      material: BOOK
      custom-model-data: 0
      damage: 0
      hide-flags: false
  language:
    gui-item:
      material: PAPER
      custom-model-data: 0
      damage: 0
      hide-flags: false
  send:
    gui:
      time:
        material: CLOCK
        custom-model-data: 0
        damage: 0
        hide-flags: false
      target:
        material: PLAYER_HEAD
        custom-model-data: 0
        damage: 0
        hide-flags: false
      confirm:
        material: GREEN_WOOL
        custom-model-data: 0
        damage: 0
        hide-flags: false
  sendall:
    gui:
      time:
        material: CLOCK
        custom-model-data: 0
        damage: 0
        hide-flags: false
      exclude:
        material: BARRIER
        custom-model-data: 0
        damage: 0
        hide-flags: false
      confirm:
        material: GREEN_WOOL
        custom-model-data: 0
        damage: 0
        hide-flags: false
  time:
    gui:
      unit:
        material: CLOCK
        custom-model-data: 0
        damage: 0
        hide-flags: false
      permanent:
        material: BARRIER
        custom-model-data: 0
        damage: 0
        hide-flags: false
      chat-input:
        material: WRITABLE_BOOK
        custom-model-data: 0
        damage: 0
        hide-flags: false
      confirm:
        material: LIME_CONCRETE
        custom-model-data: 0
        damage: 0
        hide-flags: false
  blacklist:
    exclude-search:
      material: COMPASS
      custom-model-data: 0
      damage: 0
      hide-flags: false
  delete:
    gui:
      confirm-button:
        material: RED_WOOL
        custom-model-data: 0
        damage: 0
        hide-flags: false
      cancel-button:
        material: GREEN_WOOL
        custom-model-data: 0
        damage: 0
        hide-flags: false

sounds:
  gui:
    click:
      name: UI_BUTTON_CLICK
      volume: 1.0
      pitch: 1.0
    click-fail:
      name: BLOCK_NOTE_BLOCK_BASS
      volume: 0.8
      pitch: 0.8
    page-turn:
      name: ITEM_BOOK_PAGE_TURN
      volume: 1.0
      pitch: 1.2
  mail:
    claim-success:
      name: ENTITY_ITEM_PICKUP
      volume: 1.0
      pitch: 1.0
    claim-fail:
      name: ENTITY_VILLAGER_NO
      volume: 1.0
      pitch: 1.0
    delete-success:
      name: BLOCK_ANVIL_LAND
      volume: 1.0
      pitch: 0.7
    send-success:
      name: ENTITY_PLAYER_LEVELUP
      volume: 1.0
      pitch: 1.0
    receive-notification:
      name: UI_TOAST_IN
      volume: 1.0
      pitch: 1.0
    reminder:
      name: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 1.0
      pitch: 1.0
  action:
    setting-change:
      name: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 1.0
      pitch: 1.0
    selection-complete:
      name: BLOCK_NOTE_BLOCK_PLING
      volume: 1.0
      pitch: 1.0

항목에는 material, custom-model-data, damage, owner 등을 사용할 수 있습니다.
You may customize material, custom-model-data, damage, owner, and use color codes.

다국어 파일은 ko_kr.yml, en_us.yml 등으로 확장 가능합니다.

Multilingual support available via ko_kr.yml, en_us.yml, etc.