Shadow Editor

English / 中文 | Windows Server | Linux Server | Web Application Example | Official Website

Description: The server represents a compiled version with an embedded MongoDB. To start it, run start.bat or start.sh. Accessible via the browser Google Chrome at address http://localhost:2020.

Good news! A new version based on vite4 + vue3 + ts5 + ant-design-vue7 will soon be available, more details here.

Name: Shadow Editor
Version: v0.6.1 (in development)
Description: Cross-platform 3D scene editor based on Three.js, Go and MongoDB.
Source code: GitHub Gitee | Documentation: Gitee | Examples: GitHub Gitee | Video: Weibo Bilibili | Resources: Baidu Netdisk rfja
Technology stack: html, css, javascript, rollup, react.js, webgl, three.js, golang, mongodb, nodejs, electron, protocol buffers.
If you find this project helpful, please help its development financially. Thank you very much!

Open version

Professional version

Update to version v0.6.1

Starting from version v0.6.1, ShadowEditor provides only basic functions and extendable API. All other features will be implemented as extensions similar to VSCode. The transition to an extensible system will take place in the dev branch.

Fixed font issues when working with Go versions.
Hidden model history tab.
Disabled display of sprite borders upon selection.
Fixed dropdown search style errors.

Version v0.6.0 has been released

Release date: July 24, 2021
Changes:

Fixed issues creating new MongoDB connections during requests.
Activated VR mode by selecting "Virtual Reality" option in status bar.
Configured scene movement settings.
Enabled opening windows on object clicks: https://gitee.com/tengge1/ShadowEditor/issues/I3APGI
Added HTTPS configuration in config.toml.
Added touch events for mobile browsers in scripts: onTouchStart, onTouchEnd, onTouchMove.
Updated three.js to latest version r130.
Added VR event support in scripts: onVRConnected, onVRDisconnected, onVRSelectStart, onVRSelectEnd.
Supported VR controllers such as HTC Vive.
Fixed script deletion issues.
Resolved serialization issues for Geometry after updating three.js.
Added ability to configure material parameters polygonOffset, polygonOffsetFactor, polygonOffsetUnits to resolve depth conflict issues.
Fixed visibility component saving issues within models.
No longer supports .bin type models.
Fixed stereographic texture issues.
All methods prototype were replaced with ES6 class.
Removed visual module representation.
Fixed scene export issues related to incorrect skybox texture copy.
Fixed precipitation creation issues.
Changed background color and light for better visibility of added planes.
Fixed particle issues.
Fixed material issues.
Fixed shadow setup issues.

Feature list- [x] Общие функции

UI компоненты

Требования

MongoDB v3.6.8+
Chrome 81.0+ или Firefox 75.0+

При сборке из исходного кода потребуются следующие программы:

Golang 1.14.2+
NodeJS 14.1+
gcc 9.3.0+ (На Windows требуется установка tdm-gcc, MinGW-w64 или MinGW. Убедитесь, что gcc доступен через командную строку)
git 2.25.1+

Обратите внимание: номера версий указаны ориентировочно.

Скачивание и сборка

Вы можете использовать git для скачивания исходного кода.

git clone https://github.com/tengge1/ShadowEditor.git

В случае проблем с доступом к GitHub вы можете использовать Gitee.

git clone https://gitee.com/tengge1/ShadowEditor.git

Сборка на Windows и Ubuntu

Веб-версия:

Если вы находитесь в Китае, выполните npm run set-proxy для настройки прокси для Go и NodeJS.
Выполните npm install для установки зависимостей NodeJS.
Выполните npm run build для сборки сервера и веб-приложения.
Редактируйте build/config.toml для изменения параметров хоста и порта MongoDB.
Выполните npm start для запуска сервера. Теперь вы можете получить доступ по адресу http://localhost:2020.
Если HTTPS включен в конфигурационном файле, обращайтесь по адресу https://localhost:2020.

Десктопная версия:

Скачайте и распакуйте MongoDB в папку utils/mongodb.
Соберите веб-версию.
Выполните npm run build-desktop для создания десктопного приложения в папке build/desktop.

Установка как службы Windows

Откройте PowerShell или cmd с правами администратора в папке build.
Выполните .\ShadowEditor install, чтобы установить ShadowEditor как службу.
Выполните .\ShadowEditor start, чтобы запустить службу ShadowEditor.
Теперь вы можете получить доступ к: http://localhost:2020.
Также можно управлять этой службой через Управление службами Windows.

Установка как службы Ubuntu

Измените ./scripts/service_linux/shadoweditor.service, указав правильные пути.
Выполните sudo cp ./scripts/service_linux/shadoweditor.service /etc/systemd/system/.
Выполните sudo systemctl daemon-reload, чтобы перезагрузить демона системных услуг.
Выполните sudo systemctl start shadoweditor, чтобы запустить службу.
Выполните sudo systemctl enable shadoweditor, чтобы настроить автозапуск при старте системы.## Использование командной строки

PS E:\github\ShadowEditor\build\> .\ShadowEditor
ShadowEditor — это редактор сцен 3D, основанный на three.js, golang и mongodb.
Эта программа использует mongodb для хранения данных.

Использование:
  ShadowEditor [команда]

Доступные команды:
  debug       Отладка службы на Windows
  help        Помощь по любой команде
  install     Установка службы на Windows
  serve       Запуск сервера
  start       Запуск службы на Windows
  stop        Остановка службы на Windows
  version     Вывод номера версии

Флаги:
      --config string   Конфигурационный файл (по умолчанию "./config.toml")
  -h, --help            Помощь по ShadowEditor

Используйте "ShadowEditor [команда] --help", чтобы узнать больше информации о команде.

Разработчики

Скачайте и установите NodeJS, Golang, MongoDB и Visual Studio Code.
Рекомендовано установить следующие расширения для VSCode, они полезны для разработки:

ESLint, Go, Поддержка шейдерных языков для VS Code, Поддержка TOML.

npm скрипты:

npm install:            Установка зависимостей nodejs.
npm run build:          Сборка серверной части и web-клиента.
npm run build-server:   Только сборка серверной части. (для разработки)
npm run build-web:      Только сборка web-клиента. (для разработки)
npm run build-desktop:  Сборка версии для рабочего стола.
npm run dev:            Автоматическая сборка web-клиента при изменении файла. (для разработки)
npm run copy:           Копирование ресурсов из папки web в папку build.
npm run start:          Запуск серверной части.
npm run set-proxy:      Настройка прокси для golang и nodejs. (только для использования внутри страны)
npm run unset-proxy:    Отключение прокси для golang и nodejs.
npm run install-dev:    Установка инструментов разработки для golang.
npm run eslint:         Проверка js-файлов, автоматическое исправление ошибок.
npm run clean:          Удаление собранной версии web и рабочего стола.
npm run clear:          Удаление ненужных пакетов nodejs.

Участие в проекте

Развернуть для подробностей

Проект ShadowEditor предназначен для пользователей и разработчиков. Здесь вы можете отправлять свои идеи и предложения. Нет вознаграждения, но есть много удовольствия. Для отправки кода выполните следующие шаги:

Создайте форк этого репозитория.
Создайте новую ветку Feat_xxx.
Отправьте свой код.
Создайте новый pull request.

Обратите внимание: Не отправляйте большие двоичные файлы, так как они могут быть отклонены. Если вам нужно, вы можете добавить файлы или директории, которые следует игнорировать, в файл .gitignore.

Часто задаваемые вопросы

〈summary〉Развернуть для подробностей〈/summary〉

Не удалось загрузить модель.

Необходимо создать архив ZIP всех ресурсов модели, таких как текстуры, и убедиться, что входной файл не имеет вложенных директорий. Сервер будет распаковывать загруженный ZIP-архив в директорию ./build/public/Upload/Model и добавит запись в таблицу MongoDB _Mesh.

Как объединить несколько моделей?

Базовые геометрические объекты поддерживают многократное вложение. Можно создать группу (в меню геометрии) и переместить несколько моделей в эту группу на дереве сцены.

Как включить систему управления доступом?

Отредактируйте файл config.toml, установите значение authority.enabled равным true. По умолчанию имя пользователя администратора — admin, пароль — 123456.

Проблема с сообщением "asm.js был отключен, поскольку соединено сценарное отладочное устройство".

Полностью: asm.js был отключен, поскольку соединено сценарное отладочное устройство. Отсоедините отладочное устройство, чтобы включить asm.js. ammo.js (1,1) SCRIPT1028: SCRIPT1028: Ожидается идентификатор, строка или число ShadowEditor.js (3948,8) SCRIPT5009: 'Shadow' не определён. Решение: Браузер Tencent не поддерживает использование Emscripten для компиляции ammo.js (WebAssembly). Рекомендуется использовать Google Chrome или Firefox.

Как обновиться с версии C# до версии Golang?

Структура данных и клиентская часть остались без изменений. Вам потребуется скопировать папку ./ShadowEditor.Web/Upload/ в build/public/Upload/.

Версия для рабочего стола не открывается.

Описание: Windows требует Visual C++ Redistributable for Visual Studio 2015. Вы можете скачать его здесь: https://www.microsoft.com/en-us/download/details.aspx?id=48145 Описание: Если версия для рабочего стола не открывается, проверьте файл logs.txt; если порты заняты, измените порты MongoDB и сайта в файле resources/app/config.toml.

Как создать сертификат HTTPS?

Установите openssl, который уже входит в git-клиент. Откройте командную строку, PowerShell или shell и выполните следующие команды:

openssl genrsa -out privatekey.pem 1024
openssl req -new -key privatekey.pem -out certrequest.csr
openssl x509 -req -in certrequest.csr -signkey privatekey.pem -out certificate.pem

В результате будут созданы два файла: certificate.pem — сертификат, privatekey.pem — ключ.

Открытые проекты

Развернуть для подробностей

Спасибо за использование следующих открытых проектов.

https://github.com/golang/go
https://github.com/BurntSushi/toml
https://github.com/dgrijalva/jwt-go
https://github.com/dimfeld/httptreemux
https://github.com/inconshreveable/mousetrap
https://github.com/json-iterator/go
https://github.com/mozillazg/go-pinyin
https://github.com/otiai10/copy
https://github.com/sirupsen/logrus
https://github.com/spf13/cobra
https://github.com/spf13/viper
https://github.com/urfave/negroni
https://go.mongodb.org/mongo-driver

OSCHINA-MIRROR/ShadowEditor-ShadowEditor

Shadow Editor

Update to version v0.6.1

Version v0.6.0 has been released

Feature list- [x] Общие функции

UI компоненты

Требования

Скачивание и сборка

Сборка на Windows и Ubuntu

Установка как службы Windows

Установка как службы Ubuntu

Разработчики

Участие в проекте

Часто задаваемые вопросы

Открытые проекты

Опубликовать ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/ShadowEditor-ShadowEditor .gitee-modal { min-width: 500px !important; } .gitee-modal .close { right: 0.6rem !important; }

Shadow Editor

Update to version v0.6.1

Version v0.6.0 has been released

Feature list- [x] Общие функции

UI компоненты

Требования

Скачивание и сборка

Сборка на Windows и Ubuntu

Установка как службы Windows

Установка как службы Ubuntu

Разработчики

Участие в проекте

Часто задаваемые вопросы

Открытые проекты

Опубликовать ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/ShadowEditor-ShadowEditor