etw_math 1.0.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d86434b8a584f7010ab5af15c06808ac7303d954bdb7497f388ca904ab3c7ff2
-  data.tar.gz: a9426882c4e1d820517cdc6fd68ad6ff235bc882e167d398b7c2164586bfa277
+  metadata.gz: 2a6bc32aa40fd9881fd07c4504ec0ec8bd62391395216c6bdae1d63ae3f67a88
+  data.tar.gz: fd2bde9416a952dca7fed4b0e492db218d8b8ad4252e81ba0ea25bcc3b86f353
 SHA512:
-  metadata.gz: 2f60687998b6b2a479c282f78fa4eb5b5b4884ffbd008342b89f9b71382dce10ed5008fc4a154a92983695544fbbd8e6bb1e4f2f30e75e4938a45b575c11cf8a
-  data.tar.gz: 28b38734754ef876e4c4727cbe4a3eeb8dce3fe1b1d4867c79bdbd3581d9d336600b949249773335d4afd38b46d77aea68cd8ed9a9521627ff029aacfd27ea2a
+  metadata.gz: 42cbf495e7ec47ba887ae8c002ac554881b99abeca3f10121fb85693271887ce9e36119f748afbded820bff94d04bdaad2f2b0da373e7774cc47030d25a508d8
+  data.tar.gz: b34240e9f07ecb3cb8ac77eb97773b94b695893220c0e2b339eede77a19ee7180dd91cbdffb2636b87e3fd5b6d9ef2ced443d4e1286a8677d1a8f05d8ca36774

data/example.rb

@@ -1,5 +1,5 @@
 # example.rb - EtwMath examples
-# Copyright (C) 2025 Lazy Villain
+# Copyright (C) 2025-2026 Lazy Villain
 # https://github.com/LazyAntihero/etw_math
 #
 # Redistribution and use in source and binary forms, with or without
@@ -49,6 +49,14 @@ puts "\nMax size at size level 100 size is:"
 puts EtwMath.size_at_level(100)
 puts "\nSize level for a max size of 505,000 is:"
 puts EtwMath.level_at_size(505000)
+puts "\nActual size level for a max size of 509,999 is:"
+puts EtwMath.actual_level_at_size(509999)
+puts "\nNearest size level for a max size of 510,999 is:"
+puts EtwMath.nearest_level_at_size(510999)
+puts "\nEat speed level for an eat speed value of 5.4:"
+puts EtwMath.eat_speed_level(5.4)
+puts "\nEat speed value for an eat speed level of 23:"
+puts EtwMath.eat_speed_value(23)
 puts "\nOptimal size level for a multi of 100 using a factor of 5.5 is:"
 puts EtwMath.optimal_size_level_threshold(100, 5.5)
 puts "\nOptimal multi for a size level of 550 using a ratio of 5.5 is:"

data/lib/etw_math.rb

@@ -1,5 +1,5 @@
 # etw_math.rb - Various mathematical formulas for Roblox - Eat the World (ETW)
-# Copyright (C) 2025 Lazy Villain
+# Copyright (C) 2025-2026 Lazy Villain
 # https://github.com/LazyAntihero/etw_math
 #
 # Redistribution and use in source and binary forms, with or without
@@ -28,7 +28,7 @@
 # This class contains various methods that perform Eat the World calculations
 class EtwMath
   # EtwMath version
-  VERSION = "1.0.1"
+  VERSION = "1.2.0"
 
   # Number of seconds in 1 day
   SECONDS_PER_DAY = 86400
@@ -174,8 +174,8 @@ class EtwMath
     format_number(50 * level ** 2 + 50 * level)
   end
 
-  # Calculates size level
-  # @param level [Integer] Maximum size
+  # Calculates size level (floor)
+  # @param size [Integer] Maximum size
   # @return [String, Boolean] String representation of an integer or false if input is invalid or division by zero occurs
   # @example
   #   EtwMath.level_at_size(505000) # 100
@@ -188,6 +188,54 @@ class EtwMath
     end
   end
 
+  # Calculates actual size level (float)
+  # @param size [Integer] Maximum size
+  # @return [String, Boolean] String representation of an integer or false if input is invalid or division by zero occurs
+  # @example
+  #   EtwMath.actual_level_at_size(509999) # 100.496
+  def self.actual_level_at_size(size)
+    return false if !input_valid?(size)
+    begin
+      format_number(((-50 + Math.sqrt(2500 + 200 * size)) / 100).round(3), true)
+    rescue # division by zero
+      return false
+    end
+  end
+
+  # Calculates nearest size level (rounded)
+  # @param size [Integer] Maximum size
+  # @return [String, Boolean] String representation of an integer or false if input is invalid or division by zero occurs
+  # @example
+  #   EtwMath.nearest_level_at_size(505000) # 100
+  def self.nearest_level_at_size(size)
+    return false if !input_valid?(size)
+    begin
+      format_number(((-50 + Math.sqrt(2500 + 200 * size)) / 100).round)
+    rescue # division by zero
+      return false
+    end
+  end
+
+  # Calculates eat speed value
+  # @param eat_speed_level [Integer] Eat speed level
+  # @return [String, Boolean] String representation of a float or false if input is invalid
+  # @example
+  #   EtwMath.eat_speed_value(31) # 7.0
+  def self.eat_speed_value(eat_speed_level)
+    return false if !input_valid?(eat_speed_level)
+    format_number(0.2 * eat_speed_level + 0.8, true)
+  end
+
+  # Calculates eat speed level
+  # @param eat_speed_value [Float] Eat speed value
+  # @return [String, Boolean] String representation of an integer or false if input is invalid
+  # @example
+  #   EtwMath.eat_speed_level(7.0) # 31
+  def self.eat_speed_level(eat_speed_value)
+    return false if !input_valid?(eat_speed_value)
+    format_number(5 * eat_speed_value - 4)
+  end
+
   # Calculates optimal size level threshold
   # @param multi [Integer] Multiplier level
   # @param ratio [Numeric] Ratio

data/test.rb

@@ -1,5 +1,5 @@
 # test.rb - EtwMath unit tests
-# Copyright (C) 2025 Lazy Villain
+# Copyright (C) 2025-2026 Lazy Villain
 # https://github.com/LazyAntihero/etw_math
 #
 # Redistribution and use in source and binary forms, with or without
@@ -106,6 +106,26 @@ class EtwMathTests < Minitest::Test
     assert(!EtwMath.level_at_size(-1))
   end
 
+  def test_actual_level_at_size
+    assert_equal("100.496", EtwMath.actual_level_at_size(509999))
+    assert(!EtwMath.actual_level_at_size(-1))
+  end
+
+  def test_nearest_level_at_size
+    assert_equal("101", EtwMath.nearest_level_at_size(510999))
+    assert(!EtwMath.nearest_level_at_size(-1))
+  end
+
+  def test_eat_speed_value
+    assert_equal("5.4", EtwMath.eat_speed_value(23))
+    assert(!EtwMath.eat_speed_value(-1))
+  end
+
+  def test_eat_speed_level
+    assert_equal("23", EtwMath.eat_speed_level(5.4))
+    assert(!EtwMath.eat_speed_level(-1))
+  end
+
   def test_optimal_size_level_threshold
     assert_equal("550", EtwMath.optimal_size_level_threshold(100, 5.5))
     assert(!EtwMath.optimal_size_level_threshold(-1, -1))

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: etw_math
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Lazy Villain