io.github.spair:byond-message-client

Library to send and receive messages from BYOND.

License	MIT License
Categories	CLI User Interface
GroupId	io.github.spair
ArtifactId	byond-message-client
Last Version	1.3
Release Date	Oct 11, 2018
Type	jar
Description	io.github.spair:byond-message-client Library to send and receive messages from BYOND.
Project URL	https://spair.github.io/byond-message-client
Source Code Management	https://github.com/SpaiR/byond-message-client/tree/master

Download byond-message-client

Filename	Size
byond-message-client-1.3.pom
byond-message-client-1.3.jar	19 KB
byond-message-client-1.3-sources.jar	15 KB
byond-message-client-1.3-javadoc.jar	121 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.spair/byond-message-client/ -->
<dependency>
    <groupId>io.github.spair</groupId>
    <artifactId>byond-message-client</artifactId>
    <version>1.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.spair/byond-message-client/
implementation 'io.github.spair:byond-message-client:1.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.spair/byond-message-client/
implementation ("io.github.spair:byond-message-client:1.3")

Apache Buildr

'io.github.spair:byond-message-client:jar:1.3'

Apache Ivy

<dependency org="io.github.spair" name="byond-message-client" rev="1.3">
  <artifact name="byond-message-client" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.spair', module='byond-message-client', version='1.3')
)

Scala SBT

libraryDependencies += "io.github.spair" % "byond-message-client" % "1.3"

Leiningen

[io.github.spair/byond-message-client "1.3"]

Dependencies

provided (1)

Group / Artifact	Type	Version
org.projectlombok : lombok	jar	1.18.2

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

BYOND Message Client

About

Small library for Java, which provide simple way to send messages and receive responses from BYOND server.

Installation

Library is deployed and provided with Maven Central and JCenter repositories.

pom.xml:

<dependency>
    <groupId>io.github.spair</groupId>
    <artifactId>byond-message-client</artifactId>
    <version>${last.version}</version>
</dependency>

build.gradle:

compile 'io.github.spair:byond-message-client:${last.version}'

Usage

There are three main classes to use:

• ByondClient
• ByondMessage (with ServerAddress class)
• ByondResponse

Example:

ByondMessage message = new ByondMessage("bagil.game.tgstation13.org", 2337, "ping");
ByondResponse response = new ByondClient().sendMessage(message);

If you print response object you could see something like that:

ByondResponse(response=56.0, responseType=FLOAT_NUMBER)

Response data is an Object class, so manual class cast is needed.

Additional info:

• On BYOND side message should be handled in World/Topic() method. Look BYOND Ref for more info.
• If you want just to send message to BYOND and you don't care about response use sendCommand() method instead of sendMessage() or set expected response type in ByondMessage as ResponseType.NONE.
• To control response type from BYOND set ResponseType.FLOAT_NUMBER or ResponseType.STRING in ByondMessage instance. If actual response type is different exception UnexpectedResponseException will be thrown.

Also there are some exceptions I'll recommend to handle due to significant reasons.

1. HostUnavailableException It will be thrown if host you try to send message is currently offline. Restart moment, for example.
2. UnexpectedResponseException Exception will be thrown while two reasons: World/Topic() doesn't return any response on your message; moment between when server already restarted, but World didn't initialized. Little chance, but you can got in this situation.

Read more in JavaDoc.

Versions

Version
1.3 Oct 11, 2018
1.2.4 Jun 7, 2018
1.2.3 May 9, 2018
1.2.2 Apr 16, 2018
1.2.1 Mar 18, 2018
1.2 Sep 20, 2017
1.1 Sep 6, 2017
1.0 Jul 29, 2017