packet

package main

import (
	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

func main() {
	var data []pk.String

	var p pk.Packet // = conn.ReadPacket()
	if err := p.Scan(
		pk.Ary[pk.VarInt]{ // then decode Ary according to length
			Ary: &data,
		},
	); err != nil {
		panic(err)
	}
}

Output:

package main

import (
	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

func main() {
	data := []pk.Int{0, 1, 2, 3, 4, 5, 6}
	// Len is completely ignored by WriteTo method.
	// The length is inferred from the length of Ary.
	pk.Marshal(
		0x00,
		pk.Ary[pk.VarInt]{
			Ary: data,
		},
	)
}

Output:

package main

import (
	"fmt"

	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

func main() {
	var has pk.Boolean

	var data pk.String
	p1 := pk.Packet{Data: []byte{
		0x01,                  // pk.Boolean(true)
		4, 'T', 'n', 'z', 'e', // pk.String
	}}
	if err := p1.Scan(
		&has,
		pk.Opt{
			Has: &has, Field: &data,
		},
	); err != nil {
		panic(err)
	}
	fmt.Println(data)

	var data2 pk.String = "WILL NOT BE READ, WILL NOT BE COVERED"
	p2 := pk.Packet{Data: []byte{
		0x00, // pk.Boolean(false)
		// empty
	}}
	if err := p2.Scan(
		&has,
		pk.Opt{Has: &has, Field: &data2},
	); err != nil {
		panic(err)
	}
	fmt.Println(data2)

}

Output:

Tnze
WILL NOT BE READ, WILL NOT BE COVERED

As an example, we define this packet as this: +------+-----------------+----------------------------------+ | Name | Type | Notes | +------+-----------------+----------------------------------+ | Flag | Unsigned Byte | Odd if the following is present. | +------+-----------------+----------------------------------+ | User | Optional String | The player's name. | +------+-----------------+----------------------------------+ So we need a function to decide if the User field is present.

package main

import (
	"fmt"

	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

func main() {
	var flag pk.Byte
	var data pk.String
	p := pk.Packet{Data: []byte{
		0b_0010_0011,          // pk.Byte(flag)
		4, 'T', 'n', 'z', 'e', // pk.String
	}}
	if err := p.Scan(
		&flag,
		pk.Opt{
			Has: func() bool {
				return flag&1 != 0
			},
			Field: &data,
		},
	); err != nil {
		panic(err)
	}
	fmt.Println(data)

}

Output:

Tnze

As an example, we define this packet as this: +------+-----------------+-----------------------------------+ | Name | Type | Notes | +------+-----------------+-----------------------------------+ | Has | Boolean | True if the following is present. | +------+-----------------+-----------------------------------+ | User | Optional String | The player's name. | +------+-----------------+-----------------------------------+ So we need a function to decide if the User field is present.

package main

import (
	"fmt"

	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

func main() {
	p1 := pk.Packet{Data: []byte{
		0x01,                  // pk.Boolean(true)
		4, 'T', 'n', 'z', 'e', // pk.String("Tnze")
	}}
	p2 := pk.Packet{Data: []byte{
		0x00, // pk.Boolean(false)
		// empty
	}}

	var User1, User2 pk.Option[pk.String, *pk.String]
	if err := p1.Scan(&User1); err != nil {
		panic(err)
	}
	if err := p2.Scan(&User2); err != nil {
		panic(err)
	}

	fmt.Println(User1.Has, User1.Val)
	fmt.Println(User2.Has, User2.Val)

}

Output:

true Tnze
false

package main

import (
	"fmt"

	_ "embed"
	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

//go:embed joingame_test.bin
var testJoinGameData []byte

func main() {
	p := pk.Packet{ID: 0x24, Data: testJoinGameData}
	var (
		EID            pk.Int
		Hardcore       pk.Boolean
		Gamemode       pk.UnsignedByte
		PreGamemode    pk.Byte
		WorldNames     = []pk.Identifier{} // This cannot replace with "var DimensionNames []pk.Identifier" because "nil" has no type information
		DimensionCodec struct {
			DimensionType any `nbt:"minecraft:dimension_type"`
			WorldgenBiome any `nbt:"minecraft:worldgen/biome"`
		}
		Dimension                 any
		WorldName                 pk.Identifier
		HashedSeed                pk.Long
		MaxPlayers                pk.VarInt
		ViewDistance              pk.VarInt
		RDI, ERS, IsDebug, IsFlat pk.Boolean
	)
	err := p.Scan(
		&EID,
		&Hardcore,
		&Gamemode,
		&PreGamemode,
		pk.Array(&WorldNames),
		pk.NBT(&DimensionCodec),
		pk.NBT(&Dimension),
		&WorldName,
		&HashedSeed,
		&MaxPlayers,
		&ViewDistance,
		&RDI, &ERS, &IsDebug, &IsFlat,
	)
	fmt.Print(err)
}

Output:

<nil>

package main

import (
	pk "github.com/maxsupermanhd/go-vmc/v764/net/packet"
)

func main() {
	// When you need to read an "Optional Array of X":
	var has pk.Boolean
	var ary []pk.String

	var p pk.Packet // = conn.ReadPacket()
	if err := p.Scan(
		&has,
		pk.Opt{
			Has: &has,
			Field: pk.Tuple{
				pk.Ary[pk.Int]{Ary: &ary},
			},
		},
	); err != nil {
		panic(err)
	}
}

Output: