Skip to main content

Documentation Index

Fetch the complete documentation index at: https://world.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Creating Entity

To create an entity, you need to call the Create method on your search.
system/create_player.go
package system

import (
	"fmt"

	"github.com/argus-labs/monorepo/pkg/cardinal"
	"github.com/argus-labs/monorepo/pkg/cardinal/examples/demo-game/component"
)

type CreatePlayerSystemState struct {
	cardinal.BaseSystemState
	Players PlayerSearch
}

func CreatePlayerSystem(state *CreatePlayerSystemState) error {
	for i := range 10 {
		name := fmt.Sprintf("default-%d", i)

		id, err := state.Players.Create(
			component.PlayerTag{Nickname: name},
			component.Position{X: 0, Y: 0},
		)
		if err != nil {
			return err
		}

		state.Logger().Info().Uint32("entity", uint32(id)).Msgf("Created player %s", name)
	}
	return nil
}
What’s PlayerSearch? Learn more in Searching for Entities with Components.

​
Destroying Entity

To destroy an entity, you need to call the Destroy method on the entity.
system/destroy_player.go
package system

import (
	"github.com/argus-labs/monorepo/pkg/cardinal"
)

type DestroyPlayerSystemState struct {
	cardinal.BaseSystemState
	Players PlayerSearch
}

func DestroyPlayerSystem(state *DestroyPlayerSystemState) error {
	for entity, player := range state.Players.Iter() {
		if player.Tag.Get().Nickname == "testing" {
			entity.Destroy()
		}
	}
	return nil
}