Skip to content

Add Letterbox plugin#12642

Open
randall-hash wants to merge 1 commit into
runelite:masterfrom
randall-hash:add-letterbox
Open

Add Letterbox plugin#12642
randall-hash wants to merge 1 commit into
runelite:masterfrom
randall-hash:add-letterbox

Conversation

@randall-hash

Copy link
Copy Markdown

Adds Letterbox — renders the game at a smaller, configurable size centered in black space for the Resizable - Classic layout (a compact play area floating in black on large/ultrawide monitors).

Source: https://github.com/randall-hash/letterbox

How it works: it resizes the game engine component inside ClientPanel (not the canvas) and lets the panel's existing black background show in the margins. Because the engine genuinely renders at the smaller size, the interface reflows and mouse hit-detection stays correct.

Compliance notes:

  • No network/HTTP, no IP submission to any third party (so no warning= line), no file I/O.
  • No input injection, no menu entries / server actions, no reflection, Java 11.
  • Listeners/timer/layout are all torn down in shutDown (the game returns to filling the window).

One thing I want to flag proactively re: the "no moving or resizing click zones for 3D components" guideline: Letterbox resizes the entire viewport uniformly — click targets get smaller, never larger, so it confers no targeting advantage. The built-in Stretched Mode is the precedent for whole-viewport scaling. Happy to adjust if you'd prefer a different approach.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@runelite-github-app

Copy link
Copy Markdown

@runelite-github-app

Copy link
Copy Markdown

Internal use only: Reviewer details Maintainer details

@raiyni raiyni added the waiting for author waiting for the pr author to make changes or respond to questions label Jun 16, 2026
@randall-hash

Copy link
Copy Markdown
Author

Author here. I noticed the “waiting for author” label but don’t see a comment on the PR, so I wanted to check what you’d like me to address.

@runelite-github-app runelite-github-app Bot removed the waiting for author waiting for the pr author to make changes or respond to questions label Jun 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants