initial

.gitignore

@@ -1,132 +1,3 @@
-# ---> Node
+html/*
-# Logs
+!html/.gitkeep
-logs
+node_modules
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional stylelint cache
-.stylelintcache
-
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variable files
-.env
-.env.development.local
-.env.test.local
-.env.production.local
-.env.local
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-out
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-.temp
-.cache
-
-# Docusaurus cache and generated files
-.docusaurus
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# TernJS port file
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
-
-# yarn v2
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-

docs/index.md

@@ -0,0 +1,52 @@
+# Инструкция по старту игры
+
+Эта инструкция немного отличается от обычно встречающихся в Сети. Она сделана с упором на более простую установку без загаживания системы всякими там ~~папками~~ директориями `.minecraft`. Вместо ванильной (т.е. стандартной) мы будем ставить модифицированную версию игры. От обычной она отличается только тем, что работает намного быстрее т.к. моды в сборке нацелены исключительно на производительность. Также в случае необходимости всю установку можно будет удалить подчистую целиком т.к. она полностью портативна. Итак, начнем!  
+  
+**Важно:** не забудьте написать мне свой ник, с которым будете заходить на сервер. Там включен вайтлист.  
+  
+1. Скачайте [UltimMC](https://nightly.link/UltimMC/Launcher/workflows/main/develop). По ссылке доступны версии для Windows, Mac и Linux. Под Linux могут быть какие-нибудь чудеса с кутями, а вот под виндой оно просто работает. Если вы вывалили за игру три тыщи - лучше выбрать [Prism Launcher](https://prismlauncher.org) - это то же самое, но без поддержки локального аккаунта.
+2. Распакуйте архив. Внутри директория `UltimMC` - положите ее туда, откуда хотите запускать игру. Там будут храниться **все** файлы игры - должно быть свободно около пары гигабайт.
+3. Откройте директорию `UltimMC`. Внутри будет бинарник `UltimMC.exe` (под линуксом то же, но без exe, под маком разберетесь сами). Его запускайте.
+4. Вы увидите такое окно. Выберите язык (русский внизу) и нажмите "Далее".  
+![UltimMC - Выбор языка](img/ultimmc_1.png)
+5. В следующем окне производится настройка Java. Нужна как минимум версия 17 (если у вас ниже - вместо 17.x в версии будет что-то иное, например, 1.8.x). Если у вас Java нет - закройте все окна UltimMC и [скачайте Java](https://www.oracle.com/java/technologies/downloads/).  
+Также рекомендую увеличить минимальный объем памяти до двух гигабайт. Если будете ставить шейдеры - ставьте все 4 (4096 МБ), а лучше 6 (6144 МБ)). Если компьютер не самый мощный - лучше шейдерами не рисковать. У меня окно выглядит так:
+![UltimMC - Выбор версии Java по умолчанию](img/ultimmc_2.png)
+6. В этом окне выключите аналитику и нажмите "Завершить":
+![UltimMC - Отключение аналитики](img/ultimmc_3.png)
+7. Открылось главное окно приложения. В нем сразу открываем управление аккаунтами:
+![UltimMC - Открытие управления аккаунтами](img/ultimmc_4.png)
+8. В открывшемся окне нажимаем "Add Account":
+![UltimMC - Управление аккаунтами](img/ultimmc_5.png)
+8. Здесь укажите ник, с которым будете играть. В пароль укажите что угодно, галки не меняйте. Как заполните - жмите "ОК", а затем закройте окно настроек.
+![UltimMC - Добавление аккаунта](img/ultimmc_6.png)
+9. Теперь будем добавлять сборку. В левом верхнем углу окна жмякните на "Добавить сборку". В открывшемся окне выберите слева "Modrinth", затем в поиске введите "Fabulously Optimized" (скорее всего, уже будет в самом верху списка висеть) и подождите пока подгрузится название. Окно должно выглядеть как на рисунке ниже. Нажмите "ОК" и дождитесь загрузки сборки:
+![UltimMC - Добавление сборки](img/ultimmc_7.png)
+10. Теперь окно лаунчера выглядит как на рисунке ниже. Запустить игру можно двойным кликом по иконке или кликом по кнопке запуска (какое-то время уйдет на подгрузку ресурсов игры - эта операция выполняется только при первом запуске):
+![UltimMC - Запуск игры](img/ultimmc_8.png)
+11. Поздравляю - вы в игре! Маленькой иконкой глобуса слева снизу можно поменять язык. Пока что откройте мультиплеер.
+![Minecraft - Главное меню](img/minecraft_1.png)
+12. Нажмите "Add Server" ("Добавить сервер"):
+![Minecraft - Список серверов](img/minecraft_2.png)
+13. В поле адреса укажите `mc.neur0tx.site` (да, прям так), имя можете не менять. Переключите настройку `Server Resource Packs: Prompt` в `Server Resource Packs: Enabled` (рус. `Наборы ресурсов: Включены`). Нажмите "Done" ("Готово"):
+![Minecraft - Добавление сервера](img/minecraft_3.png)
+14. Зайдите на сервер двойным кликом:
+![Minecraft - Вход на сервер](img/minecraft_4.png)
+
+Готово! Можно играть.
+
+# Моды, ресурс-паки, шейдеры
+
+В скачанной нами сборке есть поддержка как модов, так и шейдеров. Всем этим добром можно управлять прям из лаунчера (кнопка "Редактировать сборку" - именно поэтому мы ставили этот лаунчер). Для графики рекомендую использовать:
+- Ресурс-пак: [Unity](https://www.curseforge.com/minecraft/texture-packs/unity) (если будут глючные текстуры - пробуйте [эту версию](https://1drv.ms/u/s!AgqdR_LDCD8Cga5KvzDeeUJxapmWzQ?e=1Xk237)) + [Unity Dark (темная тема)](https://www.curseforge.com/minecraft/texture-packs/unity-dark-edition) + [Unity PBR (нужно для шейдеров)](https://www.curseforge.com/minecraft/texture-packs/unity-pbr)/
+- Шейдеры: [Super Duper Vanilla Shaders](https://www.curseforge.com/minecraft/customization/super-duper-vanilla-shaders/)
+
+При этом Minecraft выглядит [вот так](https://youtu.be/nXtaqalfxBQ). Дополнительно я использую еще пачку мелких модов, которые добавляют детали вроде новых анимаций движения и поедания, или новые звуки. Но это ставить необязательно.
+
+Моды, модпаки и шейдеры можно скачивать с:
+- [Curseforge](https://www.curseforge.com/minecraft/mc-mods)
+- [Modrinth](https://modrinth.com/)
+
+При этом учитывайте, что моды иногда хотят различные доп. библиотеки для своей работы (обычно это указано в описании), а загрузчиков модов существует ажнак целых три: [Forge](https://files.minecraftforge.net/net/minecraftforge/forge/), [Fabric](https://fabricmc.net) и [Quilt](https://quiltmc.org/) (рекомендую последний).
+
+На этом все.

layout/assets/hljs-solarized-dark.min.css

@@ -0,0 +1,108 @@
+/*
+
+Orginal Style from ethanschoonover.com/solarized (c) Jeremy Hull <sourdrums@gmail.com>
+
+*/
+
+.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 0.5em;
+  /* background: #fdf6e3; */
+  color: #657b83;
+  -webkit-text-size-adjust: none;
+}
+
+.hljs-comment,
+.diff .hljs-header,
+.hljs-doctype,
+.hljs-pi,
+.lisp .hljs-string,
+.hljs-javadoc {
+  color: #93a1a1;
+}
+
+/* Solarized Green */
+.hljs-keyword,
+.hljs-winutils,
+.method,
+.hljs-addition,
+.css .hljs-tag,
+.hljs-request,
+.hljs-status,
+.nginx .hljs-title {
+  color: #859900;
+}
+
+/* Solarized Cyan */
+.hljs-number,
+.hljs-command,
+.hljs-string,
+.hljs-tag .hljs-value,
+.hljs-rules .hljs-value,
+.hljs-phpdoc,
+.hljs-dartdoc,
+.tex .hljs-formula,
+.hljs-regexp,
+.hljs-hexcolor,
+.hljs-link_url {
+  color: #2aa198;
+}
+
+/* Solarized Blue */
+.hljs-title,
+.hljs-localvars,
+.hljs-chunk,
+.hljs-decorator,
+.hljs-built_in,
+.hljs-identifier,
+.vhdl .hljs-literal,
+.hljs-id,
+.css .hljs-function {
+  color: #268bd2;
+}
+
+/* Solarized Yellow */
+.hljs-attribute,
+.hljs-variable,
+.lisp .hljs-body,
+.smalltalk .hljs-number,
+.hljs-constant,
+.hljs-class .hljs-title,
+.hljs-parent,
+.hljs-type,
+.hljs-link_reference {
+  color: #b58900;
+}
+
+/* Solarized Orange */
+.hljs-preprocessor,
+.hljs-preprocessor .hljs-keyword,
+.hljs-pragma,
+.hljs-shebang,
+.hljs-symbol,
+.hljs-symbol .hljs-string,
+.diff .hljs-change,
+.hljs-special,
+.hljs-attr_selector,
+.hljs-subst,
+.hljs-cdata,
+.css .hljs-pseudo,
+.hljs-header {
+  color: #cb4b16;
+}
+
+/* Solarized Red */
+.hljs-deletion,
+.hljs-important {
+  color: #dc322f;
+}
+
+/* Solarized Violet */
+.hljs-link_label {
+  color: #6c71c4;
+}
+
+.tex .hljs-formula {
+  background: #eee8d5;
+}

layout/assets/pilcrow.css

@@ -0,0 +1,42 @@
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  position: relative;
+}
+
+h1:hover .header-link:before,
+h2:hover .header-link:before,
+h3:hover .header-link:before,
+h4:hover .header-link:before,
+h5:hover .header-link:before,
+h6:hover .header-link:before {
+    content: "\00B6";/* pilcrow */
+    color: #888;
+    font-size: smaller;
+}
+
+.header-link {
+  -webkit-user-select: none;
+  -moz-user-select: none;
+  -ms-user-select: none;
+  user-select: none;
+
+  position: absolute;
+  top: 0;
+  left: -0.7em;
+  display: block;
+  padding-right: 1em;
+}
+
+h1:hover .header-link,
+h2:hover .header-link,
+h3:hover .header-link,
+h4:hover .header-link,
+h5:hover .header-link,
+h6:hover .header-link {
+  display: inline-block;
+  text-decoration: none;
+}

layout/assets/style.css

@@ -0,0 +1,309 @@
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+nav,
+section,
+summary {
+  display: block;
+}
+audio,
+canvas,
+video {
+  display: inline-block;
+}
+audio:not([controls]) {
+  display: none;
+  height: 0;
+}
+[hidden] {
+  display: none;
+}
+html {
+  font-family: sans-serif;
+  -webkit-text-size-adjust: 100%;
+  -ms-text-size-adjust: 100%;
+}
+body {
+  margin: 0;
+  line-height: 1.5rem;
+}
+a:focus {
+  outline: thin dotted;
+}
+a:active,
+a:hover {
+  outline: 0;
+}
+h1 {
+  font-size: 2em;
+}
+abbr[title] {
+  border-bottom: 1px dotted;
+}
+b,
+strong {
+  font-weight: bold;
+}
+dfn {
+  font-style: italic;
+}
+mark {
+  background: #ff0;
+  color: #000;
+}
+code,
+kbd,
+pre,
+samp {
+  font-family: monospace, serif;
+  font-size: 1em;
+}
+pre {
+  white-space: pre-wrap;
+  word-wrap: break-word;
+}
+q {
+  quotes: "\201C" "\201D" "\2018" "\2019";
+}
+small {
+  font-size: 80%;
+}
+sub,
+sup {
+  font-size: 75%;
+  line-height: 0;
+  position: relative;
+  vertical-align: baseline;
+}
+sup {
+  top: -0.5em;
+}
+sub {
+  bottom: -0.25em;
+}
+img {
+  border: 0;
+  padding: 15px 0;
+  display: block;
+  max-width: 900px;
+}
+svg:not(:root) {
+  overflow: hidden;
+}
+figure {
+  margin: 0;
+}
+fieldset {
+  border: 1px solid #c0c0c0;
+  margin: 0 2px;
+  padding: 0.35em 0.625em 0.75em;
+}
+legend {
+  border: 0;
+  padding: 0;
+}
+button,
+input,
+select,
+textarea {
+  font-family: inherit;
+  font-size: 100%;
+  margin: 0;
+}
+button,
+input {
+  line-height: normal;
+}
+button,
+html input[type="button"],
+input[type="reset"],
+input[type="submit"] {
+  -webkit-appearance: button;
+  cursor: pointer;
+}
+button[disabled],
+input[disabled] {
+  cursor: default;
+}
+input[type="checkbox"],
+input[type="radio"] {
+  box-sizing: border-box;
+  padding: 0;
+}
+input[type="search"] {
+  -webkit-appearance: textfield;
+  -moz-box-sizing: content-box;
+  -webkit-box-sizing: content-box;
+  box-sizing: content-box;
+}
+input[type="search"]::-webkit-search-cancel-button,
+input[type="search"]::-webkit-search-decoration {
+  -webkit-appearance: none;
+}
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+  border: 0;
+  padding: 0;
+}
+textarea {
+  overflow: auto;
+  vertical-align: top;
+}
+table {
+  border-collapse: collapse;
+  border-spacing: 0;
+}
+@import url(//fonts.googleapis.com/css?family=PT+Sans);
+@import url(//fonts.googleapis.com/css?family=PT+Sans+Narrow:400,700);
+html {
+  font-family: 'PT Sans', sans-serif;
+}
+pre,
+code {
+  font-family: monospace, sans-serif;
+}
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-family: 'PT Sans Narrow', sans-serif;
+  font-weight: 700;
+}
+html {
+  background-color: #002b36;
+  color: #839496;
+  margin: 1em;
+}
+code {
+  background-color: #073642;
+  padding: 2px;
+}
+a {
+  color: #b58900;
+}
+a:visited {
+  color: #cb4b16;
+}
+a:hover {
+  color: #cb4b16;
+}
+h1 {
+  color: #d33682;
+}
+h2,
+h3,
+h4,
+h5,
+h6 {
+  color: #859900;
+}
+pre {
+  background-color: #002b36;
+  color: #839496;
+  border: 1pt solid #586e75;
+  padding: 1em;
+  box-shadow: 5pt 5pt 8pt #073642;
+}
+pre code {
+  background-color: #002b36;
+}
+h1 {
+  font-size: 2.8em;
+}
+h2 {
+  font-size: 2.4em;
+}
+h3 {
+  font-size: 1.8em;
+}
+h4 {
+  font-size: 1.4em;
+}
+h5 {
+  font-size: 1.3em;
+}
+h6 {
+  font-size: 1.15em;
+}
+.tag {
+  background-color: #073642;
+  color: #d33682;
+  padding: 0 0.2em;
+}
+.todo,
+.next,
+.done {
+  color: #002b36;
+  background-color: #dc322f;
+  padding: 0 0.2em;
+}
+.tag {
+  -webkit-border-radius: 0.35em;
+  -moz-border-radius: 0.35em;
+  border-radius: 0.35em;
+}
+.TODO {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  background-color: #2aa198;
+}
+.NEXT {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  background-color: #268bd2;
+}
+.ACTIVE {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  background-color: #268bd2;
+}
+.DONE {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  background-color: #859900;
+}
+.WAITING {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  foreground-color: #cb4b16;
+}
+.HOLD {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  foreground-color: #d33682;
+}
+.NOTE {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  foreground-color: #d33682;
+}
+.CANCELLED {
+  -webkit-border-radius: 0.2em;
+  -moz-border-radius: 0.2em;
+  border-radius: 0.2em;
+  foreground-color: #859900;
+}
+#container {
+  max-width: 900px;
+  height: 100%;
+  margin: 0 auto;
+}
+hr {
+  border: 1px solid #657b83;
+  background: #657b83;
+  box-sizing: border-box;
+}

layout/page.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>{{title}}</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <link rel="icon" href="{{asset 'favicon.ico'}}" type="image/x-icon"/>
+    <link type="text/css" rel="stylesheet" href="{{asset 'style.css'}}" />
+    <link type="text/css" rel="stylesheet" href="{{asset 'pilcrow.css'}}" />
+    <link type="text/css" rel="stylesheet" href="{{asset 'hljs-solarized-dark.min.css'}}"/>
+  </head>
+<body>
+  <div id="container">
+    {{~> content}}
+  </div>
+</body>
+</html>

package.json

@@ -0,0 +1,17 @@
+{
+  "name": "mc-neur0tx-site-docs",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "build": "npx generate-md --layout ./layout --input ./docs --output ./html"
+  },
+  "author": "Neur0toxine",
+  "license": "MIT",
+  "dependencies": {
+    "markdown-styles": "^3.2.0"
+  }
+}