godot-texture-import

Fix Godot PNG texture import and surface-binding settings.

8|3|Updated Jun 12, 2026
One-click install
npx skills add https://github.com/arthur0n/xenodot-forge --skill godot-texture-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-texture-import
Source: https://github.com/arthur0n/xenodot-forge/tree/main/plugin/skills/godot-texture-import
Command: npx skills add https://github.com/arthur0n/xenodot-forge --skill godot-texture-import

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the guesswork from importing PNG textures into Godot 4 and binding them to 3D surfaces, especially when a texture looks blurry, stretches across a face, or appears uneditable in the Inspector.

Core Features & Use Cases

  • Import Sidecar Mechanics: Explains how the .import sidecar controls texture import behavior and which settings are fixed versus art-style dependent.
  • Filter and Mipmap Selection: Clarifies the texture_filter enum trap so you can choose the correct sampling mode for the project’s style.
  • Tiling and Surface Mapping: Shows how to repeat textures correctly on walls, floors, and large faces using Texture Repeat and uv1_scale.
  • Imported Material Editing: Helps you make imported mesh materials unique so they can be edited in the scene.
  • Use Case: A level artist adds a wall texture, but it stretches instead of tiling and the imported mesh material is greyed out; this Skill gives the exact import and editing steps to fix both issues.

Quick Start

Use this skill to import a PNG in assets/textures, apply the correct Godot texture settings, and make the mesh material editable if it was imported as a shared resource.

Frequently Asked Questions about godot-texture-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Godot texture stretch across a wall face instead of tiling?

Godot texture stretching usually happens when Texture Repeat is disabled and uv1_scale is not set. You can fix texture stretching by enabling repeat behavior and adjusting the uv1_scale values on the mesh material.

How do I make an imported mesh material unique so I can edit it in the Godot Inspector?

To make an imported mesh material editable, you must convert the shared resource into a unique material within the Godot scene. This unlocks the greyed-out material properties for direct surface-binding adjustments.

How does the .import sidecar file control PNG texture import behavior in Godot?

The .import sidecar file controls PNG texture import behavior in Godot through specific keys that define fixed settings versus art-style dependent options. Correct sidecar structure ensures textures import without visual surprises.

How do I select the correct texture_filter enum to avoid blurry textures in Godot 4?

Selecting the correct texture_filter enum in Godot 4 avoids blurry textures by matching the sampling mode to your project's art style. The filter and mipmap selection prevents visual artifacts on imported assets.

What is the best way to repeat textures on large floor surfaces in Godot?

The best way to repeat textures on large floor surfaces in Godot is using Texture Repeat combined with uv1_scale adjustments. This ensures the texture maps correctly across the entire face without stretching.