MAC RETINA REDUCER

A lightweight, client-side rendering optimizer for NeoForge, engineered specifically for macOS players on Retina displays.

OVERVIEW

By default, Minecraft on macOS forces rendering at your display's massive physical Retina resolution (up to 3420×2146).

On fanless laptops like the MacBook Air (M1/M2/M3) or when running modern heavy modpacks, this causes:

• Severe GPU Overload — Processing millions of redundant pixels.
• Thermal Throttling — Heavy stuttering, sudden FPS drops, and choppy frame delivery.
• Battery Drain — Rapid power consumption and excessive thermal buildup.

While Fabric players historically had Sodium Extra, modern NeoForge players lacked a native, standalone solution.
Mac Retina Reducer bridges this gap with zero bloat and maximum stability.

HOW IT WORKS

[ Native Retina: 3420x2146 ] ──▶ [ Mod Target: 1710x1073 ] ──▶ [ Native Upscaled Output ] (Extreme GPU Load) ──▶ (Optimized 1080p Load) ──▶ (Zero Thermal Throttling)

1. Resolution Interception — Renders the 3D world at a hardware-friendly resolution (1080p equivalent).
2. Hardware-Accelerated Scaling — Upscales the presentation cleanly to fill your entire display with no black borders.
3. Smart Display Detection — Automatically detects Retina panels vs. standard 1x external monitors to prevent over-scaling.
4. Shader Outline Preservation — Mob glowing outlines and highlight effects stay pixel-perfect.

Reduces GPU fill-rate load by up to 75%, keeping your Mac cool and frame rates rock-solid.

KEY FEATURES

• DRAMATIC PERFORMANCE GAIN
  Eliminates thermal throttling lag spikes entirely on Apple Silicon (M1 / M2 / M3 / M4).

• INTELLIGENT MULTI-MONITOR SUPPORT
  Automatically identifies whether the game window is on an internal Retina display or an external standard monitor (1080p, 1440p), preserving native 1x resolution where appropriate.

• SEAMLESS FULLSCREEN HANDLING
  Effortlessly toggle between Fullscreen (F11) and Windowed modes with zero stretching, zero black borders, and zero coordinate offsets.

• PROVEN MODPACK COMPATIBILITY
  Tested and fully compatible alongside Sodium, Iris, FancyMenu, ModernFix, ImmediatelyFast, and massive modpacks such as All The Mods 10 (ATM10).

• 100% CLIENT-SIDE
  Safe to use on any vanilla, NeoForge, Forge, or Fabric multiplayer server.

CONFIGURATION

The mod is tuned for optimal performance right out of the box.
Settings can be customized anytime in config/mac_retina_reducer.json:

{
  "reduceResolutionOnMac": true,
  "divisor": 2
}

日本語説明 (JAPANESE GUIDE)

MacBook Air / Pro (Apple Silicon) ユーザーのための軽量化 MOD
macOS 特有の「勝手に 3K〜4K 相当の超高解像度でレンダリングされて Mac が過熱・カクつく」問題を根本から解消します。

主な特徴

• 最大 75% の描画負荷削減
  描画ピクセル数を 1/4（フルHD相当）に抑え、サーマルスロットリングによる激しいフレームレート低下を防ぎます。
• 外付けモニター・Retina 自動判別
  ウィンドウのあるモニターを自動判別し、Retina ディスプレイでのみ解像度を削減。1080p や 1440p 等の一般的な外部モニター接続時に画面が巨大化してしまう不具合を解消しました。
• フルスクリーン切り替えの完全安定化
  ウィンドウモードと全画面（F11）の切り替え時も、黒枠や画面のズレを起こさず画面全体に美しくフィットします。
• Sodium / Iris / 大型 Modpack 完全対応
  All The Mods 10 (ATM10) などの大型環境でも安定して動作します。
• 完全クライアントサイド
  あらゆるマルチプレイサーバーにそのまま導入してプレイ可能です。