1.21.8 data

bot/basic/basic.go

@@ -0,0 +1,91 @@
+// Package basic provides some basic packet handler which client needs.
+//
+// # [Player]
+//
+// The [Player] is attached to a [Client] by calling [NewPlayer] before the client joins a server.
+//
+// There is 4 kinds of clientbound packet is handled by this package.
+//   - LoginPacket, for cache player info. The player info will be stored in [Player.PlayerInfo].
+//   - KeepAlivePacket, for avoid the client to be kicked by the server.
+//   - PlayerPosition, is only received when server teleporting the player.
+//   - Respawn, for updating player info, which may change when player respawned.
+//
+// # [EventsListener]
+//
+// Handles some basic event you probably need.
+//   - GameStart
+//   - Disconnect
+//   - HealthChange
+//   - Death
+package basic
+
+import (
+	"github.com/Tnze/go-mc/bot"
+	"github.com/Tnze/go-mc/data/packetid"
+	pk "github.com/Tnze/go-mc/net/packet"
+)
+
+type Player struct {
+	c        *bot.Client
+	Settings Settings
+
+	PlayerInfo
+	WorldInfo
+}
+
+// NewPlayer create a new Player manager.
+func NewPlayer(c *bot.Client, settings Settings, events EventsListener) *Player {
+	p := &Player{c: c, Settings: settings}
+	c.Events.AddListener(
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundLogin, F: p.handleLoginPacket},
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundKeepAlive, F: p.handleKeepAlivePacket},
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundRespawn, F: p.handleRespawnPacket},
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundPing, F: p.handlePingPacket},
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundCookieRequest, F: p.handleCookieRequestPacket},
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundStoreCookie, F: p.handleStoreCookiePacket},
+		bot.PacketHandler{Priority: 0, ID: packetid.ClientboundUpdateTags, F: p.handleUpdateTags},
+	)
+	events.attach(p)
+	return p
+}
+
+// Respawn is used to send a respawn packet to the server.
+// Typically, you should call this method when the player is dead (in the [Death] event handler).
+func (p *Player) Respawn() error {
+	const PerformRespawn = 0
+
+	err := p.c.Conn.WritePacket(pk.Marshal(
+		packetid.ServerboundClientCommand,
+		pk.VarInt(PerformRespawn),
+	))
+	if err != nil {
+		return Error{err}
+	}
+
+	return nil
+}
+
+// AcceptTeleportation is used to send a teleport confirmation packet to the server.
+// Typically, you should call this method when received a ClientboundPlayerPosition packet (in the [Teleported] event handler).
+func (p *Player) AcceptTeleportation(teleportID pk.VarInt) error {
+	err := p.c.Conn.WritePacket(pk.Marshal(
+		packetid.ServerboundAcceptTeleportation,
+		teleportID,
+	))
+	if err != nil {
+		return Error{err}
+	}
+	return nil
+}
+
+type Error struct {
+	Err error
+}
+
+func (e Error) Error() string {
+	return "bot/basic: " + e.Err.Error()
+}
+
+func (e Error) Unwrap() error {
+	return e.Err
+}