My Pictures Frames Banner

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)

🚀 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:

🎨 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: Supports static .webp, .png, .jpg, and .jpeg files alongside full native transparency and alpha channels. Animated GIFs: Full fluid and continuous .gif asset playback system. Dynamic Scale: Precise sliders to stretch and resize your canvas anywhere from 1x1 up to 32x32 blocks wide. Aspect Ratio Lock: Smart proportion toggle. Re-adjusts height automatically based on the image's raw pixel dimensions to prevent distorted art.	Axis Mirroring: Native buttons to mirror images instantly on the Horizontal (X) and Vertical (Y) axes. Free Rotation: Pivot images in fixed 90°, 180°, and 270° angle positions over their central point. Stitch & Invisible Mode: Make the boundary block completely invisible so images float smoothly, or stitch them flat into any adjacent wall layout.

📐 Layout & Formats

🔧 Transformations

Modern Formats: Supports static .webp, .png, .jpg, and .jpeg files alongside full native transparency and alpha channels.
Animated GIFs: Full fluid and continuous .gif asset playback system.
Dynamic Scale: Precise sliders to stretch and resize your canvas anywhere from 1x1 up to 32x32 blocks wide.
Aspect Ratio Lock: Smart proportion toggle. Re-adjusts height automatically based on the image's raw pixel dimensions to prevent distorted art.

Axis Mirroring: Native buttons to mirror images instantly on the Horizontal (X) and Vertical (Y) axes.
Free Rotation: Pivot images in fixed 90°, 180°, and 270° angle positions over their central point.
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>

🔮 Future Roadmaps & Community Votes

Our utility ecosystem is built in active collaboration with our community members and supporters.

🗳️ Shape the Ecosystem!
All our major development priorities, next utilities, and exclusive feature goals are entirely driven by community input. Head over to our Patreon page to view active roadmap discussions, project breakdowns, and cast your votes!

📦 Modpacks & Community
You are fully allowed to include My Pictures Frames in any of your modpacks! No explicit permissions are required. All we ask is that you provide a link back to this official CurseForge project page.

If you encounter any operational bugs or wish to share technical feedback, please drop them through our official reporting channels. Happy world building!

My Picture Frame