Spyglass Custom Scopes

📘 Description

🔭 Custom Spyglass Scope

Custom Spyglass Scope — это лёгкий клиентский Fabric-мод, который позволяет заменять стандартный скоуп подзорной трубы на пользовательские текстуры через CustomModelData, без конфигов, JSON-файлов и сложной логики.

Мод идеально подходит для:

ресурспаков
RPG / PvP серверов
кастомных предметов
OptiFine-подобного поведения, но нативно

✨ Возможности

🔁 Замена скоупа по CustomModelData
🧩 Полностью ванильный рендер (без кастомных шейдеров)
📦 Управление через ресурспак
⚡ Минимальное влияние на производительность
🛡 Без конфликтов с другими HUD-эффектами

🛠 Как пользоваться

1️⃣ Установите мод

Установите Fabric Loader >= 0.18.4
Поместите мод в папку mods

2️⃣ Добавьте текстуры в ресурспак

Структура ресурсов:


assets/custom_scope/
└── textures/
└── gui/
└── custom_scope/
├── img.png
├── sniper.png
└── example.png

3️⃣ Назначьте CustomModelData предмету

Мод использует строковый CustomModelData, который должен состоять из:


<mod_id>_<texture_name>

Пример:

custom_scope — Mod ID
img — имя текстуры

Команда выдачи подзорной трубы:

/give @p minecraft:spyglass[CustomModelData:{strings:["custom_scope_img"]}]

📌 В этом случае будет использована текстура:

assets/custom_scope/textures/gui/custom_scope/img.png

🔄 Поведение

Если CustomModelData соответствует формату <mod_id>_<texture_name> → используется кастомный скоуп
Если формат не совпадает → используется ванильный скоуп
Если текстура отсутствует → краша не будет

🎨 Текстура по умолчанию

Мод уже содержит одну встроенную текстуру скоупа для примера.

Чтобы получить подзорную трубу с ней, используйте:

/give @p minecraft:spyglass[CustomModelData:{strings:["custom_scope_img"]}]

💡 Примечание

Мод не добавляет новые предметы и не изменяет механику игры — он лишь подменяет текстуру скоупа в момент рендера, сохраняя ванильное поведение.

Custom Spyglass Scope is a lightweight client-side Fabric mod that allows you to replace the default spyglass scope texture using CustomModelData, without configs, JSON files, or complex logic.

This mod is perfect for:

Resource packs
RPG / PvP servers
Custom items
OptiFine-like behavior, but native

✨ Features

🔁 Spyglass scope replacement via CustomModelData
🧩 Fully vanilla rendering (no custom shaders)
📦 Controlled entirely through resource packs
⚡ Minimal performance impact
🛡 No conflicts with other HUD effects

🛠 How to Use

1️⃣ Install the mod

Install Fabric Loader >= 0.18.4
Place the mod into the mods folder

2️⃣ Add textures to your resource pack

Resource structure:

assets/custom_scope/
└── textures/
    └── gui/
        └── custom_scope/
            ├── img.png
            ├── sniper.png
            └── example.png

3️⃣ Assign CustomModelData to the spyglass

The mod uses string-based CustomModelData, which must follow this format:

<mod_id>_<texture_name>

Example:

custom_scope — the mod ID
img — the texture name

Command example:

/give @p minecraft:spyglass[CustomModelData:{strings:["custom_scope_img"]}]

📌 This will load the texture from:

assets/custom_scope/textures/gui/custom_scope/img.png

🔄 Behavior

If CustomModelData matches <mod_id>_<texture_name> → a custom scope is used
If the format does not match → the vanilla spyglass scope is rendered
If the texture is missing → no crash will occur

🎨 Default Included Texture

The mod includes one default spyglass scope texture out of the box as an example.

To obtain a spyglass using it, run:

/give @p minecraft:spyglass[CustomModelData:{strings:["custom_scope_img"]}]

💡 Notes

This mod does not add new items and does not change gameplay mechanics — it simply replaces the spyglass scope texture at render time while preserving vanilla behavior.