minestat 2.2.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 289592d2813eb1246b9a3033ce10a219513bf0c9cb792951051bdf6f97b20598
-  data.tar.gz: beee739e9c19250fb6663e9561e065dfbcbae817442afe07ca3a21911e5f975a
+SHA1:
+  metadata.gz: e0acf4a379eb97f4145d734b8f7d3b82b9b5f57d
+  data.tar.gz: 8fe0222fc8892a44eea98917e87eaad75f0fd8d3
 SHA512:
-  metadata.gz: ad094493fac2c5b788c7ed86bdcc1e5296715d410cfe435491101fa56aae2bda6cd81644a88ce8caf183e6ae13072e559a073a4a4b42f9a51b0dfe261a46b378
-  data.tar.gz: a757852cab9404fe9937a9a4f9fb7bac2effccd3317173d2abf0bc200a87dea5a6576e382c878be9d15f31b2489298197fafa6f5c1b4eaa1aff75d90f6ab6c16
+  metadata.gz: 071fd966c47fd93d01087a4c85d20ca2ca56c05cec1d22c8aeff824602c900f085d7c877e37b0dfe25d3105f74dab2a52d2fa1f19b8706d3a31d16bbb96a7af8
+  data.tar.gz: 4846ca755878fd8d81bddd5634916e83955b142ea587cb81c3ba55a629f04129a2eacdc11f7fa68d9b6d77f5ab8ed141628d330a7e33a5e2fc82e46d61b625ab

data/lib/minestat.rb

@@ -24,7 +24,7 @@ require 'timeout'
 # Provides a ruby interface for polling Minecraft server status.
 class MineStat
   # MineStat version
-  VERSION = "2.2.0"
+  VERSION = "2.2.1"
   # Number of values expected from server
   NUM_FIELDS = 6
   # Number of values expected from a 1.8b/1.3 server
@@ -32,7 +32,7 @@ class MineStat
   # Maximum number of bytes a varint can be
   MAX_VARINT_SIZE = 5
   # Default TCP port
-  DEFAULT_PORT = 25565
+  DEFAULT_TCP_PORT = 25565
   # Bedrock/Pocket Edition default UDP port
   DEFAULT_BEDROCK_PORT = 19132
   # Default TCP/UDP timeout in seconds
@@ -79,7 +79,7 @@ class MineStat
 
   ##
   # Instantiate an instance of MineStat and poll the specified server for information
-  def initialize(address, port = DEFAULT_PORT, timeout = DEFAULT_TIMEOUT, request_type = Request::NONE)
+  def initialize(address, port = DEFAULT_TCP_PORT, timeout = DEFAULT_TIMEOUT, request_type = Request::NONE)
     @address = address    # address of server
     @port = port          # TCP/UDP port of server
     @online               # online or offline?
@@ -95,6 +95,9 @@ class MineStat
     @timeout = timeout    # TCP/UDP timeout
     @server               # server socket
     @request_type         # Protocol version
+    @try_all = false      # try all protocols?
+
+    @try_all = true if request_type == Request::NONE
 
     case request_type
       when Request::BETA
@@ -108,7 +111,7 @@ class MineStat
       when Request::BEDROCK
         retval = bedrock_request()
       else
-        # Attempt various SLP ping requests in a particular order. If the
+        # Attempt various ping requests in a particular order. If the
         # connection fails, there is no reason to continue with subsequent
         # requests. Attempts should continue in the event of a timeout
         # however since it may be due to an issue during the handshake.
@@ -127,7 +130,7 @@ class MineStat
         unless retval == Retval::CONNFAIL
           retval = json_request()
         end
-        # Bedrock
+        # Bedrock/Pocket Edition
         unless retval == Retval::CONNFAIL
           retval = bedrock_request()
         end
@@ -159,7 +162,7 @@ class MineStat
   def connect()
     begin
       if @request_type == Request::BEDROCK || @request_type == "Bedrock/Pocket Edition"
-        @port = DEFAULT_BEDROCK_PORT if @port == DEFAULT_PORT && @request_type == Request::NONE
+        @port = DEFAULT_BEDROCK_PORT if @port == DEFAULT_TCP_PORT && @try_all
         start_time = Time.now
         @server = UDPSocket.new
         @server.connect(@address, @port)
@@ -260,9 +263,9 @@ class MineStat
   #   2b. data length
   #   2c. 3 fields delimited by \u00A7 (section symbol)
   # The 3 fields, in order, are:
-  # * message of the day
-  # * current players
-  # * max players
+  #   * message of the day
+  #   * current players
+  #   * max players
   def beta_request()
     retval = nil
     begin
@@ -293,12 +296,12 @@ class MineStat
   #   2b. data length
   #   2c. 6 fields delimited by \x00 (null)
   # The 6 fields, in order, are:
-  # * the section symbol and 1
-  # * protocol version
-  # * server version
-  # * message of the day
-  # * current players
-  # * max players
+  #   * the section symbol and 1
+  #   * protocol version
+  #   * server version
+  #   * message of the day
+  #   * current players
+  #   * max players
   #
   # The protocol version corresponds with the server version and can be the
   # same for different server versions.
@@ -340,12 +343,12 @@ class MineStat
   #   2b. data length
   #   2c. 6 fields delimited by \x00 (null)
   # The 6 fields, in order, are:
-  # * the section symbol and 1
-  # * protocol version
-  # * server version
-  # * message of the day
-  # * current players
-  # * max players
+  #   * the section symbol and 1
+  #   * protocol version
+  #   * server version
+  #   * message of the day
+  #   * current players
+  #   * max players
   #
   # The protocol version corresponds with the server version and can be the
   # same for different server versions.
@@ -486,20 +489,21 @@ class MineStat
   #   2b. current time as a long
   #   2c. server GUID as a long
   #   2d. 16-bit magic number
-  #   2e. server ID as a string
+  #   2e. server ID string length
+  #   2f. server ID as a string
   # The fields from the pong response, in order, are:
-  # * edition
-  # * MotD line 1
-  # * protocol version
-  # * version name
-  # * current player count
-  # * maximum player count
-  # * unique server ID
-  # * MotD line 2
-  # * game mode as a string
-  # * game mode as a numeric
-  # * IPv4 port number
-  # * IPv6 port number
+  #   * edition
+  #   * MotD line 1
+  #   * protocol version
+  #   * version name
+  #   * current player count
+  #   * maximum player count
+  #   * unique server ID
+  #   * MotD line 2
+  #   * game mode as a string
+  #   * game mode as a numeric
+  #   * IPv4 port number
+  #   * IPv6 port number
   def bedrock_request()
     retval = nil
     begin
@@ -554,7 +558,7 @@ class MineStat
   # Returns the maximum player count
   attr_reader :max_players
 
-  # Returns the SLP (Server List Ping) protocol level
+  # Returns the protocol level
   #
   # This is arbitrary and varies by Minecraft version.
   # However, multiple Minecraft versions can share the same
@@ -568,6 +572,9 @@ class MineStat
   # Returns the ping time to the server in ms
   attr_reader :latency
 
-  # Returns the SLP (Server List Ping) protocol version
+  # Returns the protocol version
   attr_reader :request_type
+
+  # Returns whether or not all ping protocols should be attempted
+  attr_reader :try_all
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: minestat
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.1
 platform: ruby
 authors:
 - Lloyd Dilley
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-01 00:00:00.000000000 Z
+date: 2022-05-15 00:00:00.000000000 Z
 dependencies: []
 description: MineStat polls Minecraft server data such as version, motd, current players,
   and max players.
@@ -23,7 +23,7 @@ homepage: https://github.com/FragLand/minestat
 licenses:
 - GPL-3.0
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -38,8 +38,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubyforge_project: 
+rubygems_version: 2.5.2.1
+signing_key: 
 specification_version: 4
 summary: Minecraft server status checker
 test_files: []