Steam on kymt.me

ruby-qstat

Sat, 04 Feb 2012 00:00:00 +0000

ゲームサーバー統計取得ツールの QStat を Ruby から使うためのラッパー gem です。qstat コマンドを起動して、マスターサーバーからのサーバー一覧取得や、個別のゲームサーバーへの状態問い合わせの結果を、Ruby のオブジェクトとして返します。

README 記載の動作要件は Ruby 1.9 と QStat 2.12 です。

使い方

gem install ruby-qstat

README にある例です。

# マスターサーバーからサーバー一覧を取得
QStat.query_serverlist("hl2master.steampowered.com:27011", "stm", "left4dead2", maxping = 100)

# 個別サーバーの状態を取得
QStat.query("xxx.yyy.zzz.qqq", "a2s")

# 個別サーバーの状態を取得(サーバー情報のみ)
QStat.query_serverinfo("xxx.yyy.zzz.qqq", "a2s")

内部設計

ライブラリ本体は lib/ruby-qstat.rb の1ファイルで、API は QStat クラスのクラスメソッド群として提供します(インスタンス化はできない作りです)。qstat コマンドの起動は共通の exec_cmd に集約されていて、出力の形式によってパース経路が2系統に分かれます。

exec_cmd — Open3.popen3 で qstat を起動し、stdout を読むスレッドと stderr を Logger に流すスレッドの2本で出力を回収します。filter ブロックを渡すと、stdout を1行読むごとに判定して、条件が成立した時点で qstat プロセスを TERM で打ち切れます。qstat のパスは QStat.qstat_path=、ロガーは QStat.logger= で差し替えられます
XML 系(query_serverlist/qslist)— -xml オプション付きで起動して、出力を Nokogiri でパースします。Response オブジェクトが XML と DOM を保持し、valid?(先頭の server 要素の status が UP か)や to_ror(ActiveSupport の Hash.from_xml によるハッシュ化)を提供します
テキスト系(query/query_serverinfo)— -P(プレイヤー情報)・-R(サーバールール)付きのプレーンテキスト出力を正規表現でパースして ServerInfo を作ります。「no response」「DOWN」の応答もヘッダ行の正規表現で判定します
結果オブジェクト — ServerInfo(アドレス・サーバー名・マップ・人数・ping・status など)、PlayerInfo(名前・frags・プレイ時間。qstat の「1h 2m 3s」のような時間表記を秒に換算するパーサ入り)、Rule(protocol・gamedir・secure・version・game_tag などのサーバールール)。ServerInfo#playing_time は、いちばん長くプレイしているプレイヤーの時間を返します
ゲームタイプ推定 — ServerInfo#suggest_game_type は、gametype が取れなかったときにサーバールールの game_tag(@ 以降のカンマ区切りタグ)から推定し、それもなければ unknown を返します
文字コード対策 — qstat には常に -utf8 を付け、さらに String#force_convert_to(UTF-16BE を経由して不正なバイトを ? に置換してから戻す monkey patch)で、サーバー名などに混ざる壊れたバイト列を無害化します

サーバー一覧取得(query_serverlist)の流れです。maxping を超えるサーバーが現れた時点で qstat を打ち切る作りで、途中で切れた XML はそのまま Nokogiri に渡してパースします。

vrowser

Mon, 06 Feb 2012 00:00:00 +0000

Left 4 Dead 2 や Team Fortress 2 など、HalfLife2 系(Source Engine)ゲームのサーバーブラウザを作るための Ruby ライブラリです。ゲームサーバー統計取得ツールの QStat をラップして、サーバー一覧の取得・データベースへの記録・JSON API での配信までを一式でやります。

gem として公開していて、コマンドラインツールも同梱しています。

gem install vrowser
vrowser sample # サンプル設定ファイルを生成
vrowser -f config.yml fetch # マスターサーバーからサーバー一覧を取得
vrowser -f config.yml update # 登録済みサーバーの状態を更新
vrowser -f config.yml daemon # 常駐デーモンとして起動

内部設計

コンポーネント構成です。中核の Vrowser クラスが QStat の呼び出しと Sequel(ORM)経由の DB 記録を束ねていて、CLI・常駐デーモン・Sinatra アプリのどこからでも同じ処理を呼べる作りになっています。

Vrowser(lib/vrowser.rb)— fetch(マスターサーバーからサーバー一覧を取得して DB に登録)、update(登録済みサーバーを全件クエリして状態更新)、clear(DOWN したサーバーの削除)を提供します
VrowserModel::Servers — Sequel のモデル。スキーマ定義もコード内に持っていて、テーブルがなければ初回接続時に作ります。host カラムが unique キーです
Vrowser::HTTPDaemon(lib/vrowser/http_daemon.rb)— WEBrick で JSON API(/api/updated/json・/api/connected/json)と public_html/ の一覧 UI(jQuery DataTables 製)を配信しつつ、別スレッドで取得ループを回します
plugins/ — ゲーム別の追加ロジック。同梱の l4d2.rb は、サーバー情報からゲームタイプが判定できないときにサーバー名の正規表現マッチ(co-?op、versus、scavenge など)でゲームタイプを推定します

デーモンの更新サイクルはこうなっています。マスターサーバーへの問い合わせは重いので、一覧の再取得は約30分に1回、その間は登録済みサーバーへの個別クエリ(A2S)を150秒間隔で回す二段構えです。

SQCN

Mon, 06 Jun 2011 00:00:00 +0000

Steam のユーザー名(表示名)をワンクリックで切り替えるためのツールです(Steam Quick Change Name の略)。よく使う名前を登録しておいて一覧から選んで適用できます。C#/.NET Framework 製。

機能概略

適用: 選択された名前に変更します
すべて適用: 配信の視聴者参加用(普段の名前の履歴を見せないため)。設定された名前すべてに一度変更してペルソナ履歴を消します(10個あれば履歴完全に消えます)
履歴消去: 過去に使った名前を他人から見えないようにするため、ペルソナ履歴を1から10の数字で上書きします(「すべて適用」と同じ目的)
通常オフラインだと名前変更できないが、このツールだとオフラインのまま名前変更できる(ゲームに入る前に名前を決めておくため)
標準の UI からだと1文字の名前に変更できない(最低2文字必須)が、このツールだと可能

いずれも Steam の表示名を自分で設定し直すだけの機能で、変更できるのは自分のアカウントの表示名だけです。

Steam を起動している状態で実行する必要があります。 なお、なんか Steam のアップデートでうまく動かなくなったので放置中です。

ダウンロード

SQCN(2011/06/06)

GetFriendAvators

Tue, 24 May 2011 00:00:00 +0000

Steam のすべてのフレンドのプロフィールアイコン(大きい方)を取得して、まとめて保存するツールです(デフォルトの ? アイコンの人がいればそれも取得可能)。

Open Steamworks + Windows .NET の習作として作りました。Steam を起動している状態で実行してないとエラーで落ちます。

ダウンロード

GetFriendAvators(2011/05/24) (スクリーンショット)

→ ソースコード (gist)