mcgo

README

MC GO

MC API requests implemented in go

It is planned to make a free & open source CLI for this, and a paid web UI and Discord Bot!

cli link: https://github.com/Kqzz/MCsniperGO

Documentation

Index

• func NameAvailability(username string) (string, error)
• func SameErrorMessage(err, target error) bool
• type AccType
• type Droptime
• type MCaccount
  • func (account *MCaccount) AuthenticatedReq(method string, url string, body io.Reader) (*http.Request, error)
  • func (account *MCaccount) ChangeName(username string, changeTime time.Time, createProfile bool) (NameChangeReturn, error)
  • func (account *MCaccount) ChangeSkinFromUrl(url, variant string) error
  • func (account *MCaccount) HasGcApplied() (bool, error)
  • func (account *MCaccount) InitAuthFlow() error
  • func (account *MCaccount) LoadAccountInfo() error
  • func (account *MCaccount) MicrosoftAuthenticate() error
  • func (account *MCaccount) MojangAuthenticate() error
  • func (account *MCaccount) NameChangeInfo() (nameChangeInfoResponse, error)
• type NameChangeReturn
• type RequestError
  • func (r *RequestError) Error() string
• type SqAnswer
• type XBLSignInResp

Functions

func NameAvailability

func NameAvailability(username string) (string, error)

func SameErrorMessage

func SameErrorMessage(err, target error) bool

https://stackoverflow.com/a/68240817/13312615

Types

type AccType

type AccType string

const (
	Ms   AccType = "ms"
	Mj   AccType = "mj"
	MsPr AccType = "mspr"
)

type Droptime

type Droptime struct {
	Droptime time.Time
	Username string
}

type MCaccount

type MCaccount struct {
	Email             string
	Password          string
	SecurityQuestions []SqAnswer
	SecurityAnswers   []string
	Bearer            string
	UUID              string
	Username          string
	Type              AccType
	Authenticated     bool
}

represents a minecraft account

func (*MCaccount) AuthenticatedReq

func (account *MCaccount) AuthenticatedReq(method string, url string, body io.Reader) (*http.Request, error)

func (*MCaccount) ChangeName

func (account *MCaccount) ChangeName(username string, changeTime time.Time, createProfile bool) (NameChangeReturn, error)

func (*MCaccount) ChangeSkinFromUrl

func (account *MCaccount) ChangeSkinFromUrl(url, variant string) error

func (*MCaccount) HasGcApplied

func (account *MCaccount) HasGcApplied() (bool, error)

func (*MCaccount) InitAuthFlow

func (account *MCaccount) InitAuthFlow() error

func (*MCaccount) LoadAccountInfo

func (account *MCaccount) LoadAccountInfo() error

load account information (username, uuid) into accounts attributes, if not already there. When using Mojang authentication it is not necessary to load this info, as it will be automatically loaded.

func (*MCaccount) MicrosoftAuthenticate

func (account *MCaccount) MicrosoftAuthenticate() error

func (*MCaccount) MojangAuthenticate

func (account *MCaccount) MojangAuthenticate() error

Runs all steps necessary to have a fully authenticated mojang account. It will submit email & pass and securitty questions (if necessary).

func (*MCaccount) NameChangeInfo

func (account *MCaccount) NameChangeInfo() (nameChangeInfoResponse, error)

grab information on the availability of name change for this account

type NameChangeReturn

type NameChangeReturn struct {
	Account     MCaccount
	Username    string
	ChangedName bool
	StatusCode  int
	SendTime    time.Time
	ReceiveTime time.Time
}

type RequestError

type RequestError struct {
	StatusCode int
	Err        error
}

TODO: Use RequestError for status-code-related errors

func (*RequestError) Error

func (r *RequestError) Error() string

type SqAnswer

type SqAnswer struct {
	Answer struct {
		ID int `json:"id"`
	} `json:"answer"`
	Question struct {
		ID       int    `json:"id"`
		Question string `json:"question"`
	} `json:"question"`
}

type XBLSignInResp

type XBLSignInResp struct {
	Issueinstant  time.Time `json:"IssueInstant"`
	Notafter      time.Time `json:"NotAfter"`
	Token         string    `json:"Token"`
	Displayclaims struct {
		Xui []struct {
			Uhs string `json:"uhs"`
		} `json:"xui"`
	} `json:"DisplayClaims"`
}