Rust:Тонкости администрирования сервера uMod или Oxide: различия между версиями
Cucagmin (обсуждение | вклад) |
Cucagmin (обсуждение | вклад) |
||
Строка 65: | Строка 65: | ||
<p> </p> | <p> </p> | ||
<p> </p> | <p> </p> | ||
<h1>Установка плагинов</h1> | |||
<p>Установка uMod плагинов занимает всего пару щелчков мыши.</p> | |||
<h2>Требования сервера</h2> | |||
<p> Чтобы установить плагин на сервер, сервер должен поддерживать Oxide 2.0 или выше, иначе плагины не будут загружаться или делать что-либо.</p> | |||
<p>Запустите сервер и проверьте установлен ли мод с помощью консольной команды <span style="font-size: 10.0pt;">oxide.version</span>.</p> | |||
<h2>Загрузка исходного кода</h2> | |||
<h1> | <p>Скачайте плагин [https://umod.org/plugins этой странице];</p> | ||
<p> | <h6><strong><span style="font-family: 'Calibri Light',sans-serif;">НЕ</span></strong> переименовывайте плагин и не изменяйте его расширение.</h6> | ||
<h2> | <h2>Удалённое управление</h2> | ||
<p> | <p>Если сервер расположен не локально, тогда подключитесь к серверу с помощью FTP client. Данные для подключения уточните у технической поддержки хостинга.</p> | ||
<p> | <h2>Папка плагинов</h2> | ||
<h2> | <p>Найдите папку <span style="font-size: 10.0pt;">plugins</span>, которая по умолчанию располагается по пути <span style="font-size: 10.0pt;">oxide/plugins</span></p> | ||
<p> | <h2>Загрузка исходного кода</h2> | ||
<h6> | <p>Загрузите плагин в папку "plugins", и он автоматически загрузится если плагин рабочий и мод Oxide установлен правильно</p> | ||
<h2> | <p>Продолжайте настройку путём настройки конфигурации плагина</a>..</p> | ||
<p> | <h2>Обновление</h2> | ||
<h2> | <p> Если плагин уже установлен и доступно обновление, просто перезапишите исходный файл (.cs) в папке <i>plugins</i>, и новая версия будет загружена автоматически.</p> | ||
<p> | |||
<h2> | |||
<p> | |||
<p> | |||
<h2> | |||
<p> | |||
<p> </p> | <p> </p> | ||
<p> </p> | <p> </p> |
Версия 11:33, 29 января 2019
Начало
Установка
Требования к серверу
Требования к платформе uMod варьируются в зависимости от игрового сервера.
Дополнительную информацию о поддержке uMod для определенных игр можно найти на сайте uMod
Установка uMod
Загрузка по прямой ссылке
- Загрузите версию uMod для вашего сервера.
- Скопируйте файлы из архива в папку сервера с подтверждением замены
Плагины
Плагины - это отдельные фрагменты кода, которые изменяют поведение игрового сервера..
Для получения большего количества информации о плагинах посетите Plugins - Getting Started.
Расширения
Расширения - это обычно большие проекты, которые добавляют функциональность в uMod или вносят существенные изменения в сервер.
Посмотреть все доступные расширения
Получение дополнительной информации
Поиск
Пожалуйста, пользуйтесь поиском прежде чем создавать новые темы.
- Поиск в документации
- Поиск ответов на форумах
Плагины и расширения
При возникновении проблем:
- Посетите страницу ресурса и нажмите кнопку Help.
- Создайте новую тему в обсуждениях ресурса.
Плагины
Плагины - это отдельные фрагменты кода, которые изменяют поведение игрового сервера.
Файлы плагина
Код плагинов написан на языке CSharp (C#), файл имеет расширение .cs.
Installing a code file
Больше информации о установке плагина сможете найти на странице ["https://umod.org/documentation/umod/plugins/installation Plugins - Installation].
Configuring a plugin
Большинство плагинов во время установки генерируют JSON конфигурационный файл, в котором можно настраивать работу плагина.
Больше информации о конфигурировании плагина можете найти на странице ["https://umod.org/documentation/umod/plugins/configuration Plugins - Configuration].
Разрешения плагинов (permissions)
Многие плагины включают в себя различные разрешения, которые должны быть назначены для использования функций, предоставляемых плагином.
More information about access control may be found at <a href="https://umod.org/documentation/umod/plugins/permissions">Plugins - Permissions</a>.
Команды плагинов
Многие плагины будут включать команды, которые могут использоваться игроками или администраторами сервера. Не каждая игра будет иметь оба типа команд, и по умолчанию команды могут быть доступны для консоли и в игре (если она доступна).
Консольные команды
Консольная команда это команда, которая запускается из:
- Внутриигровой консоли (если она есть в игре)
- Программное окно сервера (если поддерживается платформой)
- RCON консоль(если игра поддерживает RCON)
Chat - команды
Chat - команды вводятся игроками, которые подключены к игре. Chat - команды начинаются со знака /.
Например: /help
Установка плагинов
Установка uMod плагинов занимает всего пару щелчков мыши.
Требования сервера
Чтобы установить плагин на сервер, сервер должен поддерживать Oxide 2.0 или выше, иначе плагины не будут загружаться или делать что-либо.
Запустите сервер и проверьте установлен ли мод с помощью консольной команды oxide.version.
Загрузка исходного кода
Скачайте плагин этой странице;
НЕ переименовывайте плагин и не изменяйте его расширение.
Удалённое управление
Если сервер расположен не локально, тогда подключитесь к серверу с помощью FTP client. Данные для подключения уточните у технической поддержки хостинга.
Папка плагинов
Найдите папку plugins, которая по умолчанию располагается по пути oxide/plugins
Загрузка исходного кода
Загрузите плагин в папку "plugins", и он автоматически загрузится если плагин рабочий и мод Oxide установлен правильно
Продолжайте настройку путём настройки конфигурации плагина</a>..
Обновление
Если плагин уже установлен и доступно обновление, просто перезапишите исходный файл (.cs) в папке plugins, и новая версия будет загружена автоматически.
- <a href="https://umod.org/documentation/plugins/configuration#config-directory">Config directory</a>
- <a href="https://umod.org/documentation/plugins/configuration#file-name" data-uid="xcZeJRrfS871er4W" data-level="2">File name</a>
- <a href="https://umod.org/documentation/plugins/configuration#valid-json" data-uid="rJ716na1IyKDKhsZ" data-level="2">Valid JSON</a>
- <a href="https://umod.org/documentation/plugins/configuration#applying-changes" data-uid="iNS5ZZ05JUKjlYrH" data-level="2">Applying changes</a>
Plugin configuration
Most plugins will generate a JSON configuration file once loaded. With this file, a server owner may change how a plugin works.
Config directory
Configuration files are found in the config folder which is located by default in oxide/config (unless the server host has moved it).
File name
A plugin configuration file will have the same name as the plugin itself.
For example, a plugin that is installed as MyPlugin.cs (if it is configurable) will be accompanied by a JSON file named MyPlugin.json
Do not rename the configuration file or change the file extension.
If a plugin is installed but not configurable, no configuration file will be present.
If a plugin is configurable but no configuration file is available, the plugin may be broken; in this case, check the log files under the oxide/logs directory for errors.
Valid JSON
All plugin configuration files are saved as JSON (JavaScript Object Notation). Configuration files must be valid JSON. Use a validator such as <a href="https://jsonlint.com">jsonlint.com</a> to ensure the configuration is valid JSON.
Applying changes
After making changes to a plugin configuration file, reload the plugin in the server console by using the oxide.reload command. For example:
oxide.reload MyPlugin
- <a href="https://umod.org/documentation/plugins/permissions#players">Players</a>
- <a href="https://umod.org/documentation/plugins/permissions#groups" data-uid="0wKJ7fRvmvug9qsF" data-level="2">Groups</a>
- <a href="https://umod.org/documentation/plugins/permissions#showing-all-groups-or-permissions" data-uid="727kiZwOcVsDGlIu" data-level="2">Showing all groups or permissions</a>
- <a href="https://umod.org/documentation/plugins/permissions#using-wildcards" data-uid="5LB3OHFU2AY7mGey" data-level="2">Using wildcards</a>
- <a href="https://umod.org/documentation/plugins/permissions#conclusion" data-uid="qJh0q4uDYOqoA9VW" data-level="2">Conclusion</a>
Permissions
Permissions allows server owners to give players unique abilities and benefits on their servers.
Administering permissions is easy; simply enter the desired command and you're done! If your server does not have a console, you can use any compatible RCON tool or remote console to send the commands to the server. Most Oxide/uMod-supported games also support the permission commands in the chat, or will soon.
For this guide, the permission epicstuff.use will be used as an example. Keep in mind that permissions only exist if provided by a plugin or Oxide/uMod itself.
By default, the groups that are created by Oxide/uMod are: admin and default. These can be changed by editing those under the umod.config.json file. The admin group will automatically be assigned to players that are recognized as admin by the server. The "default" group will automatically be assigned to ALL players that connect to the server.
Players
Grant a permission to an individual player
oxide.grant player Wulf epicstuff.use
Revoke a permission from an individual player
oxide.revoke player Wulf epicstuff.use
Show a player's permissions
oxide.show player Wulf
Showing which player or group has a permission
Sometimes this command is helpful when tracking down who has a permission.
oxide.show perm epicstuff.use
Groups
Grant a permission to an entire group
oxide.grant group admin epicstuff.use
Revoke a permission from a group
oxide.revoke group admin epicstuff.use
Adding a player to an existing group
Adding a player to a group will give them all of the permissions assigned to that group.
oxide.usergroup add Wulf admin
Removing a player from an existing group
Removing a player from a group will remove from them all of the permissions assigned to that group.
oxide.usergroup remove Wulf admin
Adding an entirely new group
oxide.group add vipoxide.group add vip VIP 0
Removing an existing group
oxide.group remove vip
Setting the title or rank of a group
The group title is usually a short description of a group, sometimes used for chat titles. The rank is a number which sorts a group based on its importance.
oxide.group set vip "[VIP Member]"oxide.group set vip "[VIP Member]" 1
Setting the parent group of another group
A group will inherit all permissions from its parent group.
oxide.group parent admin default
Showing a group's members and permissions
oxide.show group admin
Showing all groups or permissions
To show all of the permission groups, simple use the command below.
oxide.show groups
The show all of the registered permissions from plugins and Oxide/uMod, use the command below.
oxide.show perms
Using wildcards
A wildcard is something that covers multiple things at once time. For permissions, this is the * symbol. You can use the wildcard (*) to grant multiple permissions at one time. This can be done with all permissions or per plugin based on prefix.
oxide.grant group admin *oxide.grant player Wulf umod.*
Conclusion
The same commands are also available with the "o." prefix (ex. "o.grant").
That's the basics to permissions for Oxide/uMod. Permissions give you a fantastic way to manage staff without worrying about them abusing powers from the game's admin functionality (such as flight, noclip, super speed, etc.) so they can still enjoy the game but also help monitor your server at the same time.
- <a href="https://umod.org/documentation/plugins/data-files#data-directory">Data directory</a>
- <a href="https://umod.org/documentation/plugins/data-files#file-names">File names</a>
- <a href="https://umod.org/documentation/plugins/data-files#valid-json">Valid JSON</a>
Data Files
Data files are JSON files that plugins may use to store arbitrary data.
Data directory
Data files may be found in the data folder which located by default in oxide/data (unless the server host has moved it).
File names
Data files do not follow any naming convention, a plugin author may specify any name when creating a data file.
It is recommended to plugin authors, when creating a large number of data files, to create them in a subdirectory specific to their plugin.
Valid JSON
All plugin data files are saved as JSON (JavaScript Object Notation). Data files must be valid JSON. If editing a data file manually, use a validator such as <a href="https://jsonlint.com">jsonlint.com</a> to ensure the data file is valid JSON.