Skip to content

About

Клиентский мод для Fabric 26.3: скрывает стойки для брони и голограммы, оптимизирует рамки и таблички, чтобы в людных местах было чище и быстрее. // Fabric 26.3 client mod: hides armor stands and holograms and optimizes item frames and signs for cleaner, faster crowded areas.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CleanStands icon

CleanStands

Minecraft Version Platform Java Target Mod Version License

Client-side Fabric mod that hides armor stands, their equipment and holograms, and optimizes item frames with hotkeys and an in-game settings GUI, for cleaner and faster crowded areas.

Руководство / User guide: Русский · English

Русский

Что это

CleanStands (mod id cleanstands) — лёгкий клиентский Fabric-мод для Minecraft 26.3, очищающий экран от визуального мусора и поднимающий FPS на перегруженных спавнах, в торговых кварталах и лобби. Он скрывает стойки для брони с их экипировкой и текстовыми голограммами и оптимизирует рамки (Item Frames).

Возможности

Оптимизация без потери качества (включена по умолчанию, картинка не меняется):

  • Рамки и стойки за стенами не готовятся к отрисовке. Ванилла 26.3 отсекает их только по фрустуму; мод берёт тот же граф видимости секций, по которому ванилла пропускает блоки и сундуки, и пропускает рамки и стойки в невидимых камере секциях. Надписи стоек остаются видны сквозь стены, как в ванилле.
  • Невидимые грани не строятся на CPU. Грани предметов в рамках, предметов в руках стоек и моделей рамок, повёрнутые от камеры, не отправляются на видеокарту (она всё равно отбросила бы их). На стене невидимых рамок с блоками пропускается около половины граней. В проходе теней Iris не работает.
  • Модель предмета в рамке собирается заново, только когда предмет меняется, а не каждый кадр (анимированные предметы вроде часов и компаса не кэшируются).
  • Таблички вне экрана пропускаются поштучно (ванилла проверяет видимость кусками 16×16×16), текст обратной к камере стороны и пустые строки не рисуются.
  • Раскладка текста табличек и голограмм кэшируется: ширина строк и положение букв считаются один раз, включая светящийся текст с обводкой.
  • Быстрые голограммы: для стоек, от которых видна только надпись, не рассчитываются поза, броня и предметы; текст надписи хранится готовым.

Упрощение (меняет картинку, по желанию): скрытие стоек брони (полностью или «только имена», все или только маркеры и невидимые), скрытие деревянной модели рамки, дальность рамок, лимит ближайших рамок, дальность текста табличек. Ограничения дальности и количества по умолчанию выключены.

Окно настроек показывает живую статистику: сколько рамок, табличек и стоек рисуется и сколько пропущено, какая доля граней и раскладок текста сэкономлена.

Управление

Действие Клавиша по умолчанию Переназначение
Скрыть/показать стойки и голограммы не назначена Настройки → Управление → CleanStands
Переключить упрощение рамок не назначена Настройки → Управление → CleanStands
Открыть экран настроек CleanStands не назначена Настройки → Управление → CleanStands

Все клавиши не назначены по умолчанию, чтобы не конфликтовать с другими модами — назначьте нужные в меню управления.

Настройки

Экран на ванильных вкладках «Обзор», «Рамки», «Таблички», «Стойки»; открывается по клавише или через Mod Menu. Изменения видны в мире сразу, «Готово» и Esc сохраняют, «Отмена» возвращает прежние настройки. Готовые наборы: «Как в игре» (только оптимизации без потерь), «Чисто» (по умолчанию: плюс скрыты стойки и деревянные рамки), «Максимум FPS» (плюс ограничения дальности). Конфигурация сохраняется в config/cleanstands.json атомарно, с восстановлением из .bak.

Установка

  1. Fabric Loader 0.19.3+ и Fabric API.
  2. Скопируйте cleanstands-1.5.1.jar из build/libs/ в папку mods/.
  3. Mod Menu — опционально, открывает экран настроек.

Требования: Minecraft 26.3 · Java 25 · только клиент.

Сборка

.\gradlew.bat clean build

Готовый JAR: build/libs/cleanstands-1.5.1.jar.


English

What It Is

CleanStands (mod id cleanstands) is a lightweight client-side Fabric mod for Minecraft 26.3 that declutters the screen and lifts FPS in crowded spawns, shop districts, and lobbies. It hides armor stands with their equipment and text holograms, and optimizes item frames.

Features

Lossless optimizations (on by default, the picture does not change):

  • Item frames and armor stands behind walls are not prepared for rendering. Vanilla 26.3 culls them only by the frustum; the mod uses the same section visibility graph vanilla uses to skip blocks and chests. Stand labels stay visible through walls, as in vanilla.
  • Hidden faces are not built on the CPU. Faces of items in frames, items held by stands and frame models that point away from the camera are not sent to the GPU, which would discard them anyway. On a wall of invisible frames holding blocks about half of the faces are skipped. Off during the Iris shadow pass.
  • The model of an item in a frame is rebuilt only when the item changes, not every frame (animated items such as clocks and compasses are not cached).
  • Signs off screen are skipped one by one (vanilla checks visibility in 16x16x16 chunks); text facing away from the camera and blank lines are not drawn.
  • Text layout of signs and holograms is cached: line widths and glyph positions are worked out once, glowing outlined text included.
  • Fast holograms: for stands where only the label is visible, pose, armor and items are not computed; the label text is kept ready.

Simplify (changes the picture, optional): hide armor stands (fully or names only, all stands or only markers and invisible ones), hide the wooden frame model, frame distance, nearest-frame limit, sign text distance. Distance and count limits are off by default.

The settings screen shows live statistics: how many frames, signs and stands are drawn or skipped, and how many faces and text layouts were saved.

Controls

Action Default key Rebind
Toggle armor stands and holograms unbound Options → Controls → CleanStands
Toggle item-frame simplification unbound Options → Controls → CleanStands
Open CleanStands settings unbound Options → Controls → CleanStands

All keys are unbound by default to avoid clashing with other mods — bind the ones you want in the Controls menu.

Configuration

A screen with vanilla tabs Overview, Item Frames, Signs and Armor Stands; opened via a keybind or Mod Menu. Changes show in the world right away, Done and Esc save, Cancel restores the previous settings. Presets: Vanilla look (lossless optimizations only), Clean (default: plus stands and wooden frames hidden), Max FPS (plus distance limits). Configuration is saved to config/cleanstands.json atomically, with .bak recovery.

Installation

  1. Fabric Loader 0.19.3+ and Fabric API.
  2. Copy cleanstands-1.5.1.jar from build/libs/ into mods/.
  3. Mod Menu — optional, opens the settings screen.

Requirements: Minecraft 26.3 · Java 25 · client-only.

Building

.\gradlew.bat clean build

Output JAR: build/libs/cleanstands-1.5.1.jar.

Лицензия / License

MIT. Developed by LTS_Server.

About

Клиентский мод для Fabric 26.3: скрывает стойки для брони и голограммы, оптимизирует рамки и таблички, чтобы в людных местах было чище и быстрее. // Fabric 26.3 client mod: hides armor stands and holograms and optimizes item frames and signs for cleaner, faster crowded areas.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages