omp

omp is a Go package that allows you to write open.mp gamemodes.

Installation

go get github.com/kodeyeen/omp

Requirements

• GCC/G++ go build tool will require you to have C and C++ 32 bit compilers available on your system.

Type gcc -v and g++ -v in your terminal and you should see something like this:

Target: i686-w64-mingw32

Note the i686. Otherwise it won't build.

Quickstart

1. Initialize a go module with go mod init <YOUR MODULE NAME>.
2. Write some basic gamemode.

package main

import (
	"github.com/kodeyeen/omp"
)

// Gamemode entry point
func init() {
	// Listen to some predefined event
	omp.Events.Listen(omp.EventTypePlayerConnect, func(e *omp.PlayerConnectEvent) bool {
		// Send client message to the connected player
		e.Player.SendClientMessage("Hello, world!", 0xFFFF00FF)
		return true
	})
}

// You MUST declare the main function, otherwise it fails to build
// You shouldn't write any code here
func main() {}

3. Build it depending on your system (see the section below).
4. Add the compiled file to the gamemodes folder of your server.
5. Install and configure the Gomponent.

Now if you run the server and connect to it you should see the message "Hello, world!"

Building

On Windows:

$env:GOARCH=386; $env:CGO_ENABLED=1; go build -buildmode=c-shared -o build\gamemode.dll

On Linux:

GOARCH=386 CGO_ENABLED=1 go build -buildmode=c-shared -o build/gamemode.so

If you're using Visual Studio Code and seeing error messages during development, this is because of your GOARCH and CGO_ENABLED env variable values. You can check them by typing:

go env

If GOARCH value is something different than 386 and CGO_ENABLED is 0 this is the cause of those error messages. You can set them permanently to be 386 and 1 respectively by typing:

go env -w GOARCH=386

go env -w CGO_ENABLED=1

Credits

These people helped me a lot during the development of the package:

• Sreyas-Sreelal
• Hual
• AmyrAhmady