Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Pull request Compare This branch is 6 commits ahead, 11 commits behind bylins:master.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin.win re-commit all files with koi8-r Sep 21, 2018
lib.template
src Поправил команду ПОСЕЛИТЬСЯ May 12, 2019
tests eliminate windows-1251 in sources Sep 27, 2018
utils/mudmap Добавил утилиту рисования карт May 13, 2019
.gitattributes set working-tree-encoding Sep 21, 2018
.gitignore Внесены модификации от Пруля, именуемые "патч 3" May 8, 2019
CMakeLists.txt Внесены модификации от Пруля, именуемые "патч 3" May 8, 2019
CONTRIBUTING.md
LICENSE
backup_lib.sh
backup_plrs.sh
cmake1.sh
cmake2.sh
readme.markdown Update readme.markdown Nov 11, 2018
winprep.bat

readme.markdown

BYLINS MUD README

Введение

Эта инструкция предназначается для сборки мада под Windows, под линукс вы можете посмотреть немного устаревшую статью вот здесь: https://github.com/bylins/mud/wiki/%D0%A1%D1%82%D0%B0%D1%80%D1%8B%D0%B9-README

Необходимое окружение для сборки проекта под Windows

ВНИМАНИЕ! АХТУНГ! АЛЯРМ! Если у вас что-то уже стояло из нижеперчисленного, то установка всего свежего может привести к весьма странным багам при сборке Былин. Прошу это учитывать.

Cmake - Подойдет любая версия, начиная с 2.8

Boost - Нужен файл boost_1_68_0-msvc-14.1-64.exe, если у вас студия отличается от Visual Studio Community 2017, то вам, вероятно, нужна другая версия буста. Сама версия буста нужна выше 1.54 с библиотеками system, filesystem, locale

Git - Нужна версия начиная с 2.19 (учтите, что у гита версия 2.19 новее версии 2.6/2.7)

Microsoft Visual Studio 2017 Community - Она полностью бесплатная

Установка

При установке git, boost, можно оставить все значения дефолтными.

При установке cmake отметьте галочку Add Cmake to system path

При установки студии нужно отметить:

  1. Базовые компоненты Visual Studio C++
  2. Инструменты Visual C++ для CMake
  3. Последние инструменты v141 версии 14.15 VC++ 2017 версии 15.8 (здесь у вас версия может быть немного другая)
  4. MSBuild
  5. Средства профилирования C++
  6. Пакет SDK для Windows 10

Настройка окружения

Открываем консоль (cmd.exe).

Дальше скачиваем наш репозиторий. Пишем:

git clone https://github.com/bylins/mud

После этого переходим в каталог репозитория командой cd:

cd mud

Создаем каталог build, переходим в него, и запускаем сборку проекта под студию

mkdir build
cd build
cmake -DBUILD_TESTS=NO -DCMAKE_BUILD_TYPE=Test -DBOOST_ROOT:PATH=O:/boost/ -DCMAKE_LIBRARY_PATH:PATH=O:/boost/lib/ -DBOOST_LIBRARYDIR=O:/boost/lib/ -G "Visual Studio 15 2017 Win64" ..

Где O:/boost - это путь до буста, а O:/boost/lib - путь до каталога с библиотеками (по дефолту вместо lib там lib_какие-то_циферки)

Дальше открываем решение bylins.sln, которое появилось в каталоге build (нужно зайти туда через Проводник)

Компиляция, запуск и отладка

Нажимаем Сборка->Собрать решение

Заходим в наш каталог mud. Копируем lib.template (ИМЕННО КОПИРУЕМ) в build и переименовываем в lib

Дальше разворачиваем студию и нажимаем Локальный отладчик Windows, вуаля, мад должен заработать. Подключаться по адресу localhost 4000. Первый созданный персонаж автоматически становится иммортал 34 уровня с максимальными привилегиями.

Редактирование кода

Чтобы редактировать исходники в koi8-r, в студии, в обозревателе решения, правой кнопкой по .cpp или .h файлу->открыть с помощью->Редактор исходного кода C++(с кодировкой)->Выбираем koi8-r

По работе с репозиторием

Чтобы перенести новые изменения из официального репозитория в свой рабочий, делаем следующее:

$ cd fork/mud
$ hg pull -r default https://bitbucket.org/bylins/mud
$ hg update
$ hg push

Далее, если Вы сделали в коде Вашей рабочей копии (..\fork\mud) какие-либо изменения и хотите, чтобы их применили на официальном сервере, то делать надо следующее:

  • cоздаете в директори ..\fork\mud текстовой файл commit.txt.
  • описываете в нем изменения, которые вы сделали.
  • сохраняете файл (commit.txt) в кодировке 65001 (UTF-8).
  • запускаете Cygwin.
  • cd fork/mud
  • hg commit -l commit.txt -u "UNAME <UEMAIL>", что является первым способом, с использованием текстового файла.

Второй же способ - прямая передача сообщения:

$ hg commit -m "UMESSAGE" -u "UNAME <UEMAIL>"

UNAME – должно быть Вашим именем на сайте bitbucket.com.
UEMAIL – должен быть Вашей почтой, указанной при регистрации на bitbucket.com.
UMESSAGE – должно содержать написанное Вами сообщение об изменениях.

  • После того, как добавили коммит вводим: hg push.
  • Пройдите на Ваш репозиторий на bitbucket’е, там уже должна была появится запись с изменениями, которые Вы сделали в коде.
  • Если запись не появилась, то попробуйте все сделать с начала со вниманием и не забудьте выполнить перед этим команду: hg rollback – чтобы откатить запись коммита в логе.

Итак. Запись появилась, и теперь Вы хотите применить изменения в официальном коде Былин. Делаете следующее:

  • пройдите на свой репозиторий на bitbucked.com.
  • сверху справа будет большая кнопка «Create pull request», нажимайте на неё.
  • описывайте изменения в Title и Description и нажимайте на кнопку внизу «Send pull request». После этого на официальном репозитории, во вкладке «Pull requests» должна появится Ваша заявка. Теперь остается только ждать, когда её одобрят старшие админы.
You can’t perform that action at this time.