gate

Documentation

Overview

Package gate is the main package for running one or more Minecraft proxy editions.

Index

• Variables
• func LoadConfig(v *viper.Viper) (*config.Config, error)
• func Start(ctx context.Context, opts ...StartOption) error
• type Gate
  • func New(options Options) (gate *Gate, err error)
  • func (g *Gate) Bedrock() *bproxy.Proxy
  • func (g *Gate) Java() *jproxy.Proxy
  • func (g *Gate) Start(ctx context.Context) error
• type Options
• type StartOption
  • func WithAutoShutdownOnSignal(enabled bool) StartOption
  • func WithConfig(c config.Config) StartOption

Variables

var Viper = viper.New()

Viper is the default viper instance used by Start to load in a config.Config.

Functions

func LoadConfig

func LoadConfig(v *viper.Viper) (*config.Config, error)

LoadConfig loads in config.Config from viper. It is used by Start with the packages Viper if no WithConfig option is given.

func Start

func Start(ctx context.Context, opts ...StartOption) error

Start is a convenience function to set up and run a Gate instance.

It uses the logr.Logger from the provided context, reads in a Config, validates it and sets up os signal handling before starting the instance.

The Gate is shutdown when the context is canceled or on occurrence of any significant error like severe configuration error or unable to bind to a port.

Config validation warnings are logged but ignored.

Types

type Gate

type Gate struct {
	// contains filtered or unexported fields
}

Gate is the root holder of various child processes.

func New

func New(options Options) (gate *Gate, err error)

New returns a new Gate instance. The given Options requires a validated Config.

func (*Gate) Bedrock

func (g *Gate) Bedrock() *bproxy.Proxy

Bedrock returns the Bedrock edition proxy, or nil if none.

func (*Gate) Java

func (g *Gate) Java() *jproxy.Proxy

Java returns the Java edition proxy, or nil if none.

func (*Gate) Start

func (g *Gate) Start(ctx context.Context) error

Start starts the Gate instance and all underlying proc.

type Options

type Options struct {
	// Config requires a valid Gate configuration.
	Config *config.Config
	// The event manager to use.
	// If none is set, no events are sent.
	EventMgr event.Manager
}

Options are Gate options.

type StartOption

type StartOption func(o *startOptions)

StartOption is an option for Start.

func WithAutoShutdownOnSignal

func WithAutoShutdownOnSignal(enabled bool) StartOption

WithAutoShutdownOnSignal StartOption for Start that automatically shuts down the Gate instance when a shutdown signal is received.

This setting is enabled by default.

func WithConfig

func WithConfig(c config.Config) StartOption

WithConfig StartOption for Start.