Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ jobs:
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: vitepress/.vitepress/dist
path: .vitepress/dist

# Развёртывание
deploy:
Expand All @@ -63,4 +63,4 @@ jobs:
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
uses: actions/deploy-pages@v4
79 changes: 32 additions & 47 deletions vitepress/.vitepress/config.mts → .vitepress/config.mts
Original file line number Diff line number Diff line change
@@ -1,28 +1,30 @@
import { defineConfig } from 'vitepress';
import { nav, sidebar } from './navigations';

export default defineConfig({
base: '/wiki/',
srcDir: './docs',
markdown: {
container: {
tipLabel: 'Подсказка',
warningLabel: 'Внимание',
dangerLabel: 'Осторожно',
infoLabel: 'Информация',
detailsLabel: 'Подробнее'
}
detailsLabel: 'Подробнее',
},
},
lang: 'ru-RU',
title: "exteraCraft",
description: "exteraCraft - играй по красному",
title: 'exteraCraft',
description: 'exteraCraft - играй по красному',
themeConfig: {
editLink: {
pattern: 'https://github.com/exteracraft/wiki/edit/main/vitepress/:path',
text: 'Предложить изменения на этой странице'
pattern: 'https://github.com/exteracraft/wiki/edit/main/docs/:path',
text: 'Предложить изменения на этой странице',
},
lastUpdated: {
text: 'Последнее обновление'
text: 'Последнее обновление',
},
logo: 'logo.png',
logo: '/logo.png',
search: {
provider: 'local',
options: {
Expand All @@ -31,7 +33,7 @@ export default defineConfig({
translations: {
button: {
buttonText: 'Поиск',
buttonAriaLabel: 'Поиск'
buttonAriaLabel: 'Поиск',
},
modal: {
displayDetails: 'Отобразить подробный список',
Expand All @@ -45,35 +47,19 @@ export default defineConfig({
navigateUpKeyAriaLabel: 'стрелка вверх',
navigateDownKeyAriaLabel: 'стрелка вниз',
closeText: 'закрыть',
closeKeyAriaLabel: 'esc'
}
}
}
}
}
}
},
nav: [
{ text: 'Главная', link: '/' },
{ text: 'Wiki', link: '/main' },
],
sidebar: [
{
text: 'Основное',
items: [
{ text: 'Главная', link: '/main' },
{ text: 'Начать играть', link: '/start' },
{ text: 'Правила', link: '/rule' },
{ text: 'Моды', link: '/mods' },
{ text: 'Зеленая зона', link: '/green-zone' },
{ text: 'Адские ветки', link: '/highway' },
{ text: 'Банк', link: '/bank' },
]
closeKeyAriaLabel: 'esc',
},
},
},
},
},
},
],
},
nav,
sidebar,
socialLinks: [
{ icon: 'telegram', link: 'https://t.me/exteraCraft' },
{ icon: 'github', link: 'https://github.com/exteracraft' }
{ icon: 'github', link: 'https://github.com/exteracraft' },
],
outlineTitle: 'Оглавление',
lastUpdatedText: 'Последнее обновление',
Expand All @@ -82,19 +68,18 @@ export default defineConfig({
darkModeSwitchLabel: 'Тема',
docFooter: {
prev: 'Предыдущая страница',
next: 'Следующая страница'
}
next: 'Следующая страница',
},
},
head: [
['link', { rel: 'stylesheet', href: 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css' }],
['link', { rel: 'icon', href: 'cube.png' }]
[
'link',
{
rel: 'stylesheet',
href: 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css',
},
],
['link', { rel: 'icon', href: 'cube.png' }],
],
vite: {
resolve: {
alias: {
'@components': '/docs/.vitepress/components'
}
}
},
cleanUrls: true
cleanUrls: true,
});
38 changes: 38 additions & 0 deletions .vitepress/navigations.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
export const nav = [
{ text: 'Главная 🏠', link: '/' },
{ text: 'Wiki 📚', link: '/main' }
];

export const sidebar = [
{
text: 'Основное',
items: [
{ text: 'Главная', link: '/main' },
{ text: 'Начать играть', link: '/start' },
{ text: 'Правила', link: '/rule' },
{ text: 'Моды', link: '/mods' },
{ text: 'Зеленая зона', link: '/green-zone' },
{ text: 'Адские ветки', link: '/highway' },
{ text: 'Банк', link: '/bank' }
]
},
{
text: 'Гайды',
collapsed: false,
items: [
{ text: 'Авторизация', link: '/auth' },
{ text: 'Самоуправление', link: '/sde' },
{ text: 'Эмоции', link: '/emotes' },
{ text: 'Голосовой чат', link: '/voice' }
]
},
{
text: 'Лицензии',
collapsed: true,
items: [
{ text: 'LICENSE', link: '/LICENSE' },
{ text: 'LICENSE-CC-BY-NC-SA-4.0', link: '/LICENSE-CC-BY-NC-SA-4.0' },
{ text: 'CLA', link: '/cla' }
]
}
];
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { h } from 'vue'
import type { Theme } from 'vitepress'
import DefaultTheme from 'vitepress/theme'
import './style.css'
import CustomLinkComponent from '../components/CustomLinkComponent.vue' // Обновленный путь
import CustomLinkComponent from '../components/CustomLinkComponent.vue'

export default {
extends: DefaultTheme,
Expand All @@ -16,4 +16,4 @@ export default {
// Регистрируем компонент для использования в приложении
app.component('CustomLinkComponent', CustomLinkComponent)
}
} satisfies Theme
} satisfies Theme
File renamed without changes.
12 changes: 12 additions & 0 deletions docs/LICENSE-CC-BY-NC-SA-4.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
Attribution-NonCommercial-ShareAlike 4.0 International

You are free to:
- Share: Copy and redistribute the material
- Adapt: Remix, transform, and build upon the material

Under these terms:
- Attribution: You must give appropriate credit.
- NonCommercial: You may not use for commercial purposes.
- ShareAlike: Distribute derivatives under same license.

Full text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
53 changes: 53 additions & 0 deletions docs/LICENSE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
[RU] Contributor License Agreement (CLA)

Преамбула
При получении копии лицензируемого объекта любыми способами любое лицо может использовать его только при полном согласии с условиями настоящей Лицензии. Нарушение данных условий предоставляет нам (Лицензиару) право применять меры правовой защиты в соответствии с DMCA и/или применимым законодательством юрисдикций. Принятие условий означает заключение соглашения между вами и организацией exteraCraft. Данное Соглашение является безвозмездным, простым и неисключительным.

Определения
- Wiki: Комплексный объект интеллектуальной собственности - вики-платформа, включающая исходный код, конфигурации, темы оформления, контент статей и плагины.
- Контрибьют: Любое оригинальное произведение авторства Участников, включая модификации движка, темы оформления, плагины или контент статей, которое намеренно передаётся Организации.
- Лицензиар: Команда exteraCraft. Для лицензионных запросов: https://t.me/exteraCraft

Права и ограничения
Настоящая Лицензия предоставляет право:
1. Изучать и модифицировать код исключительно для некоммерческих целей
2. Использовать Wiki для частного хостинга и ознакомления
3. Создавать производные работы при условии передачи изменений обратно в проект

Строго запрещено:
- Публичное распространение модифицированных версий без письменного разрешения
- Коммерческое использование Wiki или её компонентов
- Удаление или сокрытие информации о лицензировании

Оговорка о лицензиях
Различные компоненты Wiki распространяются под разными лицензиями:
- Движок: MIT License
- Контент статей: CC BY-NC-SA 4.0
- Кастомный код и темы: Настоящая CLA

[EN] Contributor License Agreement (CLA)

Preamble
Upon receiving a copy of the licensed object, any person may use it only if they fully agree with these terms. Violation grants the Licensor the right to apply legal protection measures under DMCA and applicable laws. Acceptance constitutes an agreement between you and exteraCraft organization.

Definitions
- Wiki: Complex intellectual property object - wiki platform including source code, configurations, themes, content, and plugins.
- Contribution: Original work by Contributors including engine modifications, themes, plugins, or content intentionally provided to the Organization.
- Licensor: exteraCraft Team. For licensing inquiries: https://t.me/exteraCraft

Rights and Restrictions
This License grants the right to:
1. Study and modify code solely for non-commercial purposes
2. Use Wiki for private hosting and familiarization
3. Create derivative works provided changes are transferred back

Explicitly prohibited:
- Public distribution of modified versions without written permission
- Commercial use of Wiki or its components
- Removal or obfuscation of licensing information

License Reservation
Different Wiki components use different licenses:
- Engine: MIT License
- Content: CC BY-NC-SA 4.0
- Custom code/themes: This CLA
25 changes: 25 additions & 0 deletions docs/auth.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: "Авторизация"
---

# Авторизация

Зайдите на сервер.
Введите пароль и у вас должно появится данное окно.
![](public/auth/connect1.png)

Нажмите на кнопку для привязки.

![](public/auth/open_url.png)

Примите открытие сайта.

![](public/auth/start.png)

Нажмите старт

![](public/auth/done.png)

Готово!

Дальше вы можете использовать сервер и контролировать ваш аккаунт.
13 changes: 13 additions & 0 deletions docs/bank.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
title: "Банк"
---

# Банк

::: warning В разработке
Данный блок находится в разработке.
:::

Через банк можно оплачивать аренду меток и штрафы.

Оформить карточку можно у банкира. Банкирами работают обычные игроки — обычно их можно найти в банке на спавне.
16 changes: 16 additions & 0 deletions docs/cla.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
Preamble
Upon receipt of this license, any person may use the software if they accept all terms.
Violation grants the Licensor rights to enforce protection under DMCA and applicable laws.

Definitions:
- Wiki: The intellectual property object including source code, configuration, themes, and plugins developed by the Team.
- Contribution: Original work provided by Licensee to Licensor (code, docs, graphics, etc.).
- Licensor: exteraCraft Team. Contact: https://t.me/exteraCraft

Scope of Rights:
- Grants non-commercial use rights for modification and private hosting.
- Prohibits commercial use and public hosting without explicit permission.
- Requires contributions to be licensed back to exteraCraft under these terms.

Reservation:
Individual components may carry separate licenses (e.g., content under CC BY-NC-SA 4.0).
25 changes: 25 additions & 0 deletions docs/emotes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: "Эмоции"
---

# Эмоции

![](public/mods/emotes/demo.webp)

Мод **EmoteCraft** добавляет анимированные эмоции.

Вы можете зайти на сервер с ванильного клиента, но чтобы использовать эмоции и видеть эмоции других игроков — необходимо установить мод для **Fabric** или **Forge**:
<CustomLinkComponent href="https://modrinth.com/mod/emotecraft" title="Скачать EmoteCraft" />

## Как пользоваться

![](public/mods/emotes/howto.webp)

1. Нажмите клавишу `B` (английская раскладка) — откроется меню с эмоциями.
2. Кликните по кнопке в правом нижнем углу `Все эмоции`, затем по 'Настройка эмоций`.
3. Выберите эмоцию, затем нажмите на место в круге, куда хотите её установить.
4. Нажмите `Готово`, снова откройте меню (`B`) и протестируйте эмоции.
5. Чтобы добавить больше эмоций — скачайте их и поместите в папку `.minecraft/emotes`.
<CustomLinkComponent href="https://docs.google.com/document/d/1mIh0roUFZ3xiROibgymcMNu6nrD6hrXF18rTmp0SkB4/edit" title="Скачать больше эмоций" />

<CustomLinkComponent href="https://kosmx.gitbook.io/emotecraft/tutorial/custom-emotes" title="Гайд по созданию эмоций в Blender или Blockbench" />
3 changes: 1 addition & 2 deletions vitepress/green-zone.md → docs/green-zone.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,11 @@ title: "Правила зелёных зон"
3. Не используйте и не взрывайте кристаллы, динамит, кровати (в Аду и Энде) и якори возрождения (в Верхнем мире).
4. AFK-торговля разрешена только на государственном рынке.

## Особые правила для энда
::: warning Наказание
От красного варна до бана.
:::

## Особые правила для Энда

1. Перед призывом дракона обязательно предупредите игроков в глобальном чате.
2. Не призывайте дракона во время крупных ивентов.
3. Если дракон разрушил постройки на острове — восстановите их.
Expand Down
10 changes: 5 additions & 5 deletions vitepress/highway.md → docs/highway.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,11 @@ title: "Правила веток в аду"

Поставили новый портал в аду? Сначала поднимите его на 69-й уровень — это стандарт для всех веток.

Дальше ищите ближайшую магистраль. Например, ваш портал стоит на X 128 Z -63. Чтобы путь был максимально коротким, определите, какая из координат по модулю меньше (в нашем случае 63). Именно по этой оси и стоит прокладывать личный тоннель.
Затем найдите ближайшую магистраль. Например, если ваш портал стоит на X 128 Z -63, определите, какая из координат по модулю меньше (в данном случае 63). Именно по этой оси стоит прокладывать личный тоннель.

![](/public/features/higway/highway2.png)

Вам нужно пробиться к ветке X+ — это ближайшая магистраль. Прокладывайте прямой тоннель до точки X 128 Z 0.
В данном примере нужно пробиться к ветке **X+** — это ближайшая магистраль. Проложите прямой тоннель до точки X 128 Z 0.

#### Пример ошибки

Expand All @@ -32,14 +32,14 @@ title: "Правила веток в аду"

### Почему это важно?

- В начале сезона основные ветки уже готовы и оформлены, поэтому вам не придётся тратить силы на лишние десятки блоков.
- В начале сезона основные ветки уже готовы и оформлены, вам не придётся тратить ресурсы на лишнюю прокладку тоннелей.
- Координаты портала становятся универсальным ориентиром — любой игрок легко найдёт дорогу к вам.
- Система меток сервера автоматически строит маршрут до вашего портала на карте. Чтобы всё работало корректно, придерживайтесь этих рекомендаций.

## Основные правила для частных веток

- Личные тоннели не должны выходить за пределы стен главных магистралей.
- Если ваша ветка ведёт в 18+ зону, оставьте табличку.
- Если ваша ветка ведёт в 18+ зону — обязательно оставьте табличку.
- Запрещено убирать центральные перегородки и ставить искусственные преграды.
- Старайтесь аккуратно соединять свои ветки с основными, сохраняя колонны и элементы декора.
- Личные ветки не должны мешать другим тоннелям.
- Личные ветки не должны мешать другим тоннелям.
File renamed without changes.
Loading