# Model API 🌐 **Мови:** [English](models.md) | [Українська](models_uk.md) Загалом цей API розроблений так, щоб імітувати поведінку новіших версій Minecraft. ### Свідомі відхилення Наразі відсутні. ### Колишні відхилення Посилання на текстури більше не вважаються прив’язаними до розташувань 1.7.10. Замість цього вони обробляються з assets/namespace/textures, як у сучасних версіях. Це також означає, що тепер ви можете використовувати будь-яку текстуру у своєму ISBRH, і GTNHLib впровадить її в атлас блоків. Будь ласка, використовуйте цю можливість відповідально. Ресурспаки тепер можуть замінювати більшість блоків, аналогічно до сучасних версій. *Зверніть увагу:* це працює насамперед для блоків із ISBRH — якщо для блоку в коді зареєстровано TESR, це призведе до рендерингу *як* моделі, *так і* TESR. ## Приклади ### BlockColor Використовуйте для застосування кольору до `TintIndex`.

Приклад: Використання реєстрації BlockColor

BlockColor.registerBlockColors(new IBlockColor() {

    @Override
    public int colorMultiplier(IBlockAccess world, int x, int y, int z, int tintIndex) {
        // Повертає червоний колір для основного шару, зелений — для додаткового
        return tintIndex == 0 ? 0xFF0000 : 0x00FF00;
    }

    @Override
    public int colorMultiplier(ItemStack stack, int tintIndex) {
        // Повертає синій колір для основного шару, жовтий — для додаткового
        return tintIndex == 0 ? 0x0000FF : 0xFFFF00;
    }
}, ModBlocks.MY_CUSTOM_BLOCK);
Приклад: Реалізація `IBlockColor` безпосередньо у класі блоку
public class BlockTestTint extends Block implements IBlockColor {

   public BlockTestTint() {
       super(Material.wood);
   }

   @Override
   public int colorMultiplier(IBlockAccess world, int x, int y, int z, int tintIndex) {
       return switch(tintIndex) {
           case 0 -> 0xFF0000; // червоний
           case 1 -> 0x00FF00; // зелений
           case 2 -> 0x0000FF; // синій
           case 3 -> 0xFFFF00; // жовтий
           case 4 -> 0xFF00FF; // пурпуровий
           case 5 -> 0x00FFFF; // блакитний
           default -> 0xFFFFFF; // білий
       };
   }

   @Override
   public int colorMultiplier(ItemStack stack, int tintIndex) {
       return colorMultiplier(null, 0, 0, 0, tintIndex);
   }
}
### BlockState API Замість використання 4-бітових метаданих, вибір моделі можна визначити на основі повних даних про стан блоку за допомогою зареєстрованого `BlockProperty`. Це дозволяє: - Необмежену кількість логічних станів (без обмеження в 16 значень метаданих); - Варіанти моделей на основі даних `TileEntity`; - Визначення стану з урахуванням `ItemStack`; - Динамічну поведінку рендерингу. Визначення BlockState працює у три кроки: 1. `BlockProperty` реєструється для блоку (і опціонально для його предмета). 2. Властивість надає значення з: - Світу + `TileEntity` - `ItemStack` 3. Завантажувач `JsonModel` визначає варіанти моделей, використовуючи ці значення властивостей. #### 1. Створення BlockProperty Приклад: Властивість напрямку, яка базується на `TileEntity`.
DirectionBlockProperty property = new DirectionBlockProperty() {

    @Override
    public String getName() {
        return "facing";
    }

    @Override
    public boolean hasTrait(BlockPropertyTrait trait) {
        return switch (trait) {
            case SupportsWorld, WorldMutable, StackMutable, SupportsStacks -> true;
            default -> false;
        };
    }

    @Override
    public ForgeDirection getValue(IBlockAccess world, int x, int y, int z) {
        TileEntity te = world.getTileEntity(x, y, z);
        if (te instanceof TileTestTintMul tile) {
            return tile.getFacing();
        }
        return ForgeDirection.NORTH;
    }

    @Override
    public void setValue(World world, int x, int y, int z, ForgeDirection value) {
        TileEntity te = world.getTileEntity(x, y, z);
        if (te instanceof TileTestTintMul tile) {
            tile.setFacing(value);
        }
    }

    @Override
    public ForgeDirection getValue(ItemStack stack) {
        return ForgeDirection.NORTH;
    }
};
#### 2. Реєстрація властивості
BlockPropertyRegistry.registerProperty(block, property);
BlockPropertyRegistry.registerProperty(Item.getItemFromBlock(block), property);
Ви повинні зареєструвати властивість: - Для блоку (стан у світі); - Для предмета (відображення в інвентарі). #### 3. Визначення JSON-файлу blockstate Приклад:
{
  "variants": {
    "facing=north": { "model": "modid:block/machine_north" },
    "facing=south": { "model": "modid:block/machine_south" },
    "facing=west":  { "model": "modid:block/machine_west" },
    "facing=east":  { "model": "modid:block/machine_east" }
  }
}
Завантажувач виконає такі дії: - Надішле запит до `property.getValue(...)`; - Сформує рядок стану, наприклад: `facing=north`; - Визначить відповідний варіант моделі. #### Підтримувані атрибути `BlockPropertyTrait` керує тим, де саме працює властивість: - `SupportsWorld` → використовується під час рендерингу у світі; - `SupportsStacks` → використовується під час рендерингу предмета в інвентарі; - `WorldMutable` → значення можна змінювати у світі; - `StackMutable` → значення можна змінювати в ItemStack. Реалізовуйте лише ті атрибути, які вам необхідні. ### Заплановано - Додавання м’якого затінення до ModelISBRH. - Додавання відсікання граней для моделей. - Реалізація фіксації UV-координат.