Appearance UI

Appearance UI

BlueMapWebChat 4.7.0 · Minecraft 1.18–26.2 · Java 17 baseline

7. Web UI Basics

Main interface areas include:

• Public message list
• Message composer
• Login and logout controls
• DM and group-chat menus
• Search
• Pinned messages
• Emoji picker
• File upload
• Notification settings
• Moderation and administration panels

Browser-specific preferences are stored in localStorage. Theme, fonts, and notification filters can differ between browsers even for the same account. The panel can be moved and resized, and its size can be remembered. A browser-local notification inbox keeps recent notification-worthy events.

Default UI settings:

ui:
  language: "en-US"
  language-fallback: "en-US"
  time-zone: "local"
  theme: "system"
  opacity: 0.92
  resizable: true
  remember-window-size: true

Supported languages:

• en-US
• ko-KR
• ja-JP
• zh-CN

Supported themes:

• system
• dark
• light
• high-contrast

24. PWA and Picture-in-Picture

Standalone app naming:

standalone-web:
  app-name: "Web Chat"
  app-short-name: "Web Chat"

A previously installed Home Screen app may need to be reinstalled after a name change.

Picture-in-Picture:

ui:
  picture-in-picture:
    enabled: false

Browser and operating-system support is required. External window controls are owned by the browser/OS.

29. Web Fonts and Visual Configuration

web-fonts:
  enabled: false
  directory: "fonts"
  items: []

Example:

web-fonts:
  enabled: true
  items:
    - family: "Pretendard"
      file: "Pretendard.woff2"
      weight: 400
      style: "normal"

Supported extensions: WOFF2, WOFF, TTF, OTF.

Visual defaults:

ui:
  font-size: 13
  message-font-size: 13
  input-font-size: 13
  text-color: ""
  ui-text-color: ""
  input-background-color: ""
  text-shadow-mode: "auto"

Empty colors follow the selected theme.

30. Virtual Scrolling and Performance

ui:
  virtual-scroll:
    enabled: true
    overscan-screens: 0.75
    min-rendered-messages: 30
    preserve-visible-media: false
    preserve-playing-media: true
  history-preload:
    screens: 0.7
    min-px: 200

Virtual scrolling reduces browser rendering cost for long histories. Preserving more media increases memory use.

Resume refresh:

ui:
  resume-refresh:
    enabled: true
    min-interval-seconds: 5
    skip-while-media-active: true
    skip-unchanged: true

This refreshes missed messages after returning to a mobile or backgrounded page without unnecessarily interrupting active media.