social-game-kit 0.1.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65571e588b48927227617f828d9f137a8266e8d84f2720ae4025efa5b20f97c1
-  data.tar.gz: 15473e8e6a643022c099bfc04cceb8f3c19486395ea6a3f31b98ae44d301571a
+  metadata.gz: 4e79f7963dc2c44320694859eddb15f1db44ce3c29bff1cc1f6ba36436dbeeb0
+  data.tar.gz: d0007d4a08edf989d0a9e95e6df4222722adf83ff0b56abecae1118fb9ed2f70
 SHA512:
-  metadata.gz: b681aed93bc74186fb42e9a27a745ef720c21522aba4733c7852ff46dcc5649574fbf6ea555da85364beac0795ca372a5d37ac0383eaba6ab10ba6b13c59f3b0
-  data.tar.gz: 21e9ea9293a84a29eb1ad2dcc7a9757caf1b8d04181c38b3f8d1fe2b8d71e7829f6d9e92c55bc7b4b46b785f6cf013a08da75dc26e8df1957bfa404c0ad79bdf
+  metadata.gz: 906cf1ec805dd5f47db11677d21c34b575cf783f64738d4aecabdf2da99b0d5c2cbcef8caecb8d7a6a829d7fee054742ac48ee5c97db5b4736ae1fc7d9a687e3
+  data.tar.gz: 829e48ebdb65d71afde7a6609d65173aea83711e404033d22ef0256e5543cefdf71c835dd74dbfe652a3b952b0322e9b04bc1c1fc7a48bed358752dbbd5612bc

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [1.1.0] - 2025-11-29
+
+- Add PitySystem: 100連で天井（確定URが出る）機能
+- Add MultipleDraw: 10連ガチャをシンプルにラップするクラス
+
 ## [0.1.0] - 2025-11-02
 
-- Initial release
+- Initial release: Gacha engine with weighted random selection

data/README.md

@@ -35,13 +35,13 @@ bundle install
 ### 基本的な使用方法
 
 ```ruby
-require 'sgk'
+require 'ssg'
 
 # カードマスタデータ（ActiveRecordモデル）から抽選
 cards = GachaCard.all
 
 # エンジンの初期化
-engine = SGK::Gacha::Engine.new(cards)
+engine = SSG::Gacha::Engine.new(cards)
 
 # 単発抽選
 card = engine.draw
@@ -76,7 +76,7 @@ end
 # app/controllers/gacha_controller.rb
 class GachaController < ApplicationController
   def draw
-    engine = SGK::Gacha::Engine.new(GachaCard.all)
+    engine = SSG::Gacha::Engine.new(GachaCard.all)
     @result = engine.draw
 
     # ユーザーにカードを付与する処理など
@@ -87,7 +87,7 @@ class GachaController < ApplicationController
 
   def draw_multiple
     count = params[:count].to_i.clamp(1, 10)  # 最大10連
-    engine = SGK::Gacha::Engine.new(GachaCard.all)
+    engine = SSG::Gacha::Engine.new(GachaCard.all)
     @results = engine.draw_multiple(count)
 
     current_user.gacha_cards.push(*@results)
@@ -98,7 +98,7 @@ class GachaController < ApplicationController
   end
 
   def probabilities
-    engine = SGK::Gacha::Engine.new(GachaCard.all)
+    engine = SSG::Gacha::Engine.new(GachaCard.all)
 
     render json: engine.probabilities
   end
@@ -159,14 +159,14 @@ GachaCard.create!([
 
 ## APIリファレンス
 
-### SGK::Gacha::Engine
+### SSG::Gacha::Engine
 
 #### `initialize(card_relation)`
 
 ActiveRecord::Relationを受け取ります。
 
 ```ruby
-engine = SGK::Gacha::Engine.new(GachaCard.all)
+engine = SSG::Gacha::Engine.new(GachaCard.all)
 ```
 
 #### `draw`
@@ -194,7 +194,7 @@ probs = engine.probabilities
 # => {1=>70.0, 2=>25.0, 3=>4.0, 4=>1.0}
 ```
 
-### SGK::Gacha::Result
+### SSG::Gacha::Result
 
 ガチャ結果をラップするクラスです。
 

data/lib/sgk/gacha/engine.rb

@@ -2,11 +2,7 @@
 
 module SGK
   module Gacha
-    # Gacha engine that implements weighted random card selection.
-    #
-    # This engine takes an ActiveRecord relation of cards and provides methods
-    # to draw cards based on their weights, supporting both single draws and
-    # multiple draws in one operation.
+    # 重み付きガチャエンジン
     class Engine
       def initialize(card_relation)
         @cards = card_relation.to_a
@@ -26,16 +22,14 @@ module SGK
         end
 
         # NOTE: 浮動小数点誤差を考慮して最後のカードを返す実装だが、重み付き抽選の特性上起こる可能性はほとんどない。
-        # Returns the last card as a fallback for floating-point precision errors,
-        # though this scenario is highly unlikely given the nature of weighted random selection.
         @cards.last
       end
 
-      # Draw multiple cards in a single operation (e.g., 10-draw gacha).
+      # 単一操作で複数のカードを抽選する（例：10連ガチャ）。
       #
-      # @param count [Integer] Number of cards to draw
-      # @return [Array<Object>] Array of drawn cards
-      # @raise [ArgumentError] If count is not positive
+      # @param count [Integer] 抽選するカードの枚数
+      # @return [Array<Object>] 抽選されたカードの配列
+      # @raise [ArgumentError] countが正の値でない場合
       def draw_multiple(count)
         raise ArgumentError, "Draw count must be positive" unless count.positive?
 

data/lib/sgk/gacha/multiple_draw.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module SGK
+  module Gacha
+    # 10連ガチャ
+    #
+    # 使用例:
+    #   engine = SGK::Gacha::Engine.new(GachaCard.all)
+    #   drawer = SGK::Gacha::MultipleDraw.new(engine, draw_count: 10)
+    #   results = drawer.execute
+    class MultipleDraw
+      DEFAULT_DRAW_COUNT = 10
+
+      attr_reader :engine, :draw_count
+
+      # 初期化
+      #
+      # @param engine [SGK::Gacha::Engine] 使用するガチャエンジン
+      # @param draw_count [Integer] 抽選するカードの枚数（デフォルト: 10）
+      # @raise [ArgumentError] engineが無効、またはdraw_countが正の値でない場合
+      def initialize(engine, draw_count: DEFAULT_DRAW_COUNT)
+        raise ArgumentError, "Engine must be a SGK::Gacha::Engine instance" unless engine.is_a?(Engine)
+        raise ArgumentError, "Draw count must be positive" unless draw_count.positive?
+
+        @engine = engine
+        @draw_count = draw_count
+      end
+
+      # 複数抽選を実行する
+      #
+      # @return [Array<Object>] 抽選されたカードの配列
+      def execute
+        @engine.draw_multiple(@draw_count)
+      end
+
+      # executeのエイリアス
+      alias draw execute
+    end
+  end
+end

data/lib/sgk/gacha/pity_system.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module SGK
+  module Gacha
+    # 100回連続でUR（Ultra Rare）カードが出なかった場合、次回の抽選でURカードを保証する
+
+    # 使用例:
+    #   engine = SGK::Gacha::Engine.new(GachaCard.all)
+    #   pity = SGK::Gacha::PitySystem.new(engine, guarantee_limit: 100, guaranteed_rarity: :ultra_rare)
+    #
+    #   result = pity.draw(current_pity_count: user_current_pity)
+    class PitySystem
+      attr_reader :engine, :guarantee_limit, :guaranteed_rarity
+
+      # 初期化
+      #
+      # @param engine [SGK::Gacha::Engine] 抽選に使用するガチャエンジン
+      # @param guarantee_limit [Integer] 保証レアが出るまでの抽選回数（デフォルト: 100）
+      # @param guaranteed_rarity [Symbol, String] 保証するレアリティ（デフォルト: :ultra_rare）
+      # @raise [ArgumentError] guarantee_limitが正の値でない場合
+      def initialize(engine, guarantee_limit: 100, guaranteed_rarity: :ultra_rare)
+        raise ArgumentError, "Engine must be a SGK::Gacha::Engine instance" unless engine.is_a?(Engine)
+        raise ArgumentError, "Guarantee limit must be positive" unless guarantee_limit.positive?
+
+        @engine = engine
+        @guarantee_limit = guarantee_limit
+        @guaranteed_rarity = guaranteed_rarity.to_sym
+      end
+
+      # カード抽選
+      #
+      # @param current_pity_count [Integer] 最後の保証カードからの抽選回数
+      # @return [Object] 抽選されたカード（pity_count >= guarantee_limitの場合は保証UR）
+      # @raise [ArgumentError] current_pity_countが負の値の場合
+      def draw(current_pity_count: 0)
+        raise ArgumentError, "Pity count must be non-negative" unless current_pity_count >= 0
+
+        # 保証カードを返す
+        if current_pity_count >= @guarantee_limit
+          return draw_guaranteed_card
+        end
+
+        # それ以外の場合は通常の抽選を実行
+        @engine.draw
+      end
+
+      # 複数のカードを抽選する
+      #
+      # @param count [Integer] 抽選するカードの枚数
+      # @param current_pity_count [Integer] 最後の保証カードからの抽選回数
+      # @return [Array<Object>] 保証カードの抽選カードの配列
+      # @raise [ArgumentError] countが正の値でない、またはpity_countが負の値の場合
+      def draw_multiple(count, current_pity_count: 0)
+        raise ArgumentError, "Draw count must be positive" unless count.positive?
+        raise ArgumentError, "Pity count must be non-negative" unless current_pity_count >= 0
+
+        results = []
+        current_count = current_pity_count
+
+        count.times do
+          card = draw(current_pity_count: current_count)
+          results << card
+
+          # 保証カードを引いた場合は抽選回数をリセット、それ以外はカウントを増やしていく
+          if is_guaranteed_card?(card)
+            current_count = 0
+          else
+            current_count += 1
+          end
+        end
+
+        results
+      end
+
+      # 次の保証までの残り回数と保証回数を取得する
+      #
+      # @param current_pity_count [Integer] 最後の保証カードからの抽選回数
+      # @return [Hash] 次の保証までの残り回数と保証回数
+      # @example
+      #   pity.next_guarantee_info(current_pity_count: 75)
+      #   # => { pity_count: 75, remaining: 25, guaranteed_at: 100 }
+      def next_guarantee_info(current_pity_count: 0)
+        raise ArgumentError, "Pity count must be non-negative" unless current_pity_count >= 0
+
+        {
+          current_pity_count: current_pity_count,
+          remaining: [@guarantee_limit - current_pity_count, 0].max,
+          guaranteed_at: @guarantee_limit
+        }
+      end
+
+      private
+
+      # 保証カード（UR）を抽選する
+      #
+      # @return [Object] 保証されたカード
+      # @raise [ArgumentError] 保証カードが利用できない場合
+      def draw_guaranteed_card
+        guaranteed_cards = @engine.instance_variable_get(:@cards).select do |card|
+          card.respond_to?(:rarity) && card.rarity.to_sym == @guaranteed_rarity
+        end
+
+        raise ArgumentError, "No cards with rarity #{@guaranteed_rarity} found" if guaranteed_cards.empty?
+
+        # 保証カードからランダムにカードを返す
+        guaranteed_cards.sample
+      end
+
+      # カードが保証レアリティのカードかどうかをチェックする
+      #
+      # @param card [Object] 保証レアリティのカードかどうかをチェックするカード
+      # @return [Boolean] カードが保証レアリティのカードかどうか
+      def is_guaranteed_card?(card)
+        card.respond_to?(:rarity) && card.rarity.to_sym == @guaranteed_rarity
+      end
+    end
+  end
+end

data/lib/sgk/gacha/result.rb

@@ -2,11 +2,8 @@
 
 module SGK
   module Gacha
-    # Represents the result of a gacha draw.
+    # ガチャ抽選の結果を表す。
     #
-    # This class wraps a card object and provides convenient accessors
-    # for common card properties. It can be serialized to a hash for
-    # logging or API responses.
     class Result
       attr_reader :card
 
@@ -22,9 +19,7 @@ module SGK
         @card.rarity
       end
 
-      # Convert the result to a hash for JSON serialization.
-      #
-      # @return [Hash] A hash containing card_id, name, and rarity
+      # JSON変換用メソッド
       def json_format
         {
           card_id: @card.id,

data/lib/sgk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SGK
-  VERSION = "0.1.0"
+  VERSION = "1.1.0"
 end

data/lib/sgk.rb

@@ -3,6 +3,8 @@
 require_relative "sgk/version"
 require_relative "sgk/gacha/engine"
 require_relative "sgk/gacha/result"
+require_relative "sgk/gacha/pity_system"
+require_relative "sgk/gacha/multiple_draw"
 
 module SGK
   class Error < StandardError; end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: social-game-kit
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.0
 platform: ruby
 authors:
 - sugawara_nagisa
 bindir: exe
 cert_chain: []
-date: 2025-11-02 00:00:00.000000000 Z
+date: 2025-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -53,6 +53,8 @@ files:
 - Rakefile
 - lib/sgk.rb
 - lib/sgk/gacha/engine.rb
+- lib/sgk/gacha/multiple_draw.rb
+- lib/sgk/gacha/pity_system.rb
 - lib/sgk/gacha/result.rb
 - lib/sgk/version.rb
 - sig/ssg.rbs