World

Now you have taken courage and set off into the big wide world.

The world is a great place, isn't it? Huge, beautiful and full of life. There is so much to discover, let's create one of our own.

The world stores all its entities, it contains methods to create, destroy and query them and handles all the internal mechanics. Therefore it is the most important class, you will use the world heavily. Time to play God.

The Big Bang

So how does it work with creating worlds? Well, easier than you think...

var world = World.Create();  // Creating a world full of life
world.TrimExcess();          // Frees unused memory
world.Dispose();             // Clearing the world like God in the First Testament
World.Destroy(world);        // Doomsday

Multiple worlds can be used in parallel, each instance and its entities are completely encapsulated from other worlds

Best of all, you can create any number of worlds with almost infinite entities. You rarely have so much life and freedom. To be precise,2,147,483,647 worlds with 2,147,483,647 entities each are possible.

Prerequisites for life

Now we have a world. A world with all the prerequisites for creating life, changing it and destroying it.

The world has the rudimentary methods on which everything in Arch is based. If you only want to work with them, this is possible and offers one less level of abstraction.

As an alternative, you can also work ONLY with the world. Without abstraction of entities and co. This principle is called PURE_ECS and will be looked at later. The following documentation refers further to the abstracted entity API.

Lifecycle Management

Creating and destroying Entities.

Structural Changes

Adding/Removing components on Entities

Modification

Accessing and modifying components on Entities.

Enumeration

Enumerating/Filtering/Matching Entities.

Bulk/Batch Operations

Executing operations on Entities in Bulk/Batches.

Lowlevel

Working with Archetypes, Chunks and Entities directly without any wrappers.

Multithreading

Acessing the JobScheduler to run querys or your own Jobs in parallel.

And much more...

Working with Events, the CommandBuffer or several other features directly!

We'll go into more detail later. But now enough talk, go on. Something is lurking behind the next bush.