up3

2026-07-09 08:33:57 +08:00
commit 26ed99fda6
845 changed files with 75419 additions and 0 deletions
@@ -0,0 +1,127 @@
+package session
+
+import (
+	"github.com/df-mc/dragonfly/server/block/cube"
+	"github.com/df-mc/dragonfly/server/cmd"
+	"github.com/df-mc/dragonfly/server/entity/effect"
+	"github.com/df-mc/dragonfly/server/item"
+	"github.com/df-mc/dragonfly/server/item/inventory"
+	"github.com/df-mc/dragonfly/server/player/chat"
+	"github.com/df-mc/dragonfly/server/player/debug"
+	"github.com/df-mc/dragonfly/server/player/dialogue"
+	"github.com/df-mc/dragonfly/server/player/form"
+	"github.com/df-mc/dragonfly/server/player/hud"
+	"github.com/df-mc/dragonfly/server/player/skin"
+	"github.com/df-mc/dragonfly/server/world"
+	"github.com/go-gl/mathgl/mgl64"
+	"github.com/google/uuid"
+	"golang.org/x/text/language"
+)
+
+// Controllable represents an entity that may be controlled by a Session. Generally, Controllable is
+// implemented in the form of a Player.
+// Methods in Controllable will be added as Session needs them in order to handle packets.
+type Controllable interface {
+	Name() string
+	world.Entity
+	item.User
+	dialogue.Submitter
+	form.Submitter
+	cmd.Source
+	chat.Subscriber
+	hud.Renderer
+	debug.Renderer
+
+	Locale() language.Tag
+
+	SetHeldItems(right, left item.Stack)
+	SetHeldSlot(slot int) error
+
+	Move(deltaPos mgl64.Vec3, deltaYaw, deltaPitch float64)
+
+	Speed() float64
+	FlightSpeed() float64
+	VerticalFlightSpeed() float64
+
+	Sleep(pos cube.Pos)
+	Wake()
+
+	Chat(msg ...any)
+	ExecuteCommand(commandLine string)
+	GameMode() world.GameMode
+	SetGameMode(mode world.GameMode)
+	Effects() []effect.Effect
+
+	UseItem()
+	ReleaseItem()
+	UseItemOnBlock(pos cube.Pos, face cube.Face, clickPos mgl64.Vec3)
+	UseItemOnEntity(e world.Entity) bool
+	BreakBlock(pos cube.Pos)
+	PickBlock(pos cube.Pos)
+	AttackEntity(e world.Entity) bool
+	Drop(s item.Stack) (n int)
+	SwingArm()
+	PunchAir()
+
+	Health() float64
+	MaxHealth() float64
+	Absorption() float64
+	Food() int
+
+	ExperienceLevel() int
+	ExperienceProgress() float64
+	SetExperienceLevel(level int)
+
+	EnchantmentSeed() int64
+	ResetEnchantmentSeed()
+
+	Respawn() *world.EntityHandle
+	Dead() bool
+
+	StartSneaking()
+	Sneaking() bool
+	StopSneaking()
+	StartSprinting()
+	Sprinting() bool
+	StopSprinting()
+	StartSwimming()
+	Swimming() bool
+	StopSwimming()
+	StartCrawling()
+	Crawling() bool
+	StopCrawling()
+	StartFlying()
+	Flying() bool
+	StopFlying()
+	StartGliding()
+	Gliding() bool
+	StopGliding()
+	Jump()
+
+	StartBreaking(pos cube.Pos, face cube.Face)
+	ContinueBreaking(face cube.Face)
+	FinishBreaking()
+	AbortBreaking()
+
+	Exhaust(points float64)
+
+	OpenSign(pos cube.Pos, frontSide bool)
+	EditSign(pos cube.Pos, frontText, backText string) error
+	TurnLecternPage(pos cube.Pos, page int) error
+
+	EnderChestInventory() *inventory.Inventory
+	MoveItemsToInventory()
+
+	// UUID returns the UUID of the controllable. It must be unique for all controllable entities present in
+	// the server.
+	UUID() uuid.UUID
+	// XUID returns the XBOX Live User ID of the controllable. Every controllable must have one of these if
+	// they are authenticated via XBOX Live, as they must be connected to an XBOX Live account.
+	XUID() string
+	// Skin returns the skin of the controllable. Each controllable must have a skin, as it defines how the
+	// entity looks in the world.
+	Skin() skin.Skin
+	SetSkin(skin.Skin)
+
+	UpdateDiagnostics(Diagnostics)
+}