My Picture Frame

My Pictures Frames: Native & Ultra-Optimized is a high-performance, lightweight utility system built completely from scratch to project external web images natively into your Minecraft world. Designed strictly with zero external dependencies and multiplayer efficiency in mind, it completely eliminates laggy, entity-based frames to deliver absolute creative control for server administrators, creators, and mapmakers.

🌐 Supported Languages / Idiomas Soportados:

EN | ES (es, cl, ar, mx) | PT (br)

🔄 What's New in the Latest Update

• Local Image Support: Load offline images directly from the customizable /mypictureframe_local directory (fully configurable for dedicated servers).
• Frame Lock Security: Added a lock protection toggle to restrict who can modify or break your frames.
• Precision Scale Steps: Scale sliders now adjust by 0.5 increments for cleaner aspect ratios and refined dimension fitting.
• Enhanced URL Handling: Improved web URL parsing and direct link resolutions.
• Format & Rendering Fixes: Resolved parsing issues for .webp files and fixed multi-axis alignment placement bugs.
• Drop Fix: Fixed item drops failing to trigger correctly when breaking the frame block.

🚀 Key Features

• Native Modern Performance: Built natively for Minecraft 1.21.1 and Java 21. Compiles independently for Fabric and NeoForge using lightweight vanilla code.
• Zero Library Dependencies: Just drag, drop, and play. No heavy setup APIs like CreativeCore or Architectury are required. It utilizes the game's built-in JOML library for high-speed matrix calculations.
• Cero Item Frames: Images are projected directly onto blocks via a highly optimized BlockEntityRenderer layout, completely getting rid of traditional entity-induced client FPS drops.

🧱 Crafting Recipe & In-Game Preview

My Pictures Frames Crafting Recipe

In-game overview of native picture projection.

🎨 Advanced Rendering & GUI Customization

Take absolute control over your canvas. Right-clicking a frame opens a comprehensive, pixel-perfect user interface featuring advanced transformation utilities:

📐 Layout & Formats

🔧 Transformations

Modern Formats & Sources: Supports static .webp, .png, .jpg, and .jpeg files alongside direct URLs and local server directory imports (/mypictureframe_local). Animated GIFs: Full fluid and continuous .gif asset playback system. Dynamic Scale: Precise sliders adjusting in clean 0.5 increments to stretch and resize anywhere from 1x1 up to 32x32 blocks. Aspect Ratio Lock: Smart proportion toggle. Re-adjusts height automatically based on the image's raw pixel dimensions to prevent distorted art.

Axis Placement & Mirroring: Flawless placement across distinct axis alignments, with instant Horizontal (X) and Vertical (Y) mirroring. Free Rotation: Pivot images in fixed 90°, 180°, and 270° angle positions over their central point. Security Lock: Built-in toggle to prevent unauthorized players from breaking or editing your canvases. Stitch & Invisible Mode: Make the boundary block completely invisible so images float smoothly, or stitch them flat into any adjacent wall layout.

🚀 Performance & Extreme Optimization

Built straight with enterprise server environments in mind, the mod runs a series of advanced client-side micro-optimizations:

• Asynchronous Threading: Network HTTP downloads and complex GIF frame decoding run completely isolated from Minecraft's main loop, keeping your frame rates buttery smooth.
• Distance & Occlusion Culling: Automatically unloads and stops processing image frames or animations when a player moves past the maximum config distance or behind solid occlusion walls.
• Pre-decoded RAM Buffer: Assets are cached into native graphics memory (NativeImage) asynchronously, optimizing GPU interaction and preventing micro-stutters.

📂 Smart Portable Cache System

Never worry about broken links or missing images ever again:

• Singleplayer Maps: Assets save directly into your world file (saves/<world>/mypictureframe_cache/). Perfect for exporting custom maps; other players will see your frames instantly without internet downloads.
• Multiplayer Security: Isolates client disk caches cleanly based on the server's IP address. If an external URL goes offline, the mod falls back and renders the cached local image automatically.

💡 Glow-in-the-Dark Filters

An absolute aesthetic game-changer for neon signs, movie theaters, and cyber decorations. Features a multi-state selector:

• Disabled: Normal ambient shading. Frames darken naturally when night falls.
• Low / Medium / High: Adjustable luminosity values. At high intensity, the canvas completely ignores the world lighting environment to glow brilliantly in full darkness (light value 15, matching Endermen eyes).

🔒 Server Security & Commands

Keep total oversight over your multiplayer server infrastructure using the centralized config/mypicturesframes.properties panel:

• Domain Whitelisting: Block malicious links instantly. The server monitors packets and drops connections to any external site not explicitly listed in your trusted domain list (e.g., imgur.com, discordapp.com).
• Persistent Player Limits: Restrict frames per non-OP player (default: 3) utilizing the native SavedData (.dat) framework. Fully immune to chunk unloads or unexpected reboots.
• Brigadier Admin Commands: Direct ununified command lines using the shorthand alias /mpf:
  • /mypictureframe setImage <x y z> <url>
  • /mypictureframe setSize <x y z> <width> <height>

📦 Modpacks & Community Redistribution

You are fully welcome to include My Pictures Frames in any public or private modpack network! No explicit permission or token request is required. We only ask that you provide a clear link back to this official CurseForge project page.

🧡 Support My Work and Unlock Exclusive Perks on Patreon!

📦 Explore the Rest of My Ecosystem

Discover more lightweight, high-performance standalone vanilla expansions built natively for modern server environments.