Introduction-to-resources

Введение в ресурсы

Серверы работают на коллекции ресурсов. Ресурс - это коллекция файлов - таких как клиентские скрипты, сервер скрипты и потоковые ресурсы - которые можно запускать, останавливать и перезапускать в любое время.

Каталоги ресурсов

На сервере ресурсы загружаются из папки, вызываемой в каталоге данных сервера. Любая папка в папка анализируется как ресурс, за исключением папок, между которыми находятся категории, которые могут содержат несколько папок ресурсов.resources/resources/[brackets]

Каждая папка ресурсов также должна содержать ссылку на манифест ресурса, называемую (или ранее) быть правильно проанализирован как ресурс.fxmanifest.lua__resource.lua

Смотрите этот пример дерева каталогов:

server
└── resources
    ├── [category]
    │   ├── [another]
    │   │   └── thing
    │   │       └── fxmanifest.lua
    │   └── resource-1
    │       └── fxmanifest.lua
    └── main
        └── fxmanifest.lua

В этом дереве существуют следующие ресурсы:

• главный
• ресурс-1
• вещь

Манифест ресурса

Каждый ресурс должен содержать манифест ресурса по имени, определяющему, какие файлы/сценарии используются ресурсом. Ниже приведен краткий пример манифеста:fxmanifest.lua

-- Resource Metadata
fx_version 'cerulean'
games { 'rdr3', 'gta5' }

author 'John Doe <j.doe@example.com>'
description 'Example resource'
version '1.0.0'

-- What to run
client_scripts {
    'client.lua',
    'client_two.lua'
}
server_script 'server.lua'

-- Extra data can be used as well
my_data 'one' { two = 42 }
my_data 'three' { four = 69 }

-- due to Lua syntax, the following works too:
my_data('nine')({ninety = "nein"})

-- metadata keys can be arbitrary
pizza_topping 'pineapple'

Дополнительные сведения см. в справочнике по манифесту ресурса.

Стандартные ресурсы

После установки сервера вы заметите, что у вас уже есть довольно много ресурсов. Это стандарт ресурсы, которые FiveM поставляет и обслуживает. Рекомендуется не менять их, если вы не знаете, что делаете. Многие из эти ресурсы предоставляют серверу полезные функциональные возможности.

Дополнительные сведения о стандартных ресурсах можно найти в каталоге ресурсов.

Руководства по написанию сценариев