Участник:Richard Jones: различия между версиями

Материал из Tau Ceti Station Wiki
Перейти к навигации Перейти к поиску
(не показано 16 промежуточных версий этого же участника)
Строка 1: Строка 1:
==Welcome, foreigners==
Здесь вы найдете краткое руководство, кто хочет освоить маппинг, но не имеет ни малейшего представления, с чего начать.
<center>[[Файл:Exodus_map.png|right|link=http://tauceti.ru/map|Click on me]]</center>
This is a '''russian-speaking''' space station called "'''Exodus'''", and you can join our party! Here is a small guide and tips about playing as a foreign player.
If you heard something bad about the Russians - it may be true, but most of the players here are friendly and kind. Some of them may speak english as well.  


==Rules==
Сам процесс маппинга очень прост - сложность составляет, скорее, знание билда и кода. Однако, вам, как мапперу, очень важно следовать простому, но правильному и удобному рабочему процессу. “Просто возьми ZIP-файл и работай в нем!” - такое нам не подойдет. Устраивайтесь поудобнее, сделайте себе чаю и слушайте внимательно.  
'''It's necessary to know the rules of our community, they are quite simple and designed to make everyone comfortable to play.'''
'''Don't be scared to ask admins and other players(LOOC if its necessarily) about the rules, most of them are speaking english.'''
*'''Don't be a dick'''[[Файл:Gavel.png]]
"Well, that's easy!" - you say. But often players simply don't see that they are spoiling someone's game. If your actions are constantly irritating by other community members - most likely, you are doing something wrong.
*'''Communicate correctly'''[[Файл:Gavel.png]]
Don't use memes and slang IC. Too much swearing is also a very bad tone. '''And for goodness' sake, don't abuse other players.'''
Things you can't do while talking here:
**Flood, spam.
**Discussions on political topics.
**Dissemination of personal information about other members of the community without their consent to this.
**Advertising, especially commercial, except for advertising your own servers.
**Pornographic materials or links to them.
*'''Roleplay(!!!)'''[[Файл:Gavel.png]]
**'''Play realistic''' and natural characters in accordance with the game's lore (including in accordance with the profession, race, game mode). '''Do not play as a crazy person unless you have received brain damage.''' Really. Don't be crazy, lad.
***Use realistic names.
****It is forbidden to use the names of famous people, famous characters from films, books, other art works.
****It is forbidden to use a combination of the name and appearance of other people's characters without a permission of their owner.
**'''Metagame''', with the exception of some cases, is prohibited. ''(Some cases - when knowledge that is not in the character's profession can generally have a positive effect on the game. Especially if the character can justify his knowledge and properly play the situation.)''
**'''DON'T grief'''(Ruin other player's game without a reason), don't spoil the fun of the game and don't create problems for yourself.
**'''Powergame is bad'''
**'''No''' '''OOC in IC''' or '''IC in OOC'''
** '''No Erotic Roleplay'''(Kisses and hugs are allowed, of course)
*'''Don't Coop.'''[[Файл:Gavel.png]]
*'''Streaming''' of rounds is prohibited due to the high threat of metagame and other violations of server rules. In case of prior agreement with the administration, there may be exceptions.
*Server rules apply throughout the game process, '''even after the end of the round.'''[[Файл:Gavel.png]]


==How to survive==
==Что нам понадобится==
''"So, i read the rules, how do i play, if everyone's talking Russian?"'' - Don't worry, i can help you!
[[File:CharacterSetup.png|thumb|right|Character settings window.]]
*'''First - you should create a character. Click "Setup character".'''
**'''General.''' - Сhoose your character appearance and write a flavor. Also, you can choose your background information. All these things doesn't affect game mechanics, except for "Organs" and "Disabilities".
**'''Occupation.''' - Choose your job. '''Beware, we got temporary restrictions on all of the professions, except for the Mime and the Assistant.(And all races, except human)''' Also you can choose type of the assistant. I recommend the "Reporter".
**'''Roles.''' - "Yes" allows you to become special role (Antagonist). As a beginner, it is desirable to put all the roles on "no" until you have played different regimes as a crew member. If you forgot to press "no" and you issue a role, then write to the administration and they will remove it from you.
**'''Loadout.''' - Here you can choose accessories, small items or various clothing for your character.


Возможно, этот список покажется вам слишком длинным и трудоемким, но здесь указаны самые простые и современные программы. Вы не ошибетесь, выбрав их.


* [https://git-scm.com/downloads Git] - нам не избежать его использования.
* [https://github.com/apps/desktop Github Desktop] - Вы можете использовать любой Git-клиент, которым вы уже умеете пользоваться (Bash или GitKraken). Но не забудьте создать на аккаунт на гитхабе.
* [https://github.com/SpaiR/StrongDMM StrongDMM] - лучший редактор карт за авторством нашего любимого SpaiR. Доступен для Windows, Linux, и MacOS. Никогда, слышите, НИКОГДА не используйте Dream Maker для маппинга. Вы только навредите себе и уничтожите любое желание маппить, которое могло у вас остаться.
* [https://code.visualstudio.com/ Visual Studio Code] - это опционально, но очень рекомендуется, потому что вам потребуется тестировать свои изменения на локальном сервере, а также иногда трогать код.


==Git ready to suffer==
В этой главе описан способ вносить в билд свои изменения с помощью Github Desktop, но если вам больше по душе консольный гит - вы можете прочитать [[Git/Git-console|этот гайд]], пропустить данную главу и сразу перейдя в [[Guide to Mapping#Устанавливаем хуки|следующую]].


==Tips and tricks==
 
*
Итак, начнем. Во-первых, вам понадобится [https://git-scm.com/book/ru/v2/GitHub-%d0%92%d0%bd%d0%b5%d1%81%d0%b5%d0%bd%d0%b8%d0%b5-%d1%81%d0%be%d0%b1%d1%81%d1%82%d0%b2%d0%b5%d0%bd%d0%bd%d0%be%d0%b3%d0%be-%d0%b2%d0%ba%d0%bb%d0%b0%d0%b4%d0%b0-%d0%b2-%d0%bf%d1%80%d0%be%d0%b5%d0%ba%d1%82%d1%8b форк]. Форк будет вашей собственной копией нашего репозитория, с которой вы можете делать все, что пожелаете! Просто нажмите эту кнопку на https://github.com/TauCetiStation/TauCetiClassic:
*
 
*Feel free to press "Admin Help" to ask them anything. Most of them are talking eng. and probably 'll help you.
[[Файл:How to fork.png|безрамки|586x586пкс]]
*If you want, you can leave your thoughts about server, thanks and wishes on our forum! How to do it:
 
1. Open [http://tauceti.ru/forums/index.php our site].
 
2. Register.
Как только вы его сделаете, у вас должно появиться что-то подобное в вашем базовом профиле на GitHub.:
3. Open [http://tauceti.ru/forums/index.php?topic=1927.0 Благодарности и пожелания(thanks and wishes)] and press "REPLY" in the upper right.
 
4. Type your message
[[Файл:How to fork2.png|безрамки]]
5. Press "Post"
 
6. Done. Thank you for your message!
Отлично! Итак, я надеюсь, вы уже скачали [https://github.com/apps/desktop Github Desktop]? Следующая часть будет простой: нажмите эту удобную кнопку под “Code” прямо здесь:
 
[[Файл:How to fork3.png|безрамки]]
 
Вы увидите экран, который выглядит примерно так. Просто убедитесь, что у вас есть чистая папка, в которую Git сможет клонировать себя, и нажмите “Clone”:
 
[[Файл:How to fork4.png|безрамки]]
 
Итак, на следующем экране вам нужно нажать “Contribute to the parent project”. Это важно, потому что это немного облегчит вашу жизнь на последующих этапах (На этапе Пул Реквеста):
 
[[Файл:How to fork5.png|безрамки]]
 
Круто, теперь у вас есть копия нашего билда! Однако, прежде чем делать какие-либо изменения, вам нужно сделать одну важную вещь:
 
[[Файл:How to fork6.png|безрамки]]
 
Создать новую ветку! Это супер важно, потому что нам нужно, чтобы главная “master” ветка на вашем форке была как можно более "чистой", без ваших изменений. Для каждого отдельного проекта, над которым вы работаете и для которого отправляете запрос на обновление, вы создадите отдельную ветку. Не стесняйтесь называть ее как хотите! В конце концов, это ваша ветка.
 
[[Файл:How to fork7.png|безрамки]]
 
Вы также можете увидеть экран с надписью “base it off the current branch” или “base it off the upstream/master”. Это зависит от того, чего вы хотите, но если вы хотите начать новый ПР с чистого листа, всегда нажимайте “base it off the upstream/master”.
 
[[Файл:How to fork8.png|безрамки|403x403пкс]]
 
Вот, как все должно выглядеть. Вы отлично справляетесь, так держать!
 
== Устанавливаем хуки ==
'''Этот шаг очень важен!'''
 
Наш репозиторий довольно большой, и в нем одновременно работают большое количество людей, над большим количеством проектов, зачастую на одних и тех же файлах одновременно. Как следствие, в файлах могут возникать конфликты. Но у нас есть отличный набор инструментов, которые помогут нам справиться с этими конфликтами, и установка этих Git-хуков на данный момент - одна из лучших вещей, которые вы можете сделать.
 
Во-первых, в корневом каталоге вашего репозитория перейдите в <code>/tools/_git-hooks</code> и запустите <code>_install.sh</code>. Это автоматически настроит ваши Git-хуки, что избавит вас от многих трудностей. Этот хук будет "объединять" ваши изменения, когда вы редактируете карты. Удостоверьтесь, также, что у вас стоит Java, она нужна для хуков.

Версия 20:20, 9 мая 2025

Здесь вы найдете краткое руководство, кто хочет освоить маппинг, но не имеет ни малейшего представления, с чего начать.

Сам процесс маппинга очень прост - сложность составляет, скорее, знание билда и кода. Однако, вам, как мапперу, очень важно следовать простому, но правильному и удобному рабочему процессу. “Просто возьми ZIP-файл и работай в нем!” - такое нам не подойдет. Устраивайтесь поудобнее, сделайте себе чаю и слушайте внимательно.

Что нам понадобится

Возможно, этот список покажется вам слишком длинным и трудоемким, но здесь указаны самые простые и современные программы. Вы не ошибетесь, выбрав их.

  • Git - нам не избежать его использования.
  • Github Desktop - Вы можете использовать любой Git-клиент, которым вы уже умеете пользоваться (Bash или GitKraken). Но не забудьте создать на аккаунт на гитхабе.
  • StrongDMM - лучший редактор карт за авторством нашего любимого SpaiR. Доступен для Windows, Linux, и MacOS. Никогда, слышите, НИКОГДА не используйте Dream Maker для маппинга. Вы только навредите себе и уничтожите любое желание маппить, которое могло у вас остаться.
  • Visual Studio Code - это опционально, но очень рекомендуется, потому что вам потребуется тестировать свои изменения на локальном сервере, а также иногда трогать код.

Git ready to suffer

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


Итак, начнем. Во-первых, вам понадобится форк. Форк будет вашей собственной копией нашего репозитория, с которой вы можете делать все, что пожелаете! Просто нажмите эту кнопку на https://github.com/TauCetiStation/TauCetiClassic:

How to fork.png


Как только вы его сделаете, у вас должно появиться что-то подобное в вашем базовом профиле на GitHub.:

How to fork2.png

Отлично! Итак, я надеюсь, вы уже скачали Github Desktop? Следующая часть будет простой: нажмите эту удобную кнопку под “Code” прямо здесь:

How to fork3.png

Вы увидите экран, который выглядит примерно так. Просто убедитесь, что у вас есть чистая папка, в которую Git сможет клонировать себя, и нажмите “Clone”:

How to fork4.png

Итак, на следующем экране вам нужно нажать “Contribute to the parent project”. Это важно, потому что это немного облегчит вашу жизнь на последующих этапах (На этапе Пул Реквеста):

How to fork5.png

Круто, теперь у вас есть копия нашего билда! Однако, прежде чем делать какие-либо изменения, вам нужно сделать одну важную вещь:

How to fork6.png

Создать новую ветку! Это супер важно, потому что нам нужно, чтобы главная “master” ветка на вашем форке была как можно более "чистой", без ваших изменений. Для каждого отдельного проекта, над которым вы работаете и для которого отправляете запрос на обновление, вы создадите отдельную ветку. Не стесняйтесь называть ее как хотите! В конце концов, это ваша ветка.

How to fork7.png

Вы также можете увидеть экран с надписью “base it off the current branch” или “base it off the upstream/master”. Это зависит от того, чего вы хотите, но если вы хотите начать новый ПР с чистого листа, всегда нажимайте “base it off the upstream/master”.

How to fork8.png

Вот, как все должно выглядеть. Вы отлично справляетесь, так держать!

Устанавливаем хуки

Этот шаг очень важен!

Наш репозиторий довольно большой, и в нем одновременно работают большое количество людей, над большим количеством проектов, зачастую на одних и тех же файлах одновременно. Как следствие, в файлах могут возникать конфликты. Но у нас есть отличный набор инструментов, которые помогут нам справиться с этими конфликтами, и установка этих Git-хуков на данный момент - одна из лучших вещей, которые вы можете сделать.

Во-первых, в корневом каталоге вашего репозитория перейдите в /tools/_git-hooks и запустите _install.sh. Это автоматически настроит ваши Git-хуки, что избавит вас от многих трудностей. Этот хук будет "объединять" ваши изменения, когда вы редактируете карты. Удостоверьтесь, также, что у вас стоит Java, она нужна для хуков.

Источник — https://wiki.taucetistation.org/index.php?title=Участник:Richard_Jones&oldid=30999