Performance3D v2.2.1 - Extension for GDevelop

Are your 3D games you've created in GDevelop lagging and bringing you down? Well, have I got the solution for you! I've been working on this plugin for a while. It actually has gotten much larger in scope than I originally planned. Since I have put so much work into it, and since I have to pay my VS code fees, I am going to charge a minimal amount for this plugin.

What It Does:

With version 2.1, many new features have been added such as: performance monitoring with reports, visibility zones, adaptive quality, and more!

This extension dramatically improves 3D game performance through intelligent optimization techniques. It handles static object batching (combining identical models into single draw calls), animated object LOD (Level of Detail) with distance-based shadow and animation control, frustum and distance culling to hide off-screen or distant objects, shadow quality management, material optimization, and real-time performance monitoring (FPS, draw calls, triangles).

How to Use:

Quick Start (Recommended):

At scene start, call "Auto-Optimize Scene" for instant best-practice settings

Press F9 to generate a user-friendly performance report with actionable suggestions!

Features:

🎯 One-Click Optimization

🚀 Auto-Optimize Scene - Instantly enable industry-standard rendering optimizations with one action. Turns on frustum culling, balances shadow quality, and configures the renderer for peak performance.

⚡ Set Performance Mode - Choose between three presets: Fast (max speed, no shadows), Balanced (great visuals, good performance), or Quality (best graphics, slower).

🏃 Animated Character & Enemy Optimization

👾 Optimize Animated Enemies - Automatically reduce animation quality for distant characters. Keeps nearby enemies full-quality with smooth animations, pauses animations on far enemies, and completely hides them beyond a distance threshold.

📍 Set Enemy LOD Distance - Define once at scene start; all enemy optimization calls use this setting. Automatically scales shadows, animations, and visibility based on distance.

👁️ Mark Distant Objects - Tag objects as distant when they exceed a threshold distance, allowing you to skip expensive AI logic for far-away entities.

🔍 Is Object Marked Distant - Check if an object is marked as distant to conditionally run expensive calculations only for nearby objects.

🌫️ Smart Culling & Visibility

🎬 Enable Frustum Culling - Don't render objects outside the camera's view. Automatically hide geometry that's behind the player or off-screen.

📏 Set Max Render Distance - Hide objects beyond a specified distance from the camera.

⏱️ Update Distance Culling - Call every frame to apply distance-based hiding. Smoothly hides far objects to save GPU power.

👀 Hide Objects Beyond Distance - Hide a specific group of objects when they get too far away; they pop back when objects return to range.

🧲 Pick Objects Within Distance - Filter a list of objects to only those within a certain distance of a point. Great for area detection, AI range checks, and proximity sensors.

🎯 Pick Objects Within Distance of Object - Same as above, but based on another object's position instead of a fixed point.

❓ Is Within Distance - Check if a single object is within range of a point. Perfect for conditions.

🔲 Level Geometry Optimization

🧱 Batch Static Objects - Combine multiple identical static models (rocks, trees, buildings) into a single draw call. Massive performance gain for repeated assets.

🔨 Merge Static Meshes - Permanently merge multiple static geometry pieces into one mesh. Use this for level geometry that never moves.

⛰️ Simplify Distant Geometry - Automatically hide small details on far objects. Reduces triangle count without using LOD models.

🚧 Set Occluder - Mark large objects (walls, buildings) as occluders so objects behind them aren't rendered. Like portal-based culling.

🌑 Professional Shadow Control

✨ Disable/Enable Shadows - Turn all shadows on or off globally.

🎚️ Set Shadow Quality - Control shadow map resolution (128-4096 pixels). Lower = faster but blurrier, higher = crisp but slower.

❄️ Freeze Shadow Maps - Stop updating shadows every frame. Perfect for static scenes with lights that don't move. Massive performance boost.

🔄 Unfreeze Shadow Maps - Resume real-time shadow updates.

📸 Update Shadow Maps Once - When shadows are frozen, manually force a single update for when something changes.

⭕ Disable Group Shadows - Turn off shadow casting for a specific group of objects (distant enemies, small objects).

💡 Light Optimization

🕯️ Enable Light Distance Culling - Disable lights beyond a certain distance from the camera. Each light with shadows is expensive; disabling distant lights can double your FPS.

🎨 Material & Texture Optimization

📦 Simplify Materials - Convert all complex materials to unlit (basic colors). Removes expensive lighting calculations.

🎯 Optimize Materials - Share materials between objects with identical properties, reducing GPU state changes.

🖼️ Set Texture Quality by Distance - Automatically use lower-resolution texture mipmaps for faraway objects.

🎪 Visibility Zones (Portal Culling)

🏠 Create Visibility Zone - Define a rectangular area of your level. Objects in inactive zones won't render.

✅ Activate/Deactivate Visibility Zone - Turn zones on/off. Great for indoor/outdoor areas or separating level sections.

📌 Assign Objects to Zone - Mark objects to belong to a specific zone.

👁️ Update Zone Visibility - Apply zone visibility rules. Call every frame if zones change dynamically.

🎯 Is Player in Zone - Check if the player is inside a defined zone.

🔧 Advanced Rendering

📊 Sort Objects for Batching - Group objects by material to minimize render state changes.

🎬 Optimize Render Order - Sort objects so opaque geometry renders first (front-to-back), then transparent objects (back-to-front). Reduces pixel overdraw.

📉 Adaptive Automatic Quality

🔄 Enable Adaptive Quality - Automatically lower render resolution when FPS drops below target, and restore it when performance improves.

⚙️ Update Adaptive Quality - Call every frame to apply adaptive scaling.

📊 Get Adaptive Scale - Check current render scale (1.0 = full resolution, 0.5 = half).

📊 Live Performance Monitoring

📈 Get FPS - Real-time frames per second.

👁️ Count Visible Objects - How many 3D objects are currently visible.

🎨 Draw Call Count - Number of GPU render commands per frame (fewer = better). Target: <200.

🔺 Triangle Count - Total polygons being rendered. Target: <500k for smooth gameplay.

💾 GPU Memory Usage - Estimated VRAM consumed by textures and geometry.

🔍 Scene Analysis & Reporting

📋 Analyze Scene Performance - Deep scan of your entire scene. Identifies the heaviest meshes, materials, lights, and bottlenecks.

📄 Get Performance Report (JSON) - Full structured analysis data for AI agents or custom tools.

📝 Get Performance Summary (Text) - Human-readable performance report with actionable fixes.

🤖 Get AI Agent Report - Formatted for AI systems. Lists metrics, issues, and recommended actions.

📱 Log Report to Console - Print detailed analysis to browser console for debugging.

📊 Issue Count - How many performance problems detected. (0 = well optimized!)

⚠️ Top Issue - The most critical performance bottleneck.

🔺 Heaviest Mesh Name - Which 3D model is using the most polygons.

🎮 Debug & Performance Download

🔑 Enable F9 Hotkey - Press F9 anytime during gameplay to instantly download a performance report to your Downloads folder. You'll hear a beep and see a notification when it works.

💾 Download Performance Report - Manually trigger a performance analysis and save it as a file.

🎯 TL;DR - Getting Started:

At Scene Start: Add "Auto-Optimize Scene" + "Enable Debug Hotkey (F9)"

Every Frame: Add "Optimize Animated Enemies" (if you have animated 3D characters)

Press F9 while playing to get a custom report telling you exactly what to optimize next!

Follow all of my games at: https://eldritchtentacles.com/

Join my Discord here: https://discord.com/invite/XqMe7Vdrhy