Игровые handles | Pulse Documentation

Игроки и сессии

Для изменений игрового состояния используйте ctx.Gameplay(). Игрока можно найти по имени, ID, XUID, UUID или данным активной сессии.

players.go

playerHandle, ok := ctx.Gameplay().Players().ByName("Steve")if !ok {	return fmt.Errorf("player not found")}target, ok := ctx.Gameplay().Players().Resolve("Steve") // ID, name, XUID, or UUID_ = target_ = ok_, err := playerHandle.Inventory().Give(item.New("diamond_sword").	Enchant(item.Sharpness(5)).	NameTag("Arena Blade").	Stack())worldHandle, ok := ctx.Gameplay().Worlds().ByName("Hub")if !ok {	return fmt.Errorf("world not found")}container := worldHandle.ContainerAt(world.Pos{X: 10, Y: 64, Z: 10}, 27)_, err = container.Give(item.New("diamond").Count(8).Stack())

Инвентарь

PlayerHandle.Inventory() открывает операции с инвентарем игрока. Изменения проходят через сервер и синхронизируются с Bedrock-клиентом.

inventory.go

inv := playerHandle.Inventory()_, err := inv.Give(item.New("diamond_sword").	Enchant(item.Sharpness(5)).	NameTag("Arena Blade").	Lore("Bound to the arena").	Stack())_, err = inv.Move(0, 1, 1)_, err = inv.Swap(1, 2)err = inv.SetHeldSlot(1)err = inv.Resync()

Миры и сущности

WorldHandle покрывает установку и разрушение блоков, поиск ближайших игроков, запрос сущностей, работу с контейнерами и создание мобов.

world-entities.go

worldHandle, ok := ctx.Gameplay().Worlds().ByName("Hub")if !ok {	return fmt.Errorf("world not found")}pos := world.Pos{X: 10, Y: 64, Z: 10}err := worldHandle.SetBlock(pos, block.New("chest").String("minecraft:cardinal_direction", "north").Block())placed, err := playerHandle.PlaceBlock(pos, block.New("stone").Block())broken, err := worldHandle.BreakBlock(playerHandle.ID(), pos, item.New("diamond_pickaxe").Stack())nearby := worldHandle.NearestPlayers(entity.Position{X: 10, Y: 64, Z: 10}, 16, 5)zombies := worldHandle.EntitiesByType("minecraft:zombie")container := worldHandle.ContainerAt(pos, 27)_, err = container.Give(item.New("diamond").Count(8).Stack())err = container.OpenFor(playerHandle.ID())err = container.Resync()_ = placed_ = broken_ = nearby_ = zombiesmob, err := worldHandle.SpawnMob(entity.Zombie().At(12, 65, 10).Health(20))err = mob.SetNameTag("Training Zombie")_, err = mob.AddEffect(effect.New("strength").Seconds(10))err = mob.Damage(1, "training")

EntityHandle также дает Teleport, SetTransform, SetProperty, RemoveEffect, ClearEffects и Despawn.

Motion And Network

SetMotion и Knockback меняют server-owned velocity сущности и синхронизируют metadata. Отдельный custom Player subclass для этого не нужен.

motion-network.go

motion, ok := playerHandle.Motion()_ = motion_ = okerr := playerHandle.SetMotion(entity.Motion{X: 0.2, Y: 0.42, Z: 0})_, err = playerHandle.Knockback(entity.Position{X: 0, Y: 64, Z: 0}, 0.4, 0.36)network, ok := playerHandle.Network()locale, _ := playerHandle.Locale()device, _ := playerHandle.Device()skinProfile, _ := playerHandle.SkinProfile()skin, err := playerHandle.Skin()_, err = playerHandle.SetSkin(skin)_ = network_ = ok_ = locale_ = device_ = skinProfile_ = skin

SkinProfile() возвращает lightweight skin summary. Skin() возвращает cloned server-owned skin snapshot. SetSkin() сохраняет новый skin в ядре и рассылает typed play.player_skin runtime message зрителям, поэтому plugin не должен строить raw PlayerSkin packets.

Kits And Scoreboards

Armor, offhand, cursor и crafting handles — это именованные server-side containers. ClearAllInventories чистит поддержанные контейнеры и запрашивает resync.

kits-scoreboards.go

err := playerHandle.ClearAllInventories()err = playerHandle.Armor().Set(0, item.New("diamond_helmet").Stack())err = playerHandle.Offhand().Set(0, item.New("shield").Stack())err = playerHandle.Cursor().Clear()board := playerHandle.Scoreboard()err = board.SetTitle("Duel")err = board.SetLines("Map: nodebuff", "Ping: 20ms")err = board.SetLine(1, "Ping: 18ms")err = board.Remove()

Nearby Queries And World Effects

WorldHandle умеет искать ближайшие сущности и игроков, а также отправлять sounds, particles и level events через серверные эффекты.

world-effects.go

entities := worldHandle.NearbyEntities(entity.Position{X: 0, Y: 64, Z: 0}, 12, 10)players := worldHandle.PlayersNear(entity.Position{X: 0, Y: 64, Z: 0}, 12, 5)err := worldHandle.AddSound(entity.Position{X: 0, Y: 64, Z: 0}, gameplay.SoundEffect{Type: 1})err = worldHandle.AddParticle(entity.Position{X: 0, Y: 64, Z: 0}, gameplay.ParticleEffect{Type: 2001})err = worldHandle.LevelEvent(entity.Position{X: 0, Y: 64, Z: 0}, gameplay.LevelEvent{Type: 2001})_ = entities_ = players

Items, Projectiles, And Templates

Projectile item specs описывают force, cooldown, projectile type и hit hook metadata. Template copy асинхронно готовит arena instances; dynamic world registration остается под контролем сервера.

projectiles-templates.go

err := ctx.Items().Alias("mace", "minecraft:stick")ctx.Items().SetCooldown(playerHandle.ID(), "pearl", 20)ready := ctx.Items().Ready(playerHandle.ID(), "pearl")_ = readyspec := content.DefineProjectileItem("practice:fireball").	MaxCount(16).	Cooldown(20).	ThrowForce(1.5).	Projectile("practice:fireball_projectile").	Spec()_, err = ctx.RegisterItem(spec)ctx.WorldTemplates().Copy(ctx, plugin.WorldTemplateCopyRequest{	TemplatePath: "worlds/templates/duel",	TargetPath:   "worlds/arenas/duel-1",	WorldID:      "duel-1",}, func(result plugin.WorldTemplateResult) {	if result.Err != nil {		ctx.Logger().Warn("arena copy failed", "err", result.Err)	}})