Hytale Guides

Guide

How to Create Custom Textures for Hytale Mods

How to Create Custom Textures for Hytale Mods

Creating custom textures for Hytale mods fundamentally revolves around understanding the game’s unique rendering pipeline and artistic principles. Unlike many modern engines, Hytale does not utilize a Physically Based Rendering (PBR) workflow, meaning there are no separate roughness, metallic, or normal maps. Instead, all visual information, including shadows, highlights, and material properties, must be meticulously painted directly onto the texture itself, adhering to a stylized, hand-painted voxel aesthetic.

Understanding Hytale’s Texture Mechanics

Before diving into creation, it’s crucial to grasp the technical and artistic framework that Hytale textures operate within:

  • Server-Side Modding: Hytale’s architecture streams mod content, including textures, from the server to connected players. This means your custom assets will be seamlessly integrated into multiplayer experiences.
  • Asset Packs: Mods are distributed as “Asset Packs,” which are structured collections of files (folders or ZIPs) containing a manifest.json and organized subfolders for various assets, including textures.
  • Art Style: Hytale’s visuals blend low-definition pixel art with hand-painted 3D elements. Textures should aim for a “retro pixel-art” feel while maintaining a modern, stylized appearance.
  • Rendering Workflow: As mentioned, Hytale’s engine does not support PBR. This is a critical distinction. Shadows, highlights, and perceived material depth are achieved through careful painting directly on the diffuse texture.
  • Model Constraints: Hytale models are constructed using only cubes and flat quads. You won’t encounter traditional 3D modeling features like triangles, edge loops, or complex topologies. Your textures will wrap around these simple geometric primitives.
  • Texture Resolutions: Consistency in pixel density is vital:
    • 64 pixels per unit: Used for high-detail elements such as player avatars, cosmetics, tools, and weapons.
    • 32 pixels per unit: Used for standard building blocks, props, and accessories.
  • Technical Specifications:
    • File Format: Textures must be PNG files with an alpha channel (32-bit RGBA) for transparency.
    • Dimensions: Texture dimensions must always be multiples of 32 pixels (e.g., 32×32, 64×64, 128×128, up to 512×512 pixels).
    • Compression: Lossless compression is required to maintain quality and avoid visual artifacts.

Workflow 1: Creating and Applying Textures with Blockbench (for Models)

This workflow is ideal for creating textures that will be applied to custom models made in Blockbench, Hytale’s officially supported modeling tool.

  1. Install Blockbench and Hytale Plugin:

    First, download and install Blockbench, a free and powerful 3D model editor. Once installed, navigate to Blockbench’s plugin marketplace and install the dedicated “Hytale Model” plugin. This plugin provides Hytale-specific model formats and export options.

  2. Prepare Your Model:

    Open Blockbench and either start a new Hytale model from scratch or import an existing .blockymodel file. For reference, you can extract the base game models by unzipping the Assets.zip file found in your Hytale installation directory. This provides valuable insight into how official models are structured.

  3. Generate or Import Your Texture:
    • Manual Creation: Use Blockbench’s built-in painting tools to directly paint your texture onto the model. Blockbench offers various brushes and color palettes suitable for pixel art.
    • Import Custom PNG: If you’ve created your texture in an external image editor (like Photoshop, GIMP, Aseprite, or Krita), save it as a PNG with an alpha channel. Then, import this custom PNG directly into Blockbench.
    • AI Generation (Optional): Some community tools, like VoxAI, can generate textures based on text prompts. If using such a tool, ensure the generated image meets Hytale’s technical specifications (PNG, alpha channel, correct dimensions) before importing.
  4. Apply Texture to Model:

    Once your texture is ready in Blockbench (either painted or imported), drag and drop the texture file onto the specific elements of your model in the 3D viewport or assign it through the texture panel. Ensure the texture mapping is correct for each cube or quad.

  5. Preview and Refine:

    Utilize Blockbench’s real-time 3D preview to see how your model looks with the applied texture. Make any necessary adjustments to the texture or model mapping to achieve the desired appearance.

  6. Export Model and Textures:

    Using the Hytale plugin in Blockbench, export your model. This process will typically save the .json model file and automatically export the associated texture(s) as PNG files into the designated folder, ensuring they are in the correct Hytale-compatible format.

Workflow 2: Importing Textures into Hytale (via Asset Editor)

This workflow focuses on integrating your pre-made textures (and potentially models) directly into Hytale using the in-game Asset Editor, making them available for use within your world or mod pack.

  1. Access the Asset Editor:

    Launch Hytale and enter a Creative World. Grant yourself operator permissions by typing /op self into the command console. Then, navigate to your inventory, select “Creative Tools,” then “Assets,” and finally “Asset Editor.”

  2. Create a Custom Resource Pack:

    Within the Asset Editor, look for an option to “Add Pack” (often represented by a three-dot menu or a plus icon). Provide a unique name, group, description, and author for your new custom pack. Save it; this action creates the necessary folder structure for your mod.

  3. Locate Your World’s Mod Folder:

    Exit the Asset Editor and return to the Hytale world selection screen. For your current world, click the “Open Folder” option. This will take you to your world’s save directory. Navigate into its Mods folder. Your newly created custom pack will have its own subfolder here.

    Tip: Custom packs created in-game are initially world-specific. To use your pack across multiple worlds or share it, copy the entire pack folder from UserData/Saves//mods to your main Hytale UserData/Mods directory. This makes it a global mod available to all your worlds.

  4. Place Your Texture Files:

    Inside your custom pack’s folder, you’ll need to place your PNG texture files in the correct hierarchical structure. Common paths include Common/Textures/ for general textures or Common/BlockTextures/ for textures specifically for blocks. Referencing the unzipped Assets.zip from your Hytale installation is an excellent way to understand the expected folder structure for different asset types.

  5. Define or Modify an Asset:

    Return to the in-game Asset Editor and select your custom pack. You can now either create a brand new asset (e.g., an item, block, or NPC) or copy an existing base game asset to modify. Assign a unique Asset ID to your new creation. Within the asset’s properties panel, you’ll find options to link your custom texture file to this asset. For blocks, this might involve specifying textures for different faces; for items, it’s typically a single texture map.

  6. Test In-Game:

    After defining your asset and linking its texture, exit and re-enter your world. This ensures that Hytale reloads all asset packs. Your custom item, block, or NPC with its new texture should now be visible and usable within the game world.

Essential Tips for Custom Texture Creation

  • Embrace the Art Style: Study Hytale’s existing textures. Aim for a hand-painted, slightly pixelated look. Shadows and highlights should be painted directly onto the texture, contributing to the stylized, almost illustrative feel.
  • Strategic Color Usage: Employ soft gradients and subtle color variations to add depth. Hytale’s aesthetic often uses warm, saturated colors. Incorporate tinted shadows (e.g., subtle purples or blues) rather than pure gray for added vibrancy.
  • Avoid Pure Black or White: Pure black (#000000) or pure white (#FFFFFF) can interact poorly with Hytale’s in-game lighting system, potentially appearing flat or overly bright. Instead, use very dark or very light tinted colors (e.g., a very dark blue or a very light yellow).
  • Brushwork Matters: When painting, use a “pencil” brush setting for crisp, defined pixel details and sharp edges. For smoother transitions, gradients, and to add volume, utilize a “soft” brush.
  • Consistent Pixel Density: Always adhere to either 32 pixels per unit for blocks and props or 64 pixels per unit for characters, tools, and items. Mixing these inconsistently will lead to visual discrepancies.
  • Correct Dimensions: Ensure all texture dimensions are strict multiples of 32 pixels (e.g., 32×32, 64×64, 128×128, etc.). Incorrect dimensions can lead to stretching or improper rendering.
  • Utilize the Asset Editor: The in-game Asset Editor is your primary tool for registering and configuring how your custom textures are used. It streamlines the process of defining new blocks, items, and NPCs.
  • Reference Game Files: Extracting the Assets.zip file from your Hytale installation is an invaluable resource. It provides direct examples of how official assets, models, and textures are structured, named, and defined.

Common Pitfalls to Avoid

  • Ignoring Hytale’s Art Style: Creating textures with a realistic, PBR, or vastly different aesthetic will make your mod feel jarringly out of place.
  • Attempting PBR Maps: Do not create or expect to use roughness, metallic, or normal maps. Hytale’s engine does not support or render them, making any effort in this direction futile.
  • Incorrect Pixel Densities or Dimensions: Using textures with dimensions not divisible by 32, or applying a 64px/unit texture where 32px/unit is expected (or vice-versa), will result in visual distortions, incorrect scaling, or rendering errors.
  • Using Pure Black or White Pixels: These can cause lighting issues and should be replaced with very dark or very light tinted colors.
  • Complex Model Geometry: Hytale’s models are cube and quad-based. Trying to import or texture models with traditional 3D polygon types (triangles, N-gons, complex curves) will not work.
  • Missing Alpha Channel: PNG textures without an alpha channel will not display transparency correctly, leading to unwanted solid backgrounds.
  • Lossy Compression: Using formats like JPEG or PNG with lossy compression will degrade texture quality. Always use lossless compression for your PNG files.
  • World-Specific Packs: Forgetting to copy your newly created asset pack from your world’s mods folder to the main Hytale UserData/Mods directory will mean your mod is only available in that specific world, limiting its usability.