entity

package
v0.1.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 17, 2018 License: Apache-2.0 Imports: 23 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Call added in v0.1.3

func Call(id common.EntityID, method string, args []interface{})

func CallNilSpaces added in v0.1.3

func CallNilSpaces(method string, args []interface{}, gameid uint16)

func CollectEntitySyncInfos

func CollectEntitySyncInfos()

CollectEntitySyncInfos is called by game service to collect and broadcast entity sync infos to all clients

func CreateEntityAnywhere

func CreateEntityAnywhere(typeName string) common.EntityID

CreateEntityAnywhere creates new entity in any game

func CreateSpaceAnywhere

func CreateSpaceAnywhere(kind int) common.EntityID

CreateSpaceAnywhere creates a space in any game server

func GetNilSpaceID added in v0.1.4

func GetNilSpaceID(gameid uint16) common.EntityID

GetNilSpaceEntityID returns the EntityID for Nil Space on the specified game GoWorld uses fixed EntityID for nil spaces on each game

func LoadEntityAnywhere

func LoadEntityAnywhere(typeName string, entityID common.EntityID)

LoadEntityAnywhere loads entity in the any game

LoadEntityAnywhere has no effect if entity already exists on any game

func LoadEntityOnGame added in v0.1.4

func LoadEntityOnGame(typeName string, entityID common.EntityID, gameid uint16)

LoadEntityOnGame

func OnAllGamesConnected added in v0.1.3

func OnAllGamesConnected()

OnAllGamesConnected is called when all games are connected to dispatcher cluster

func OnCall

func OnCall(id common.EntityID, method string, args [][]byte, clientID common.ClientID)

OnCall is called by engine when method call reaches in the game

func OnCallNilSpaces added in v0.1.3

func OnCallNilSpaces(method string, args [][]byte)

func OnClientDisconnected

func OnClientDisconnected(clientid common.ClientID)

OnClientDisconnected is called by engine when Client is disconnected

func OnCreateEntityAnywhere added in v0.1.2

func OnCreateEntityAnywhere(entityid common.EntityID, typeName string, data map[string]interface{})

OnCreateEntityAnywhere is called when CreateEntityAnywhere chooses this game

func OnGameTerminating

func OnGameTerminating()

OnGameTerminating is called when game is terminating

func OnGateDisconnected

func OnGateDisconnected(gateid uint16)

OnGateDisconnected is called when gate is down

func OnLoadEntitySomewhere added in v0.1.4

func OnLoadEntitySomewhere(typeName string, entityID common.EntityID)

OnLoadEntitySomewhere loads entity in the local game.

func OnMigrateRequestAck

func OnMigrateRequestAck(entityid common.EntityID, spaceid common.EntityID, spaceGameID uint16)

OnMigrateRequestAck is called by engine when mgirate request Ack is received

func OnQuerySpaceGameIDForMigrateAck added in v0.1.2

func OnQuerySpaceGameIDForMigrateAck(entityid common.EntityID, spaceid common.EntityID, spaceGameID uint16)

OnQuerySpaceGameIDForMigrateAck is called by engine when query entity gameid ACK is received

func OnRealMigrate

func OnRealMigrate(entityid common.EntityID, data []byte)

OnRealMigrate is used by entity migration

func OnSyncPositionYawFromClient

func OnSyncPositionYawFromClient(eid common.EntityID, x, y, z Coord, yaw Yaw)

OnSyncPositionYawFromClient is called by engine to sync entity infos from Client

func RegisterSpace

func RegisterSpace(spacePtr ISpace)

RegisterSpace registers the user custom space type

func RestoreFreezedEntities

func RestoreFreezedEntities(freeze *FreezeData) (err error)

RestoreFreezedEntities restore entity system from freeze data

func SaveAllEntities

func SaveAllEntities()

SaveAllEntities saves all entities

func SetSaveInterval

func SetSaveInterval(duration time.Duration)

SetSaveInterval sets the save interval for entity system

func TraverseEntityByType added in v0.1.4

func TraverseEntityByType(etype string, cb func(e *Entity))

TraverseEntityByType traverses entities of the specified type

Types

type Coord

type Coord float32

Coord is the of coordinations entity position (x, y, z)

type Entity

type Entity struct {
	ID       common.EntityID
	TypeName string
	I        IEntity
	V        reflect.Value

	Space     *Space
	Position  Vector3
	Neighbors EntitySet

	Attrs *MapAttr
	// contains filtered or unexported fields
}

Entity is the basic execution unit in GoWorld server. Entities can be used to represent players, NPCs, monsters. Entities can migrate among spaces.

func CreateEntityLocally

func CreateEntityLocally(typeName string, data map[string]interface{}) *Entity

CreateEntityLocally creates new entity in the local game

func GetEntity

func GetEntity(id common.EntityID) *Entity

GetEntity returns the entity with specified ID

func (*Entity) AddCallback

func (e *Entity) AddCallback(d time.Duration, method string, args ...interface{}) EntityTimerID

AddCallback adds a one-time callback for the entity

The callback will be cancelled if entity is destroyed

func (*Entity) AddTimer

func (e *Entity) AddTimer(d time.Duration, method string, args ...interface{}) EntityTimerID

AddTimer adds a repeat timer for the entity

The callback will be cancelled if entity is destroyed

func (*Entity) AsSpace added in v0.1.4

func (e *Entity) AsSpace() *Space

AsSpace converts entity to space (only works for space entity)

func (*Entity) Call

func (e *Entity) Call(id common.EntityID, method string, args ...interface{})

Call other entities

func (*Entity) CallAllClients

func (e *Entity) CallAllClients(method string, args ...interface{})

CallAllClients calls the entity method on all clients

func (*Entity) CallClient

func (e *Entity) CallClient(method string, args ...interface{})

CallClient calls the Client entity

func (*Entity) CallFilteredClients added in v0.1.3

func (e *Entity) CallFilteredClients(key, op, val string, method string, args ...interface{})

CallFilteredClients calls the filtered clients with prop key == value supported op includes "=", "!=", "<", "<=", ">", ">=" if key = "", all clients are called despite the value of op and val

The message is broadcast to filtered clientproxies directly without going through entities, and therefore more efficient

func (*Entity) CancelTimer

func (e *Entity) CancelTimer(tid EntityTimerID)

CancelTimer cancels the Callback / Timer

func (*Entity) Destroy

func (e *Entity) Destroy()

Destroy destroys the entity

func (*Entity) DistanceTo

func (e *Entity) DistanceTo(other *Entity) Coord

DistanceTo calculates the distance between two entities

func (*Entity) EnterSpace

func (e *Entity) EnterSpace(spaceid common.EntityID, pos Vector3)

EnterSpace let the entity enters space

func (*Entity) FaceTo

func (e *Entity) FaceTo(other *Entity)

FaceTo let entity face to another entity by setting Yaw accordingly

func (*Entity) FaceToPos

func (e *Entity) FaceToPos(pos Vector3)

func (*Entity) ForAllClients

func (e *Entity) ForAllClients(f func(client *GameClient))

ForAllClients visits all clients (own Client and clients of neighbors)

func (*Entity) GetBool added in v0.1.4

func (e *Entity) GetBool(key string) bool

GetBool gets an outtermost attribute as int

func (*Entity) GetClient

func (e *Entity) GetClient() *GameClient

GetClient returns the Client of entity

func (*Entity) GetFloat

func (e *Entity) GetFloat(key string) float64

GetFloat gets an outtermost attribute as float64

func (*Entity) GetInt

func (e *Entity) GetInt(key string) int64

GetInt gets an outtermost attribute as int

func (*Entity) GetListAttr

func (e *Entity) GetListAttr(key string) *ListAttr

GetListAttr gets an outtermost attribute as ListAttr

func (*Entity) GetMapAttr

func (e *Entity) GetMapAttr(key string) *MapAttr

GetMapAttr gets an outtermost attribute as MapAttr

func (*Entity) GetMigrateData

func (e *Entity) GetMigrateData(spaceid common.EntityID) *entityMigrateData

GetMigrateData gets the migration data

func (*Entity) GetPosition

func (e *Entity) GetPosition() Vector3

GetPosition returns the entity position

func (*Entity) GetStr

func (e *Entity) GetStr(key string) string

GetStr gets an outtermost attribute as string

func (*Entity) GetYaw

func (e *Entity) GetYaw() Yaw

GetYaw gets entity Yaw

func (*Entity) GiveClientTo

func (e *Entity) GiveClientTo(other *Entity)

GiveClientTo gives Client to other entity

func (*Entity) IsDestroyed

func (e *Entity) IsDestroyed() bool

IsDestroyed returns if the entity is destroyed

func (*Entity) IsNeighbor

func (e *Entity) IsNeighbor(other *Entity) bool

IsNeighbor checks if other entity is a neighbor

func (*Entity) IsPersistent

func (e *Entity) IsPersistent() bool

IsPersistent returns if the entity is persistent

Default implementation check entity for persistent attributes

func (*Entity) IsSpaceEntity

func (e *Entity) IsSpaceEntity() bool

IsSpaceEntity returns if the entity is actually a space

func (*Entity) IsUseAOI

func (e *Entity) IsUseAOI() bool

IsUseAOI returns if entity type is using aoi

Entities like Account, Service entities should not be using aoi

func (*Entity) OnAttrsReady added in v0.1.3

func (e *Entity) OnAttrsReady()

OnAttrsReady is called when entity's attribute is ready

Can override this function in custom entity type

func (*Entity) OnClientConnected

func (e *Entity) OnClientConnected()

OnClientConnected is called when Client is connected

Can override this function in custom entity type

func (*Entity) OnClientDisconnected

func (e *Entity) OnClientDisconnected()

OnClientDisconnected is called when Client is disconnected

Can override this function in custom entity type

func (*Entity) OnCreated

func (e *Entity) OnCreated()

OnCreated is called when entity is created

Can override this function in custom entity type

func (*Entity) OnDestroy

func (e *Entity) OnDestroy()

OnDestroy is called when entity is destroying

Can override this function in custom entity type

func (*Entity) OnEnterAOI added in v0.1.1

func (e *Entity) OnEnterAOI(otherAoi *aoi.AOI)

func (*Entity) OnEnterSpace

func (e *Entity) OnEnterSpace()

OnEnterSpace is called when entity enters space

Can override this function in custom entity type

func (*Entity) OnFreeze

func (e *Entity) OnFreeze()

OnFreeze is called when entity is freezed

Can override this function in custom entity type

func (*Entity) OnInit

func (e *Entity) OnInit()

OnInit is called when entity is initializing

Can override this function in custom entity type

func (*Entity) OnLeaveAOI added in v0.1.1

func (e *Entity) OnLeaveAOI(otherAoi *aoi.AOI)

func (*Entity) OnLeaveSpace

func (e *Entity) OnLeaveSpace(space *Space)

OnLeaveSpace is called when entity leaves space

Can override this function in custom entity type

func (*Entity) OnMigrateIn

func (e *Entity) OnMigrateIn()

OnMigrateIn is called when entity is migrating in

Can override this function in custom entity type

func (*Entity) OnMigrateOut

func (e *Entity) OnMigrateOut()

OnMigrateOut is called when entity is migrating out

Can override this function in custom entity type

func (*Entity) OnRestored

func (e *Entity) OnRestored()

OnRestored is called when entity is restored

Can override this function in custom entity type

func (*Entity) PanicOnError

func (e *Entity) PanicOnError(err error)

PanicOnError panics if err != nil

func (*Entity) Post

func (e *Entity) Post(cb func())

Post a function which will be executed immediately but not in the current stack frames

func (*Entity) Save

func (e *Entity) Save()

Save the entity

func (*Entity) SetClient

func (e *Entity) SetClient(client *GameClient)

SetClient sets the Client of entity

func (*Entity) SetClientFilterProp added in v0.1.4

func (e *Entity) SetClientFilterProp(key string, val string)

SetClientFilterProp sets a filter property key-value

func (*Entity) SetClientSyncing

func (e *Entity) SetClientSyncing(syncing bool)

SetClientSyncing set if entity infos (position, Yaw) is syncing with Client

func (*Entity) SetPosition

func (e *Entity) SetPosition(pos Vector3)

SetPosition sets the entity position

func (*Entity) SetYaw

func (e *Entity) SetYaw(yaw Yaw)

SetYaw sets entity Yaw

func (*Entity) String

func (e *Entity) String() string

type EntityMap

type EntityMap map[common.EntityID]*Entity

EntityMap is the data structure for maintaining entity IDs to entities

func Entities

func Entities() EntityMap

Entities gets all entities

Never modify the return value !

func GetEntitiesByType added in v0.1.4

func GetEntitiesByType(etype string) EntityMap

func (EntityMap) Add

func (em EntityMap) Add(entity *Entity)

Add adds a new entity to EntityMap

func (EntityMap) Del

func (em EntityMap) Del(id common.EntityID)

Del deletes an entity from EntityMap

func (EntityMap) Get

func (em EntityMap) Get(id common.EntityID) *Entity

Get returns the Entity of specified entity ID in EntityMap

func (EntityMap) Keys added in v0.1.4

func (em EntityMap) Keys() (keys []common.EntityID)

Keys return keys of the EntityMap in a slice

func (EntityMap) Values added in v0.1.4

func (em EntityMap) Values() (vals []*Entity)

Values return values of the EntityMap in a slice

type EntitySet

type EntitySet map[*Entity]struct{}

EntitySet is the data structure for a set of entities

func (EntitySet) Add

func (es EntitySet) Add(entity *Entity)

Add adds an entity to the EntitySet

func (EntitySet) Contains

func (es EntitySet) Contains(entity *Entity) bool

Contains returns if the entity is in the EntitySet

func (EntitySet) Del

func (es EntitySet) Del(entity *Entity)

Del deletes an entity from the EntitySet

func (EntitySet) String

func (es EntitySet) String() string

type EntityTimerID

type EntityTimerID int

EntityTimerID is the type of entity timer ID

func (EntityTimerID) IsValid

func (tid EntityTimerID) IsValid() bool

IsValid returns if the EntityTimerID is still valid (not fired and not cancelled)

type EntityTypeDesc

type EntityTypeDesc struct {
	IsPersistent bool
	// contains filtered or unexported fields
}

EntityTypeDesc is the entity type description for registering entity types

func GetEntityTypeDesc added in v0.1.4

func GetEntityTypeDesc(typeName string) *EntityTypeDesc

func RegisterEntity

func RegisterEntity(typeName string, entity IEntity, isService bool) *EntityTypeDesc

RegisterEntity registers custom entity type and define entity behaviors

func (*EntityTypeDesc) DefineAttr added in v0.1.1

func (desc *EntityTypeDesc) DefineAttr(attr string, defs ...string) *EntityTypeDesc

func (*EntityTypeDesc) SetPersistent added in v0.1.3

func (desc *EntityTypeDesc) SetPersistent(persistent bool) *EntityTypeDesc

func (*EntityTypeDesc) SetUseAOI added in v0.1.3

func (desc *EntityTypeDesc) SetUseAOI(useAOI bool) *EntityTypeDesc

type FreezeData

type FreezeData struct {
	Entities map[common.EntityID]*entityMigrateData
}

FreezeData is the data structure for storing entity freeze data

func Freeze

func Freeze(gameid uint16) (*FreezeData, error)

Freeze freezes the entity system and returns all freeze data

type GameClient

type GameClient struct {
	// contains filtered or unexported fields
}

GameClient represents the game Client of entity

Each entity can have at most one GameClient, and GameClient can be given to other entities

func MakeGameClient

func MakeGameClient(clientid common.ClientID, gateid uint16) *GameClient

MakeGameClient creates a GameClient object using Client ID and Game ID

func (*GameClient) String

func (client *GameClient) String() string

type IEntity added in v0.1.1

type IEntity interface {
	// Entity Lifetime
	OnInit()       // Called when initializing entity struct, override to initialize entity custom fields
	OnAttrsReady() // Called when entity attributes are ready.
	OnCreated()    // Called when entity is just created
	OnDestroy()    // Called when entity is destroying (just before destroy)
	// Migration
	OnMigrateOut() // Called just before entity is migrating out
	OnMigrateIn()  // Called just after entity is migrating in
	// Freeze && Restore
	OnFreeze()   // Called when entity is freezing
	OnRestored() // Called when entity is restored
	// Space Operations
	OnEnterSpace()             // Called when entity leaves space
	OnLeaveSpace(space *Space) // Called when entity enters space
	// Client Notifications
	OnClientConnected()    // Called when Client is connected to entity (become player)
	OnClientDisconnected() // Called when Client disconnected

	DescribeEntityType(desc *EntityTypeDesc) // Define entity attributes in this function
}

IEntity declares functions that is defined in Entity These functions are mostly component functions

type ISpace added in v0.1.1

type ISpace interface {
	IEntity

	OnSpaceInit()    // Called when initializing space struct, override to initialize custom space fields
	OnSpaceCreated() // Called when space is created
	OnSpaceDestroy() // Called just before space is destroyed
	// Space Operations
	OnEntityEnterSpace(entity *Entity) // Called when any entity enters space
	OnEntityLeaveSpace(entity *Entity) // Called when any entity leaves space
	// Game releated callbacks on nil space only
	OnGameReady()
}

ISpace is the space delegate interface

User custom space class can override these functions for their own game logic

type ListAttr

type ListAttr struct {
	// contains filtered or unexported fields
}

ListAttr is a attribute for a list of attributes

func NewListAttr

func NewListAttr() *ListAttr

NewListAttr creates a new ListAttr

func (*ListAttr) AppendBool

func (a *ListAttr) AppendBool(v bool)

AppendBool puts bool value to the end of list

func (*ListAttr) AppendFloat

func (a *ListAttr) AppendFloat(v float64)

AppendFloat puts float value to the end of list

func (*ListAttr) AppendInt

func (a *ListAttr) AppendInt(v int64)

AppendInt puts int value to the end of list

func (*ListAttr) AppendListAttr

func (a *ListAttr) AppendListAttr(attr *ListAttr)

AppendListAttr puts ListAttr value to the end of list

func (*ListAttr) AppendMapAttr

func (a *ListAttr) AppendMapAttr(attr *MapAttr)

AppendMapAttr puts MapAttr value to the end of list

func (*ListAttr) AppendStr

func (a *ListAttr) AppendStr(v string)

AppendStr puts string value to the end of list

func (*ListAttr) AssignList

func (a *ListAttr) AssignList(l []interface{})

AssignList assigns slice to ListAttr, recursively

func (*ListAttr) GetBool

func (a *ListAttr) GetBool(index int) bool

GetBool gets item value as bool

func (*ListAttr) GetFloat

func (a *ListAttr) GetFloat(index int) float64

GetFloat gets item value as float64

func (*ListAttr) GetInt

func (a *ListAttr) GetInt(index int) int64

GetInt gets item value as int

func (*ListAttr) GetListAttr

func (a *ListAttr) GetListAttr(index int) *ListAttr

GetListAttr gets item value as ListAttr

func (*ListAttr) GetMapAttr

func (a *ListAttr) GetMapAttr(index int) *MapAttr

GetMapAttr gets item value as MapAttr

func (*ListAttr) GetStr

func (a *ListAttr) GetStr(index int) string

GetStr gets item value as string

func (*ListAttr) PopBool

func (a *ListAttr) PopBool() bool

func (*ListAttr) PopFloat

func (a *ListAttr) PopFloat() float64

func (*ListAttr) PopInt

func (a *ListAttr) PopInt() int64

func (*ListAttr) PopListAttr

func (a *ListAttr) PopListAttr() *ListAttr

PopListAttr removes the last item and returns as ListAttr

func (*ListAttr) PopMapAttr

func (a *ListAttr) PopMapAttr() *MapAttr

PopMapAttr removes the last item and returns as MapAttr

func (*ListAttr) PopStr

func (a *ListAttr) PopStr() string

func (*ListAttr) SetBool

func (a *ListAttr) SetBool(index int, v bool)

SetBool sets bool value at the index

func (*ListAttr) SetFloat

func (a *ListAttr) SetFloat(index int, v float64)

SetFloat sets float value at the index

func (*ListAttr) SetInt

func (a *ListAttr) SetInt(index int, v int64)

SetInt sets int value at the index

func (*ListAttr) SetListAttr

func (a *ListAttr) SetListAttr(index int, attr *ListAttr)

SetListAttr sets ListAttr value at the index

func (*ListAttr) SetMapAttr

func (a *ListAttr) SetMapAttr(index int, attr *MapAttr)

SetMapAttr sets MapAttr value at the index

func (*ListAttr) SetStr

func (a *ListAttr) SetStr(index int, v string)

SetStr sets string value at the index

func (*ListAttr) Size

func (a *ListAttr) Size() int

Size returns size of ListAttr

func (*ListAttr) String added in v0.1.4

func (a *ListAttr) String() string

func (*ListAttr) ToList

func (a *ListAttr) ToList() []interface{}

ToList converts ListAttr to slice, recursively

type MapAttr

type MapAttr struct {
	// contains filtered or unexported fields
}

MapAttr is a map attribute containing muiltiple attributes indexed by string keys

func NewMapAttr

func NewMapAttr() *MapAttr

NewMapAttr creates a new MapAttr

func (*MapAttr) AssignMap

func (a *MapAttr) AssignMap(doc map[string]interface{})

AssignMap assigns native map to MapAttr recursively

func (*MapAttr) AssignMapWithFilter

func (a *MapAttr) AssignMapWithFilter(doc map[string]interface{}, filter func(string) bool)

AssignMapWithFilter assigns filtered fields of native map to MapAttr recursively

func (*MapAttr) Clear added in v0.1.4

func (a *MapAttr) Clear()

Clear removes all key-values from the MapAttr

func (*MapAttr) Del

func (a *MapAttr) Del(key string)

Del deletes a key in MapAttr

func (*MapAttr) ForEach

func (a *MapAttr) ForEach(f func(key string, val interface{}))

ForEach calls f on all items Be careful about the type of val

func (*MapAttr) ForEachKey

func (a *MapAttr) ForEachKey(f func(key string))

ForEachKey calls f on all keys

func (*MapAttr) GetBool

func (a *MapAttr) GetBool(key string) bool

GetBool returns the attribute of specified key in MapAttr as bool

func (*MapAttr) GetFloat

func (a *MapAttr) GetFloat(key string) float64

GetFloat returns the attribute of specified key in MapAttr as float64

func (*MapAttr) GetInt

func (a *MapAttr) GetInt(key string) int64

GetInt returns the attribute of specified key in MapAttr as int64

func (*MapAttr) GetListAttr

func (a *MapAttr) GetListAttr(key string) *ListAttr

GetListAttr returns the attribute of specified key in MapAttr as ListAttr

func (*MapAttr) GetMapAttr

func (a *MapAttr) GetMapAttr(key string) *MapAttr

GetMapAttr returns the attribute of specified key in MapAttr as MapAttr

func (*MapAttr) GetStr

func (a *MapAttr) GetStr(key string) string

GetStr returns the attribute of specified key in MapAttr as string

func (*MapAttr) HasKey

func (a *MapAttr) HasKey(key string) bool

HasKey returns if the key exists in MapAttr

func (*MapAttr) Keys

func (a *MapAttr) Keys() []string

Keys returns all keys of Attrs

func (*MapAttr) PopBool added in v0.1.4

func (a *MapAttr) PopBool(key string) bool

PopBool deletes a key in MapAttr and returns the attribute as bool

func (*MapAttr) PopFloat added in v0.1.4

func (a *MapAttr) PopFloat(key string) float64

PopFloat deletes a key in MapAttr and returns the attribute as float64

func (*MapAttr) PopInt added in v0.1.4

func (a *MapAttr) PopInt(key string) int64

PopInt deletes a key in MapAttr and returns the attribute as int64

func (*MapAttr) PopListAttr added in v0.1.4

func (a *MapAttr) PopListAttr(key string) *ListAttr

PopListAttr deletes a key in MapAttr and returns the attribute as MapAttr

func (*MapAttr) PopMapAttr

func (a *MapAttr) PopMapAttr(key string) *MapAttr

PopMapAttr deletes a key in MapAttr and returns the attribute as MapAttr

func (*MapAttr) PopStr added in v0.1.4

func (a *MapAttr) PopStr(key string) string

PopStr deletes a key in MapAttr and returns the attribute as str

func (*MapAttr) SetBool

func (a *MapAttr) SetBool(key string, v bool)

SetBool sets bool value at the key

func (*MapAttr) SetDefaultBool

func (a *MapAttr) SetDefaultBool(key string, v bool)

SetDefaultBool sets default bool value at the key

func (*MapAttr) SetDefaultFloat

func (a *MapAttr) SetDefaultFloat(key string, v float64)

SetDefaultFloat sets default float value at the key

func (*MapAttr) SetDefaultInt

func (a *MapAttr) SetDefaultInt(key string, v int64)

SetDefaultInt sets default int value at the key

func (*MapAttr) SetDefaultListAttr

func (a *MapAttr) SetDefaultListAttr(key string, attr *ListAttr)

SetDefaultListAttr sets default ListAttr value at the key

func (*MapAttr) SetDefaultMapAttr

func (a *MapAttr) SetDefaultMapAttr(key string, attr *MapAttr)

SetDefaultMapAttr sets default MapAttr value at the key

func (*MapAttr) SetDefaultStr

func (a *MapAttr) SetDefaultStr(key string, v string)

SetDefaultStr sets default string value at the key

func (*MapAttr) SetFloat

func (a *MapAttr) SetFloat(key string, v float64)

SetFloat sets float value at the key

func (*MapAttr) SetInt

func (a *MapAttr) SetInt(key string, v int64)

SetInt sets int value at the key

func (*MapAttr) SetListAttr

func (a *MapAttr) SetListAttr(key string, attr *ListAttr)

SetListAttr sets ListAttr value at the key

func (*MapAttr) SetMapAttr

func (a *MapAttr) SetMapAttr(key string, attr *MapAttr)

SetMapAttr sets MapAttr value at the key

func (*MapAttr) SetStr

func (a *MapAttr) SetStr(key string, v string)

SetStr sets string value at the key

func (*MapAttr) Size

func (a *MapAttr) Size() int

Size returns the size of MapAttr

func (*MapAttr) String added in v0.1.4

func (a *MapAttr) String() string

String convert MapAttr to readable string

func (*MapAttr) ToMap

func (a *MapAttr) ToMap() map[string]interface{}

ToMap converts MapAttr to native map, recursively

func (*MapAttr) ToMapWithFilter

func (a *MapAttr) ToMapWithFilter(filter func(string) bool) map[string]interface{}

ToMapWithFilter converts filtered fields of MapAttr to to native map, recursively

type Space

type Space struct {
	Entity

	Kind int
	I    ISpace
	// contains filtered or unexported fields
}

Space is the entity type of spaces

Spaces are also entities but with space management logics

func CreateNilSpace added in v0.1.3

func CreateNilSpace(gameid uint16) *Space

CreateNilSpace creates the nil space

func CreateSpaceLocally

func CreateSpaceLocally(kind int) *Space

CreateSpaceLocally creates a space in the local game server

func GetNilSpace added in v0.1.4

func GetNilSpace() *Space

func GetSpace added in v0.1.4

func GetSpace(id common.EntityID) *Space

func (*Space) CountEntities

func (space *Space) CountEntities(typeName string) int

CountEntities returns the number of entities of specified type in space

func (*Space) CreateEntity

func (space *Space) CreateEntity(typeName string, pos Vector3)

CreateEntity creates a new local entity in this space

func (*Space) DescribeEntityType added in v0.1.3

func (space *Space) DescribeEntityType(desc *EntityTypeDesc)

func (*Space) EnableAOI added in v0.1.4

func (space *Space) EnableAOI()

func (*Space) ForEachEntity

func (space *Space) ForEachEntity(f func(e *Entity))

ForEachEntity visits all entities in space and call function f with each entity

func (*Space) GetEntity

func (space *Space) GetEntity(entityID common.EntityID) *Entity

GetEntity returns the entity in space with specified ID, nil otherwise

func (*Space) GetEntityCount

func (space *Space) GetEntityCount() int

GetEntityCount returns the total count of entities in space

func (*Space) GetSpaceRange added in v0.1.1

func (space *Space) GetSpaceRange() (minX, minY, maxX, maxY Coord)

func (*Space) GetTowerRange added in v0.1.1

func (space *Space) GetTowerRange() (minX, minY, maxX, maxY Coord)

func (*Space) IsNil

func (space *Space) IsNil() bool

IsNil checks if the space is the nil space

func (*Space) LoadEntity

func (space *Space) LoadEntity(typeName string, entityID common.EntityID, pos Vector3)

LoadEntity loads a entity of specified entityID to the space

If the entity already exists on server, this call has no effect

func (*Space) OnCreated

func (space *Space) OnCreated()

OnCreated is called when Space entity is created

func (*Space) OnDestroy

func (space *Space) OnDestroy()

OnDestroy is called when Space entity is destroyed

func (*Space) OnEntityEnterSpace

func (space *Space) OnEntityEnterSpace(entity *Entity)

OnEntityEnterSpace is called when entity enters space

Custom space type can override this function

func (*Space) OnEntityLeaveSpace

func (space *Space) OnEntityLeaveSpace(entity *Entity)

OnEntityLeaveSpace is called when entity leaves space

Custom space type can override this function

func (*Space) OnGameReady added in v0.1.3

func (space *Space) OnGameReady()

OnGameReady is called when the game server is ready on NilSpace only

func (*Space) OnInit

func (space *Space) OnInit()

OnInit initialize Space entity

func (*Space) OnRestored

func (space *Space) OnRestored()

OnRestored is called when space entity is restored

func (*Space) OnSpaceCreated

func (space *Space) OnSpaceCreated()

OnSpaceCreated is called when space is created

Custom space type can override to provide custom logic

func (*Space) OnSpaceDestroy

func (space *Space) OnSpaceDestroy()

OnSpaceDestroy is called when space is destroying

Custom space type can override to provide custom logic

func (*Space) OnSpaceInit added in v0.1.1

func (space *Space) OnSpaceInit()

OnSpaceInit is a compositive method for initializing space fields

func (*Space) String

func (space *Space) String() string

type Vector3

type Vector3 struct {
	X Coord
	Y Coord
	Z Coord
}

Vector3 is type of entity position

func (Vector3) Add

func (p Vector3) Add(o Vector3) Vector3

func (Vector3) DirToYaw

func (dir Vector3) DirToYaw() Yaw

DirToYaw convert direction represented by Vector3 to Yaw

func (Vector3) DistanceTo

func (p Vector3) DistanceTo(o Vector3) Coord

DistanceTo calculates distance between two positions

func (Vector3) Mul

func (p Vector3) Mul(m Coord) Vector3

Mul calculates Vector3 p * m

func (*Vector3) Normalize

func (p *Vector3) Normalize()

func (Vector3) Normalized

func (p Vector3) Normalized() Vector3

func (Vector3) String

func (p Vector3) String() string

func (Vector3) Sub

func (p Vector3) Sub(o Vector3) Vector3

Sub calculates Vector3 p - Vector3 o

type Yaw

type Yaw float32

Yaw is the type of entity Yaw

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL