Free BuildingShop

[foreks]

# BuildingShop

Плагин для Rust, позволяющий игрокам покупать дополнительные лимиты на строительство за внутриигровую валюту.

## Описание

BuildingShop предоставляет систему лимитов на размещение объектов (турели, печи, шкафы и т.д.) с возможностью расширения этих лимитов через встроенный магазин. Плагин идеально подходит для серверов с экономикой (Economics или ServerRewards).

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

- **Гибкая система лимитов** — настройка индивидуальных лимитов для каждого типа объектов
- **Групповые лимиты** — объединение нескольких объектов в одну группу с общим лимитом
- **Встроенный магазин** — игроки могут покупать дополнительные лимиты через UI
- **Поддержка экономик** — совместимость с Economics и ServerRewards
- **Админ-панель** — управление настройками плагина через удобный UI
- **Глобальные лимиты** — ограничение общего количества объектов на игрока
- **Приоритеты разрешений** — автоматическое применение лучших лимитов на основе разрешений игрока
- **Сохранение покупок** — покупки сохраняются между перезагрузками сервера
- **Опция сброса** — возможность сброса покупок при вайпе карты

## Команды

### Игровые команды

| Команда | Описание |
|---------|----------|
| `/bshop` | Открыть главное меню магазина |
| `/bshop buy <название> [кол-во]` | Купить лимит на объект |
| `/bshop refund` | Вернуть средства за покупки (если включено) |
| `/limit` | Альтернативная команда открытия магазина |
| `/limits` | Альтернативная команда открытия магазина |

### Административные команды

| Команда | Описание |
|---------|----------|
| `/bshop admin` | Выдать/отобрать права администратора плагина |
| `/bshop wipepurchases` | Сбросить все покупки игроков |
| `/bshop rebuildcache` | Перестроить кэш размещённых объектов |
| `/bshop loaddefaultconfig` | Загрузить конфигурацию по умолчанию |
| `/bshop refund [userID]` | Вернуть средства игроку |
| `/bshop config <параметр> <значение>` | Изменить настройки плагина |

## Разрешения (Permissions)

| Разрешение | Описание |
|------------|----------|
| `BuildingShop.default` | Базовое разрешение с обычными лимитами |
| `BuildingShop.vip` | Расширенные лимиты для VIP-игроков |
| `BuildingShop.nolimit` | Игроки без лимитов |
| `BuildingShop.admin` | Доступ к административным функциям |
| `BuildingShop.debug` | Отладочное разрешение |

## Конфигурация

Файл конфигурации: `oxide/config/BuildingShop.json`

### Основные настройки

```json
{
"adminPermission": "BuildingShop.admin",
"commands": ["limit", "limits"],
"command": "bshop",
"currency": 0, // 0 = Scrap, 1 = ServerRewards, 2 = Economics
"currencyName": "Лом",
"currencyPrefix": "",
"wipePurchases": true, // Сбрасывать покупки при вайпе карты
"infinity": 999999, // Значение "бесконечности" для лимитов
"refundMultiplier": 0.5 // Множитель возврата средств (0 = отключено)
}
```

### Настройка лимитов

Лимиты настраиваются в разделе `permissions`. Каждый тип разрешения содержит свои лимиты:

```json
"permissions": {
"BuildingShop.default": {
"priority": 1,
"globalLimit": -1, // -1 = без ограничений, 0 = запрещено строить
"limits": {
"box.store.large": {
"free": 10, // Бесплатные лимиты
"max": 50, // Максимум покупок
"cost": 100, // Стоимость за единицу
"displayName": "Большой ящик"
},
"turret.auto": {
"free": 2,
"max": 10,
"cost": 500,
"displayName": "Авто-турель"
}
}
}
}
```

### Групповые лимиты

Можно объединять объекты в группы с общим лимитом:

```json
"furnace": {
"free": 5,
"max": 20,
"cost": 50,
"displayName": "Печи",
"groupMembers": {
"furnace": { "groupContribution": 1 },
"furnace.large": { "groupContribution": 2 },
"furnace.standalone": { "groupContribution": 3 }
}
}
```

В этом примере большая печь считается за 2, а автономная — за 3 единицы лимита.

## Установка

1. Скачайте файл `BuildingShop.cs`
2. Поместите его в папку `oxide/plugins/`
3. Плагин автоматически скомпилируется
4. Настройте `oxide/config/BuildingShop.json` под ваш сервер
5. Выдайте игрокам разрешения: `oxide.grant <user/group> <ID> BuildingShop.default`

## Требования

- Oxide для Rust
- Серверная экономика (опционально):
- Economics
- ServerRewards

## Локализация

Плагин поддерживает русскую локализацию. Файл перевода находится в:
`oxide/lang/ru/BuildingShop.json`

Для игроков с русской локализацией Steam сообщения будут отображаться на русском языке.

## Известные ограничения

- Плагин использует `FindObjectsOfType`, что может вызывать небольшие просадки производительности
- Для работы требуется наличие разрешений у игроков
- Покупки не выдают физические предметы — только увеличивают лимиты на размещение