# Конфигурация системы коллайдеров

## Обзор изменений

Система коллайдеров была обновлена для обеспечения полного покрытия объектов коллизиями. Теперь коллайдеры создаются с увеличенными размерами, чтобы покрывать весь объект, а не только его часть.

## Основные изменения

### 1. Конфигурация коллайдеров
```javascript
const COLLIDER_CONFIG = {
    sizeMultiplier: 2.0,        // Коэффициент увеличения размеров (100% больше)
    debugMode: false,           // Режим отладки для визуализации
    minSize: 0.5,              // Минимальный размер коллайдера
    maxSize: 50.0,             // Максимальный размер коллайдера
    adaptiveScaling: true      // Адаптивное масштабирование
};
```

### 2. Обновленная функция создания коллайдеров
- `createVisualColliderFromModel()` теперь использует увеличенные размеры для JSON данных
- Приоритет отдается реальным размерам мешей из 3D модели
- Fallback к JSON данным с коэффициентом увеличения

### 3. Адаптивное масштабирование
Система автоматически определяет оптимальный коэффициент масштабирования на основе размеров объекта:
- **Маленькие объекты** (< 1.0): коэффициент 3.0x или больше
- **Средние объекты** (1.0-5.0): стандартный коэффициент 2.0x
- **Большие объекты** (> 5.0): уменьшенный коэффициент 1.6x

### 4. Динамическая настройка
Добавлены расширенные функции для настройки коллайдеров:

```javascript
// Изменить коэффициент размера коллайдеров
window.updateColliderSize(3.0); // Увеличить на 200%

// Переключить адаптивное масштабирование
window.toggleAdaptiveScaling();

// Установить ограничения размеров
window.setColliderLimits(1.0, 20.0); // мин: 1.0, макс: 20.0

// Переключить режим отладки
window.toggleColliderDebug();

// Получить текущую конфигурацию
console.log(window.colliderConfig);

// Протестировать коллизии
window.testCollisions();

// Быстрый тест всех функций
window.quickTest();

// Управление цветом и прозрачностью коллайдеров
window.setColliderColor(0, 1, 0); // Зеленый цвет (RGB 0-1)
window.setColliderOpacity(0.5); // Полупрозрачность (0-1)
window.randomizeColliderColors(); // Случайные цвета

// Управление цветом и прозрачностью объектов интерьера
window.setInteriorObjectColor(1, 0, 0); // Красный цвет объектов (RGB 0-1)
window.setInteriorObjectOpacity(0.7); // Полупрозрачность объектов (0-1)
```

## Использование

### Базовое использование
Коллайдеры автоматически загружаются из `colliders_city_1.json` с увеличенными размерами.

### Настройка размеров
Если коллайдеры слишком большие или маленькие, можно изменить коэффициент:

```javascript
// В консоли браузера
window.updateColliderSize(1.0);  // Оригинальные размеры
window.updateColliderSize(1.2);  // +20% (по умолчанию)
window.updateColliderSize(1.5);  // +50%
```

### Отладка
Для визуализации коллайдеров включите режим отладки:
```javascript
window.colliderConfig.debugMode = true;
```

## Технические детали

### Алгоритм создания коллайдеров
1. Поиск соответствующего меша в 3D модели по позиции
2. Если меш найден - использование его реальных размеров
3. Если меш не найден - использование JSON данных с коэффициентом увеличения
4. Создание Box3 для проверки коллизий
5. Создание визуального представления

### Проверка коллизий
- Используется AABB (Axis-Aligned Bounding Box) для эффективной проверки
- Игрок представлен как цилиндр с радиусом 0.35 и высотой 1.6
- Проверка пересечения Box3 объектов

## Файлы конфигурации

### colliders_city_1.json
```json
{
  "colliders": [
    {
      "type": "box",
      "position": { "x": 0, "y": 0, "z": 0 },
      "rotation": { "x": 0, "y": 0, "z": 0 },
      "scale": { "x": 2, "y": 2, "z": 2 },
      "color": { "r": 1.0, "g": 0.0, "b": 0.0 },
      "opacity": 0.3
    }
  ]
}
```

**Параметры:**
- `position`, `rotation`, `scale` - стандартные параметры трансформации
- `color` - RGB цвет в диапазоне 0.0-1.0 (опционально)
- `opacity` - прозрачность в диапазоне 0.0-1.0 (опционально)

Размеры в JSON будут автоматически увеличены на коэффициент `sizeMultiplier`.

## Рекомендации

1. **Начальная настройка**: Используйте коэффициент 1.2 (20% увеличение)
2. **Тонкая настройка**: Тестируйте разные значения от 1.0 до 1.5
3. **Отладка**: Включите `debugMode` для визуальной проверки коллайдеров
4. **Производительность**: Большие коэффициенты могут снизить производительность

## Устранение неполадок

### Коллайдеры слишком маленькие
```javascript
window.updateColliderSize(1.3); // Увеличить коэффициент
```

### Коллайдеры слишком большие
```javascript
window.updateColliderSize(1.1); // Уменьшить коэффициент
```

### Проблемы с производительностью
```javascript
window.updateColliderSize(1.0); // Вернуться к оригинальным размерам
```