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.

🚀 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

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

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