╔══════════════════════════════════════════════════════════════╗
║              SC CONTROLLER  v1.0                              ║
║   Планшет как контроллер быстрых действий для Star Citizen    ║
╚══════════════════════════════════════════════════════════════╝

Что это: превращает Android-планшет в панель кнопок для Star Citizen.
Нажатие на планшете → мгновенно эмулируется как клавиша на ПК
(задержка ~4 мс в Wi-Fi). 4 страницы кнопок с дефолтными биндами SC.

  ┌─ БЕТА-ТЕСТ ───────────────────────────────────────────────┐
  │ Это ранняя версия. Помоги протестировать — пиши что       │
  │ работает/не работает в Discord или Telegram SC Portal RU. │
  │ Особенно: какие кнопки не срабатывают в твоей версии игры. │
  └───────────────────────────────────────────────────────────┘

4 СТРАНИЦЫ КНОПОК:
  • Бой      — питание (удержание = MAX), щиты, цели, ловушки
  • Полёт    — режимы, шасси, квант, фары, MobiGlas
  • Утилиты  — скан, обзор, добыча, взаимодействие
  • Десант   — пеший бой: оружие, граната, нож, наклоны, спринт

В архиве:
  • SCController_Server.exe  — сервер для ПК (Windows 10/11)
  • config.json             — раскладка кнопок (можно править)
  • SC-Controller.apk        — приложение для планшета (Android 8+)


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ШАГ 1.  ПК — запусти сервер
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Запусти SCController_Server.exe (config.json должен лежать рядом).
2. Windows Defender SmartScreen может предупредить ("Неизвестный
   издатель") — это нормально для программ эмуляции клавиш.
   Нажми "Подробнее" → "Выполнить в любом случае".
3. Брандмауэр спросит доступ к сети — РАЗРЕШИ (частные сети).
4. В трее появится синий кружок. Двойной клик по нему копирует
   адрес сервера (IP:порт) — он понадобится на планшете.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ШАГ 2.  Планшет — установи приложение
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Скинь SC-Controller.apk на планшет (кабель / Telegram / облако).
2. Открой файл → разреши "Установка из неизвестных источников".
3. Установи и запусти. Приложение откроется горизонтально.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ШАГ 3.  Соедини (АВТО-ПОИСК — IP вводить не нужно!)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. ПК и планшет — в одной Wi-Fi сети.
2. Открой приложение и нажми "🔍 Найти сервер автоматически".
   Планшет сам найдёт ПК — тапни по карточке сервера.
   (При следующих запусках подключится сам.)
3. Появится сетка из 16 кнопок (4 страницы: Бой / Полёт /
   Утилиты / Десант). 🟢 зелёная точка = связь есть.

Если авто-поиск не сработал (редкие сети блокируют broadcast) —
введи IP:порт вручную (IP смотри в трее ПК, двойной клик копирует).


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ПРОВЕРКА
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Открой Блокнот на ПК, кликни в него. На планшете нажми кнопки
с буквами (Захват цели=T, Ловушки=H) — символы напечатаются.
Потом сделай активным окно Star Citizen — кнопки шлют клавиши в игру.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
РЕДАКТОР КНОПОК (рекомендуется!)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Удобнее всего настраивать кнопки через браузерный редактор:
  • Трей → "🎛 Редактор кнопок (браузер)"
    (или открой http://localhost:3000/ в браузере на ПК)

В редакторе:
  1. Кликни на любую кнопку.
  2. Выбери клавишу из списка + модификаторы (Ctrl/Alt/Shift,
     а также R-Ctrl/R-Alt/R-Shift — правые), тип (тап / удержание).
  3. Жми "⚡ Тест" — клавиша уйдёт на ПК. Переключись в игру и
     проверь, срабатывает ли. Для удержания (самоуничтожение,
     обзор) — "⏱ Тест 3с".
  4. "💾 Сохранить" — планшет обновится сразу, без переустановки.

Есть встроенная шпаргалка дефолтных клавиш Star Citizen.

МАКРОСЫ (последовательность клавиш) — тип "Макрос":
  Одна кнопка может выполнить серию действий по порядку. Каждый
  шаг — отдельная строка. Слово "hold" = держать, пока нажата
  кнопка на планшете (для последнего шага).
  Пример — ЛЕЧЕНИЕ (уже добавлено на странице Десант):
      5
      MOUSE1
      MOUSE2 hold
  → нажмёт 5, кликнет ЛКМ, затем будет держать ПКМ, пока держишь
  кнопку на планшете. Модификаторы в шаге: "1 ralt", "F4 alt shift".

ПРАВЫЙ / ЛЕВЫЙ ALT: в config.json модификаторы LALT/RALT (и
  LCTRL/RCTRL, LSHIFT/RSHIFT) различаются. В редакторе — галочки
  Alt (левый) и R-Alt (правый).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
НАСТРОЙКА ЧЕРЕЗ ФАЙЛ (для продвинутых)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Можно править config.json вручную. Каждая кнопка:
  "label": "подпись", "key": "F5", "modifiers": ["CTRL"],
  "action": { "type": "keypress" }   (или "hold")
Клавиши: F1-F12, буквы, NUM0-9, TAB, SPACE, LSHIFT, CAPSLOCK,
BACKSPACE, стрелки, MOUSE1/2/3. После правки — трей →
"Перезагрузить config.json".


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ПРОБЛЕМЫ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Планшет не подключается → проверь Firewall (разреши exe в частных
  сетях) и что устройства в одной Wi-Fi.
• Кнопки не печатают → окно игры/Блокнота должно быть активным.
• Изменил config — нет эффекта → трей → "Перезагрузить config.json".


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💚 ПОДДЕРЖАТЬ ПРОЕКТ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Проект некоммерческий — делаю сам, на энтузиазме, бесплатно и без
рекламы. Если приложение оказалось полезным — можешь сказать
"спасибо" донатом. Это не обязательно, но реально мотивирует
пилить новые функции и держать всё бесплатным. Спасибо! 🙏

  USDT · сеть TRON (TRC20):
  TL3AAn2ka88xi5P7sTtbw8PHox6Tyos1NK


SC Portal RU · sc-portalru.com · не связан с Cloud Imperium Games
