Skip to content
Matcha! Mods

GUI Layouts

GUI Layouts

Section titled “GUI Layouts”

The inbox, mail viewer, and compose GUIs each have a layout config. Defaults work great — only edit these if you want to customize slot positions or item appearances.

Files:

  • config/courier/guis/inbox.conf — Inbox GUI layout
  • config/courier/guis/view.conf — Mail view GUI layout
  • config/courier/guis/send.conf — Compose GUI layout

Inbox GUI

Section titled “Inbox GUI”

The main hub players see when they run /mail. It displays their mail list with pagination, folder tabs, and management tools.

Key elements:

  • Mail list — Paginated grid of mail items showing subject, sender, and status
  • Folder tabs — Inbox, Sent, Archive, Trash navigation
  • Pagination — Previous/next page buttons
  • Search and filter — Filter by read status, attachments, sender
  • Sort controls — Sort by date, sender, or subject
  • Bulk operations — Select multiple mails for archive or delete

View GUI

Section titled “View GUI”

Opens when a player clicks on a specific mail. Shows the full message content and any attached packages.

Key elements:

  • Mail content — Subject, body text, sender, and timestamp
  • Package display — Attached items, Pokemon, and currency with claim buttons
  • Reply button — Opens compose GUI pre-filled with the sender as recipient
  • Archive button — Move to archive folder
  • Delete button — Move to trash

Send GUI

Section titled “Send GUI”

Where players write and send new mail. Includes input fields for recipients, subject, and body, plus slots for attaching packages.

Key elements:

  • Recipient picker — Select online players or type a username
  • Subject input — Click to type a mail subject via chat/anvil input
  • Body input — Click to type the mail body via chat/book input
  • Attachment slots — Drag items from inventory, select Pokemon from party, add currency
  • Send button — Validates and sends the composed mail

How It Works

Section titled “How It Works”

These GUI configs use Ceremony’s ConfigGui system under the hood. Each file defines a grid of slots with types, positions, and item properties. Same patterns you’ll find in Ceremony’s GUI configuration.

If you’re familiar with Ceremony’s ConfigGui system from other mods like Journey or Tarot, the structure’s immediately recognizable.

Next Steps

Section titled “Next Steps”
  1. Tooltips — customize the hover text on GUI items
  2. Presets — create admin-defined mail templates