Ir para o conteúdo principal
Version: latest - a1.19.x ⚖️

Assets Guide

Tudo o que você precisa saber sobre os Ativos

Assets in nanos world are all objects or content which come from Unreal Engine. For example Maps, StaticMeshes, SkeletalMeshes, Sounds, Particles, Blueprints etc are all types of Assets.

In order to use custom Assets in your servers, for example to spawn a Prop, or a custom Weapon you must have an Asset Pack. Pacotes de ativos são um conjunto de ativos que foram exportados juntos do Unreal.

Estrutura da pasta

Todos os Pacotes de Ativos estão abaixo da pasta Servidor/Ativos/. Cada pacote de ativos é uma pasta sob isso.

Note

Asset Packs downloaded when connecting to servers or downloaded from the vault will be stored in Server/Assets/ folder as well!

This is an example of a server Assets folder:

Server Folder
NanosWorldServer.exe
Assets/
├── my-asset-pack-01/
│ ├── MyAsset_01.uasset
│ ├── MyAsset_02.uasset
│ ├── MyBigMap.umap
│ │ ...
│ └── Assets.toml
├── awesome-weapons/
│ ├── BigFuckingGun.uasset
│ │ ...
│ └── Assets.toml
Packages/
Config.toml

Configuração do pacote de mídias

Os Pacotes de ativos têm um arquivo de configuração na raiz da pasta Pacote de Ativos, chamado de Ativos. oml, neste arquivo podemos configurar todas as configurações pertinentes relacionadas com o Pacote de Ativos:

Assets.toml
loading...

Configurações Detalhadas

See a description of what each setting does:

ConfiguraçãoDescription
NomeNome amigável do Pacote de Ativos
autorAuthor(s) of the Asset Pack
VersãoVersão do Pacote de Ativos - por favor, consulte a SemVer
ImagemURL da imagem a ser exibida no Cofre
pasta_irrealNome da pasta raiz do Projeto Unreal que exportou este Atributo. This is important so the Assets can keep the relative references correctly
assets.mapsLista de mapas neste pacote de ativos
assets.static_meshesLista de malhas estáticas neste pacote de ativos
assets.skeletal_meshesLista de Malhas Esqueléticas neste Pacote de Conteúdos
assets.sonsLista de sons deste Pacote de Conteúdos
ativos.animaçõesLista de Animações neste Pacote de Conteúdos
assets.particlesList of Particles in this Asset Pack
assets.materialsList of Materials in this Asset Pack
assets.blueprintsList of Blueprints in this Asset Pack
ativos.outrosLista de outros Ativos neste Pacote de Ativos

Conteúdos de referência no Scripting

To be able to use Assets in your code, first you have to ensure that the Asset Pack is loaded. An Asset Pack is loaded when:

  1. A map is loaded (this will make it's Asset Pack to be loaded automatically).
  2. A package with it configured in assets_requirements is loaded.
  3. It is manually set in Server's Config.toml at assets to load.

With the Asset Pack loaded, you can refer to it's assets using the following pattern:

"[ASSET_PACK_PATH]::[ASSET_KEY]"

Example:

"my-asset-pack-01::SM_Cube"

info

[ASSET_PACK_PATH] is the folder name and [ASSET_KEY] is the key defined in the Assets.toml.

Tipos de Ativos

Some scripting methods require some specific Type of Assets to load. Attempting to load an invalid or wrong type will cause an Error. Ex.: Character:SetMesh() requer um ativo do tipo Esquelético Malha.

Here's a list of all supported Asset types:

TypeDescription
MapearUm Mapa de Motor/Nível Unreal
Malha EstáticaMalhas estáticas irreais podem ser usadas para carregar malhas para Props e StaticMeshes
Malha EsqueléticaMalhas Esqueléticas Inreais podem ser usadas para carregar malhas de Caracteres e Veículos
SoundSons não reais para carregar sons
ParticleUnreal Particles can be used for settings in several entities, including Particle Class itself
AnimationAnimações irreais podem ser usadas para configurações de Personagem e Armas
MaterialUnreal Materials can be used for customizing meshes surfaces and used as Post Process
BlueprintUnreal Actor Blueprints can be used for spawning Blueprint entities

Creating your own Assets

To create your own Asset Pack, please refer to Importing Custom Assets Guide.

📦 Importing Custom Assetsassets-modding/creating-assets/setting-up-ue

Default Asset Pack

nanos mundo fornece um Pacote de Ativos padrão que já está incluído no jogo base. Please refer to the Default Asset Pack page for more information.

📦 Default Asset Packassets-modding/default-asset-pack/default-assets-list