How To: Creating Retextured Models

Introduction

Some mods need models that are simply re-textured versions of existing JSON models. It can be tedious to create and maintain a large number of JSON block state and model files for these repetitive scenarios. In other cases, the specific number and type of these models is dynamic or configurable and thus not suitable for static JSON assets.

The RetexturedModelBuilder interface provides a way to generate the models automatically.

public interface RetexturedModelBuilder {
    public static RetexturedModelBuilder builder(String sourceModel, String targetModel) {
        return builder(new Identifier(sourceModel), new Identifier(targetModel));
    }
    
    public static RetexturedModelBuilder builder(Identifier sourceModel, Identifier targetModel) {
        return RexturedModelBuilderImpl.builder(sourceModel, targetModel);
    }

    RetexturedModelBuilder mapSprite(Identifier from, Identifier to);

    RetexturedModelBuilder mapSprite(String from, String to);

    public void completeBlockWithItem();

    void completeBlock();

    void completeItem();
}

Using RetexturedModelBuilder