Go to English README version

Этот проект - интеграция Space Station 13 и Buttplug.io через сервис.

Реализован с использованием Nuxt 3, Socket.IO и buttplug-js.

Список содержимого Space Station 13 - вкратце с Wiki Как использовать Plug13 А моё устройство поддерживается? Проект изнутри Как запустить проект DM сервер - Byond Web - Короткое объяснение Web - Длинное объяснение Запуск в Docker Нативный запуск

Space Station 13 - вкратце с Wiki

Space Station 13 — это многопользовательская ролевая видеоигра с видом сверху вниз, работающая на бесплатном игровом движке BYOND, выпущенном в 2003 году.

Действие игры происходит на футуристической космической станции; однако расположение внутриигрового мира может различаться в зависимости от игрового сервера. Например, на космическом корабле или экзопланете.

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

Это грубый перевод написанного на английской Википедии

Как использовать Plug13

• Открываешь и авторизуешься (авторизация просто чтобы дискорд отсеял ботов, спам и подобное).
• Подключаешься к Intiface Central.
• Находишь свои устройства и настраиваешь их.
  Приложение позволяет тебе установить модификатор для каждого типа взаимодействий с персонажем:
  • Лицо - поцелуи и оральные взаимодействия, Грудь - женские груди и сама грудь... Пах - пах , Зад - попка.
  • Обычный - обнимашки, поглаживания по голове и т.п.
  • Мазохизм - для игроков Службы Безопасности.
• Генерируешь и копируешь код XXXXX-XXXXX.
• Открываешь игру и вводишь/вставляешь этот код в специальном меню.
  По умолчанию OOC -> Plug13
• Наслаждаешься игрой.

– Это сложно!

Да, это так. Но это единственный способ, которым это можно сделать без взлома игры и риска быть забаненным.

А также, когда всё уже настроено, достаточно просто подключиться к Intiface и скопировать код. И всё.

Какие игрушки устройства поддерживаются?

Сейчас поддерживаются только вибрация и поступательные движения.

Список устройств, которые умеют подключаться к buttplug.io можно найти на IoST Index.
На этом же сайте размещены и реферальные ссылки от разработчиков buttplug.io на покупку устройств - отличный способ их поддержать.

Проект изнутри

Итак, Space Station 13 — это игра, в которой есть РП (ролевые) серверы. И на каждом сервере запущен свой собственный код - билд.

Этот проект состоит из двух частей:

• Сервис Plug13, который является мостом между Intiface Central и игрой.
• Модуль для серверов SS13, который позволяет серверу SS13 и сервису Plug13 общаться.

Пошагово:

• При вызове серверной процедуры plug13.send_emote(type, strength, duration)...
• SS13 сервер отправляет HTTP(S) POST запрос серверу Plug13.
• Plug13 сервер отправляет WS сообщение на веб-клиент Plug13.
• Веб-клиент применяет указанные пользователем модификаторы и отправляет сообщение Intiface Central.
• Intiface Central принимает сообщение и активирует приводы устройств.

Что? Почемуууу?!

- Эй! Intiface Central уже - мост, позволяющий сделать это без всяких внешних серверов!

Да. Я знаю. Но.

Движок BYOND настолько стар... Он не позволяет использовать WS на стороне клиента нативно.
Агам.

Теоретически я мог бы использовать скрытое в интерфейсе игры окно IE11, но реализовать это было бы гораздо большей болью в заднице, чем этот веб-сервис.

Как запустить проект

DM сервер - Byond

Читать тут: Plug13 DM - ReadMe

Web - Короткое объяснение

Проект использует pnpm.

# Для установки модулей запустите:
pnpm install

# Запустить сервер разработки:
pnpm run dev

# Билд проекта для прода:
pnpm run build
pnpm run prisma migrate deploy

# Превью продовой сборки:
pnpm run preview

# Запуск продовой сборки:
node ./server/index.mjs

Web - Длинное объяснение

Запуск в Docker

1. Установи Docker
2. Клонируй репозиторий:

git clone https://github.com/SuhEugene/plug13.git
cd plug13

3. Настрой переменные окружения:

Скопируй переменные из .env.example в .env

cp .env.example .env

Затем измени как тебе необходимо
Тебе придётся предоставить свою собственную базу данных PostgreSQL

4. Сбилди docker image:

docker build -t plug13 .

5. Запусти docker image:

docker run -d -p 3000:3000 plug13

Сервер будет доступен по адресу http://localhost:3000

Нативный запуск

1. Установи Node.js и pnpm

Короткое субъективное руководство:

curl -fsSL https://raw.githubusercontent.com/mklement0/n-install/stable/bin/n-install | bash -s 20
corepack enable pnpm

2. Склонируй репозиторий:

git clone https://github.com/SuhEugene/plug13.git
cd plug13

3. Установи модули:

pnpm install --frozen-lockfile

4. Настрой переменные окружения:

Скопируй переменные из .env.example в .env

cp .env.example .env

Затем измени как тебе необходимо
Тебе придётся предоставить свою собственную базу данных PostgreSQL

5. Выполни миграцию базы данных:

pnpm prisma migrate deploy

6. Запусти сервер

Сервер разработки: pnpm dev

Продовый сервер:

• pnpm build
• node ./server/index.mjs

Сервер будет доступен по адресу http://localhost:3000

---

Если встретишь такую ошибку:

ERROR Error while requiring module shadcn-nuxt: Error: Cannot find module '@oxc-parser/binding-linux-x64-musl'

тогда тебе нужно будет вручную установить oxc-parser:

pnpm install -D oxc-parser

и затем пересобрать проект