Loading content...
Feb 17, 2026
Calculating...
Back to Knowledge Base
Guide
3D Modeling (GLB) for Bloxd.io
How to create 3D models for Bloxd using Blockbench.
How to create 3D models for Bloxd using Blockbench.
The Bloxd rendering engine enforces strict performance constraints to ensure compatibility across diverse device specifications, including mobile platforms with limited processing capabilities. Custom item models must adhere to the following technical requirements to achieve approval and proper in-game functionality.
| Requirement | Limit | Notes |
|---|---|---|
| Polygon Count | ~12,000 Triangles | Maximum triangle count for optimal performance. Models exceeding this threshold may experience rendering issues or rejection. Lower-detail models (6,000-8,000 triangles) provide better performance headroom. |
| File Size | < 2MB (Recommended) | Binary glTF (.glb) file size limit. Excessive file sizes increase loading times and may cause mobile device compatibility issues. Texture compression and geometry optimization reduce file size. |
| Texture Map | Maximum 1024x1024px | Single texture atlas resolution limit. Higher resolutions cause performance degradation. Use 512x512px for simple models. Embedded textures must be compressed appropriately. |
| Format | Binary glTF 2.0 (.glb) | Only supported format. All model data including meshes, textures, and materials must be embedded in a single .glb file. Separate texture files are not supported. |
| Materials | PBR Standard | Physically-Based Rendering materials only. Supports base color, metallic, roughness, and normal maps. Complex shader networks are not preserved during import. |
Models that violate these constraints will either fail to import or display incorrectly in-game. Test models on lower-end devices when possible to ensure acceptable performance across the player base.
Blockbench represents the community-standard 3D modeling application for Bloxd custom items. The software provides specialized tools optimized for voxel-based and low-polygon modeling while supporting the required glTF 2.0 export format.
Creating a new project in Blockbench requires selecting the "Generic Model" format. This format provides unrestricted geometry creation without the constraints imposed by Minecraft-specific formats. Avoid using "Java Block/Item" or "Bedrock Model" formats as these impose limitations incompatible with Bloxd requirements.
Blockbench operates on a cube-primitive workflow where models are constructed from rectangular cuboid elements. Each cube can be positioned, scaled, and rotated independently. For organic shapes, utilize small cube elements to approximate curved surfaces. The software automatically triangulates cube geometry during export, so the displayed cube count does not directly correspond to the final triangle count.
Blockbench provides automatic UV unwrapping for cube-based geometry. Access the UV panel to review texture mapping and make adjustments. Create a texture atlas in the Paint tab, ensuring the resolution does not exceed 1024x1024 pixels. Each cube face can be painted individually, or external texture files can be imported. Ensure all texture data is embedded in the final export rather than externally referenced.
Navigate to File → Export → Export glTF Model. Select the Binary (.glb) option, not the separate .gltf format. Verify that "Embed Textures" is enabled to ensure the texture atlas is included in the binary file. The resulting .glb file should contain all model data in a single package ready for Bloxd import.
Efficient polygon utilization maximizes visual quality while maintaining performance requirements. The following optimization strategies reduce triangle counts without significant visual degradation.
The Bloxd engine supports limited animation functionality for custom models. Understanding these constraints prevents development of incompatible animation systems.
Current Limitation: The Bloxd rendering pipeline does not currently support skeletal animation or vertex animation for custom item models. Animated textures and shader-based effects are similarly unsupported.
All animation data embedded in glTF files will be ignored during import. Custom items render as static meshes regardless of animation data presence. Model creators should focus on optimizing the static pose appearance rather than developing animation systems.
Future engine updates may introduce animation support. Monitor official development announcements for capability expansions. When animation support is implemented, existing static models will likely require manual conversion to utilize the new functionality.
Proper material configuration ensures custom models render as intended across different device specifications and lighting conditions.
The primary texture map defining surface color. Ensure adequate contrast and avoid excessively dark or bright values that may display poorly under varying in-game lighting. Recommended value range: 30-220 RGB for most surfaces.
Defines reflective behavior. Full metallic (1.0) creates mirror-like reflections appropriate for metal surfaces. Non-metallic (0.0) for fabric, wood, or organic materials. Avoid intermediate values unless simulating specific material types.
Controls surface smoothness and specular highlight distribution. High roughness (0.8-1.0) creates matte surfaces. Low roughness (0.0-0.3) produces glossy, polished appearances. Texture variation in roughness maps adds visual interest.
Simulates surface details through lighting calculations without additional geometry. Normal maps enable the appearance of engravings, seams, or surface imperfections at zero polygon cost. Ensure normal maps are generated in tangent space for proper rendering.
Test materials under various in-game lighting conditions (daylight, torchlight, shadow) to ensure consistent visual quality. Some material configurations may appear incorrect under specific lighting scenarios.
Systematic testing prevents common issues that may cause model rejection or in-game display problems.
File Size Check: Verify the .glb file size remains under 2MB. If exceeded, reduce texture resolution or simplify geometry.
Triangle Count: Use Blockbench's statistics panel or external glTF viewers to confirm polygon count remains below 12,000 triangles.
Texture Embedding: Open the .glb file in a glTF viewer (e.g., online validators) to confirm textures display correctly without external dependencies.
After successful upload, test the custom item in multiple contexts:
• Held first-person view (verify proportions and positioning)
• Third-person view on player model (check scale and orientation)
• Dropped item entity (confirm visibility and collision)
• Various lighting conditions (daylight, shadow, artificial light)
Black/Missing Textures: Texture not properly embedded. Re-export with "Embed Textures" enabled.
Incorrect Orientation: Model rotated improperly. Adjust rotation in Blockbench before export.
Excessive Brightness: Improper metallic/roughness values. Review PBR material settings.
Performance Issues: Polygon count too high. Optimize geometry and reduce triangle count.
While Blockbench represents the recommended workflow, alternative 3D modeling applications can be utilized with appropriate export configuration.
Professional-grade open-source modeling application. Provides significantly more powerful modeling tools than Blockbench but requires steeper learning curve. Blender natively supports glTF 2.0 export with proper configuration. Enable "glTF Binary (.glb)" format and ensure all textures are embedded via the export options panel.
Recommended for complex organic models or when precise polygon optimization is required.
Professional commercial applications. Require glTF export plugins to generate compatible formats. These applications provide industry-standard modeling tools but impose licensing costs and significant complexity for simple item creation.
Only recommended for users already proficient with these platforms.
Various browser-based 3D editors support glTF export. These provide accessibility advantages but typically offer limited feature sets compared to desktop applications. Verify export format compatibility before investing significant modeling time.