fishing-minigame — Fisch の最小再現（Roblox）

Other
fishing-minigame — Fisch の最小再現（Roblox）

fishing-minigame — Fisch の最小再現（Roblox）

Roblox 上のミニゲーム「Fisch」を最小限に再現したリポジトリ。サーバーとクライアント両方で reactive signals（littensy/charm の alien-signals）を用いた状態管理を採用し、固定ステップのソルバーによる決定論的シミュレーションとサーバー側での再シミュレーション（resimulation）を特徴とする。Luau で記述され、サブモジュールを使って外部ライブラリを取り込む構成になっている。

https://github.com/littensy/fishing-minigame

概要

このリポジトリは、Roblox 上にあるゲーム「Fisch」を最小限に再現したプロジェクトです。開発者は reactive signals をサーバーとクライアント双方のゲーム状態管理に用いるアプローチを試しており、決定論的な固定ステップのシミュレーションを採用して挙動の再現性を高めています。サーバーは権威（authoritative）を持ち、必要に応じて過去の状態を再シミュレートしてクライアントの入力や遅延に対応します。Luau 言語で書かれ、外部モジュールをサブモジュールで取り込む構成です。

GitHub

リポジトリの統計情報

  • スター数: 5
  • フォーク数: 1
  • ウォッチャー数: 5
  • コミット数: 2
  • ファイル数: 12
  • メインの言語: Luau

主な特徴

  • Reactive signals を用いたサーバー／クライアント両対応の状態管理
  • 固定ステップ（fixed-step）ソルバーによる決定論的シミュレーション
  • サーバー側での再シミュレーション（resimulation）で遅延や不整合を補正
  • 最小再現のためのシンプルな構成・モジュール化

技術的なポイント

本プロジェクトの技術的な中核は「決定論的シミュレーション」と「反応性（reactive）な状態管理」の組み合わせにあります。固定ステップソルバーを使うことで、フレーム時間に依存しない一貫した物理／ゲームロジックの進行が可能になり、同じ初期状態と同じ入力列に対して常に同じ結果が得られるように設計されています。これによりサーバーは過去の時点からの再シミュレーション（resimulation）を行って、遅延のあるプレイヤー入力やパケットロスによる不一致を補正できます。

状態管理には littensy/charm の alien-signals（リアクティブシグナル）の考え方を取り入れており、サーバーとクライアントで同じ信号駆動の API を使うことで UI とゲームロジックの結合をゆるやかに保ちます。信号は変更を購読するだけでビューやサブシステムが自動で更新されるため、イベントの手作業による配線や状態伝播が減り、コードの可読性と保守性が向上します。

ネットワーク面ではサーバーが状態の権威を持ち、クライアントは入力を送信してクライアント側予測や補間を行う想定です。再シミュレーションを行う際は入力の履歴と固定ステップの進行を使って状態を巻き戻し再計算し、その差分をクライアントに反映します。Roblox/Luau 環境では浮動小数点の扱い、乱数シードの管理、API 呼び出しの副作用が決定論に影響するため、決定論的シミュレーションを正しく動作させるにはこれらを厳格に管理する必要があります。

さらに、.gitmodules によるサブモジュール管理は外部ライブラリ（signals 等）を明示的に固定バージョンで取り込む手法を示しており、依存性の再現性やビルドの安定性に寄与します。Luau 特有のツール設定（.luaurc）や小規模なモジュール構成は、ローカルでのテストやデバッグを容易にします。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • .gitmodules: file
  • .luaurc: file
  • LICENSE: file
  • README.md: file

…他 7 ファイル

（注：ファイル数は 2025-11-24 時点のリポジトリメタ情報に基づきます）

まとめ

決定論的シミュレーションとリアクティブ信号を組み合わせた、学習用途に適した軽量な Roblox ミニゲーム実装。

リポジトリ情報：

READMEの抜粋：

fishing-minigame

https://github.com/user-attachments/assets/62975187-4a85-49f1-a937-90b8dbb3a34b

A minimal recreation of Fisch. This project explores an approach to Roblox games using reactive signals for game state on the server and client.

Play the game →

Features

  • Simulation is deterministic with a fixed-step solver
  • Server resimulates …