ResourcePrecacher для CS2 — попереднє завантаження моделей і звуків

ResourcePrecacher від Pisex — попереднє завантаження кастомних моделей і звуків у CS2

Рушій (база): чистий MetaMod:Source (нативний C++). CounterStrikeSharp НЕ ПОТРІБЕН.

Тип софту: серверна утиліта / менеджер ресурсів.

Особливість: усуває вильоти й невидимі текстури, примусово змушуючи клієнт гравця завантажити кастомний контент у пам'ять під час підключення.

Автор: Pisex

ResourcePrecacher — спеціалізована серверна утиліта для Counter-Strike 2, написана на чистому C++ для роботи безпосередньо через MetaMod:Source. Плагін вирішує одну з найпоширеніших проблем серверів із кастомним контентом — вильоти гравців і некоректне відображення сторонніх текстур.

🚀 Навіщо потрібен ResourcePrecacher у CS2?

На рушії Source 2 логіка роботи з кастомними ресурсами кардинально змінилася порівняно з CS:GO. Якщо просто встановити на сервер плагін з кастомними скінами зброї, унікальними моделями агентів чи звуками в кінці раунду, звичайні гравці їх просто не побачать і не почують. У гіршому випадку гра в користувача миттєво вилетить на робочий стіл при першій же спробі рушія відмалювати незакешований об'єкт.

ResourcePrecacher повністю бере це на себе: він реєструє точні шляхи до ваших файлів на FastDL і передає їх клієнту, що підключається, для примусового кешування (прекешу) безпосередньо перед заходом на карту.

📦 Обов'язкові розширення й залежності:

Для коректної й стабільної роботи утиліти спершу розгорніть базове розширення від того ж автора:

➔ CS2 Menus & Utils (головне розширення) — https://github.com/Pisex/cs2-menus

➔ MetaMod:Source (актуальна гілка Master branch) — https://www.metamodsource.net/downloads.php?branch=master

📂 Офіційні ресурси проєкту:

➔ Головний репозиторій утиліти ResourcePrecacher на GitHub: https://github.com/Pisex/ResourcePrecacher

🛠️ Порядок встановлення й налаштування конфігу:

1. Переконайтеся, що на сервері встановлено свіжий і робочий MetaMod:Source (Master branch).

2. Відкрийте розділ Releases офіційного репозиторію проєкту на GitHub, завантажте останній реліз ResourcePrecacher і розпакуйте вміст архіву на сервер за шляхом:

addons/metamod/

3. Відкрийте конфігураційний файл плагіна за шляхом:

addons/metamod/configs/resource_precacher.json

(або аналогічний створений файл конфігурації в папці плагіна).

4. Пропишіть у цей конфіг точні шляхи до файлів моделей (з розширенням .vmdl_c) чи звуків, які потрібно примусово завантажити в клієнт гравця.

5. Перезапустіть ігровий сервер і перевірте, що розширення успішно завантажилося, консольною командою сервера:

meta list

⚠️ Важливо для адміністраторів: цей плагін лише змушує гру зробити обов'язковий прекеш файлів на боці клієнта. Самі кастомні файли ресурсів мають бути заздалегідь фізично завантажені на ваш FastDL-сервер (зовнішній HTTP-хостинг), а шляхи в json-конфігу мають до кожного символу збігатися з реальними шляхами на FastDL.