Skip to main content
Version: latest - a1.19.x ⚖️

Assets Guide

Alles was Sie über Assets wissen müssen

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. Asset-Packs sind eine Sammlung von Assets die zusammen aus Unreal exportiert wurden.

Ordnerstruktur

Alle Asset Packs gehen unter Server/Assets/ Ordner. Jedes Asset Pack ist ein Ordner unter diesem.

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

Assets Pack-Konfiguration

Asset Packs haben eine Konfigurationsdatei im Stammverzeichnis des Asset Pack-Ordners, genannt Assets. oml, in dieser Datei können wir alle relevanten Einstellungen für das Asset Pack einrichten:

Assets.toml
loading...

Einstellungen detailliert

See a description of what each setting does:

EinstellungBeschreibung
nameFreundlicher Name des Asset Packs
autorAuthor(s) of the Asset Pack
versionVersion des Asset Packs - siehe SemVer
bildURL des Bildes im Tresor anzeigen
unreal_OrdnerName des Wurzelordners im Unreal Projekt, das diese Dateien exportiert hat. This is important so the Assets can keep the relative references correctly
assets.mapsListe der Karten in diesem Asset-Paket
assets.static_gitterListe der statischen Netze in diesem Asset Pack
assets.skelette_gitterListe der Skelett-Netze in diesem Asset Paket
assets.soundsListe der Töne in diesem Asset Pack
assets.animationsListe der Animationen in diesem Asset Pack
assets.particlesList of Particles in this Asset Pack
assets.materialsList of Materials in this Asset Pack
assets.blueprintsList of Blueprints in this Asset Pack
vermögen.othersListe anderer Assets in diesem Asset Pack

Verweise auf Assets im Skripting

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"

Notiz

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

Arten von Assets

Some scripting methods require some specific Type of Assets to load. Attempting to load an invalid or wrong type will cause an Error. Bsp.: Zeichen: SetMesh() benötigt ein Asset vom Typ Skelett-Netz.

Here's a list of all supported Asset types:

TypeBeschreibung
KarteEine unechte Motorkarte/-ebene
Statisches NetzUnreal statische Netze können verwendet werden, um Netze für Props und StaticMeshes zu laden
SkelettnetzwerkUnechte Skelettnetze können verwendet werden, um Netze für Charaktere und Fahrzeuge zu laden
SoundUnechte Sounds zum Laden von Sounds
ParticleUnreal Particles can be used for settings in several entities, including Particle Class itself
AnimationUnreale Animationen können für Einstellungen in Charakter und Waffen verwendet werden
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 world bietet ein Standard-Asset Pack, das bereits im Basisspiel enthalten ist. Please refer to the Default Asset Pack page for more information.

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