ruins

command module
v1.224.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 29, 2026 License: GPL-3.0 Imports: 4 Imported by: 0

README

coverage

Ruins

ローグライク。

Play Images

CharacterJob
CharacterNaming
Character_Abilities
Character_Basic

Character_Effects
Character_Equipment
Character_Health
Character_Skills

ChoiceMenuHeaders
ChoiceMenuMany
ComponentDebug
CraftMenu_Armor

CraftMenu_Consumables
CraftMenu_Weapons
CubePanel
DebugMenu

Dungeon
EquipSelect
EquipSelectFlow
GameOver

ItemActionDetail
ItemAction_Drop
ItemAction_Eat
ItemAction_Inspect

ItemAction_List
ItemAction_Read
ItemAction_Use
KeyHelp

LoadMenu
LookAround
LookAround_Away
MainMenu

MainMenuOpenSettings
Message
Overworld
OverworldMap

PersistentMessage
RunStats_Environment
RunStats_Table
SaveMenu

SettingsMenu
SettingsMenuClose
Shooting
ShopMenu_Buy

ShopMenu_Sell
StorageMenu_Retrieve
StorageMenu_Store

各画像はゴールデンテストで自動生成される。

キーボード操作

ダンジョン探索

移動

キー 動作
↑ / ↓ / ← / → 上下左右の移動
Shift + 矢印2方向 斜め移動
. (ピリオド) その場で待機

行動

キー 動作
Enter 足元・隣接の対象と相互作用する
Space インタラクションメニューを開く
G 足元のアイテムを拾う
F 射撃モード
1〜5 武器スロットの切り替え

動詞コマンド（アイテム操作画面を開く）

キー 動作
Shift + X 調べる
D 置く
E 食べる・飲む
R 読む
T 使う

画面・情報

キー 動作
M ダンジョンメニュー
L フィールド情報
N オーバーワールド地図（オーバーワールドにいるときのみ）

カメラ操作

キー 動作
Z / C カメラを45度ずつ左回り / 右回りに回転
PageDown ズームアウト
PageUp ズームイン

メニューナビゲーション

キー 動作
↑ / ↓ 項目の上下移動
← / → グリッド表示時の左右移動
Tab 次の項目へ移動
Shift + Tab 前の項目へ移動
Enter 項目選択・決定
Escape キャンセル・戻る

開発

依存関係はDockerfileを参考にする。

$ make help

設計ドキュメントの状況

docs/design の frontmatter から自動生成される。go run . designdoc list で絞り込める。

status ドキュメント 進捗 tags
in-progress 通信販売: オークション形式の販売機構 5/6（見送り2） gamedesign, item, ui
in-progress 逓増: 危険と希少性の軸を深さから経過日数へ移す 8/10 gamedesign, worldgen, ecs
in-progress コード監査: worldgen・Ark stale pointer・serde 2026-08-24 4/5 worldgen, ecs, save
draft 難所調査から抽出した自走可能な改善のバックログ 0/11（見送り3） refactor, ci, ecs, combat, meta
draft 施設内装の生成 —— doc 260725201431.md の未着手バックログ 1/33 worldgen
draft OSS 調査 2026-08 0/5 meta, worldgen, combat, ui
draft 天気システムを設計する 0/7 gamedesign, worldgen, ecs
draft コード監査: ダンジョン生成・戦闘継続・UI描画 2026-08-10 0/5 worldgen, combat, item, ui, ecs
draft 使う・送る・捨てる: 通信販売による第二の需要をコアに足す 0/0 gamedesign, narrative
draft 背の低い家具を通行可能にして移動コストで体系化する 0/7（見送り1） movement, combat, gamedesign
draft 腐敗システムの将来拡張 0/4 item, gamedesign
draft コード監査: 通信販売・食料鮮度・AI追跡・命中判定 2026-08-17 0/5（見送り1） item, combat, ecs
draft 身体の不調: 少数部位の負傷と、まとめて配る手当て 0/11 gamedesign, combat, item, ecs
draft すべての地物・施設を役割テンプレ骨格と content スロットで生成する 0/8 worldgen, refactor, gamedesign

Reference

ゲーム作成で参考にしたコード等。

使用した素材類。

フォント。

画像。

Documentation

Overview

Package main はRuinsゲームのエントリーポイント

Source Files

View all Source files

Directories

Path Synopsis
Package assets は埋め込みゲームアセットを提供する。
 Package assets は埋め込みゲームアセットを提供する。
internal
activity
Package activity はアクションとアクティビティの実装を提供する。
 Package activity はアクションとアクティビティの実装を提供する。
aiinput
Package aiinput はAIエンティティの行動決定と処理を提供する。
 Package aiinput はAIエンティティの行動決定と処理を提供する。
balance
Package balance はゲームバランスのモンテカルロシミュレーションを提供する。
 Package balance はゲームバランスのモンテカルロシミュレーションを提供する。
cmd
Package cmd はコマンドラインインターフェースを提供する。
 Package cmd はコマンドラインインターフェースを提供する。
components
Package components はゲームコンポーネントの定義と実装を提供する。
 Package components はゲームコンポーネントの定義と実装を提供する。
components/genspec
Package genspec はコンポーネント定義の単一登録表(Registry)を提供する。
 Package genspec はコンポーネント定義の単一登録表(Registry)を提供する。
config
Package config はアプリケーションの設定管理を提供する
 Package config はアプリケーションの設定管理を提供する
consts
Package consts はゲーム全体で使用される定数と色設定を提供する。
 Package consts はゲーム全体で使用される定数と色設定を提供する。
designdoc
Package designdoc は docs/design 下の設計ドキュメントの frontmatter を扱う。
 Package designdoc は docs/design 下の設計ドキュメントの frontmatter を扱う。
dungeon
Package dungeon はダンジョン定義と選択システムを提供する。
 Package dungeon はダンジョン定義と選択システムを提供する。
engine/components
Package components はコアエンジンコンポーネントの定義を提供する。
 Package components はコアエンジンコンポーネントの定義を提供する。
engine/resources
Package resources はゲームエンジンのリソース管理機能を提供する。
 Package resources はゲームエンジンのリソース管理機能を提供する。
engine/states
Package states provides state management functionality.
 Package states provides state management functionality.
engine/world
Package world provides world management functionality.
 Package world provides world management functionality.
formula
Package formula は戦闘計算の定数と純粋関数を提供する。
 Package formula は戦闘計算の定数と純粋関数を提供する。
gamelog
Package gamelog はゲームログ機能を提供する。
 Package gamelog はゲームログ機能を提供する。
geometry
Package geometry は純粋な2D座標計算を提供する。
 Package geometry は純粋な2D座標計算を提供する。
hooks
Package hooks はReact風の状態管理フックを提供する。
 Package hooks はReact風の状態管理フックを提供する。
i18n
Package i18n は国際化のマスタデータと訳引きを担う。
 Package i18n は国際化のマスタデータと訳引きを担う。
input
Package input は入力処理機能を提供する。
 Package input は入力処理機能を提供する。
inputmapper
Package inputmapper はアクション定義とキー入力マッピングを提供する。
 Package inputmapper はアクション定義とキー入力マッピングを提供する。
keybind
Package keybind はキーボード入力を Action へ変換し、再生時は world の供給源へ差し替える。
 Package keybind はキーボード入力を Action へ変換し、再生時は world の供給源へ差し替える。
loader
Package loader はゲームリソースの読み込み機能を提供する。
 Package loader はゲームリソースの読み込み機能を提供する。
logger
Package logger はゲーム内の構造化ログを提供する
 Package logger はゲーム内の構造化ログを提供する
maingame
Package maingame はメインゲームの実装を提供する。
 Package maingame はメインゲームの実装を提供する。
mapplanner
Package mapplanner provides map planning functionality.
 Package mapplanner provides map planning functionality.
mapplanner/interior
Package interior は施設内装の content システムを担う。
 Package interior は施設内装の content システムを担う。
mapspawner
Package mapspawner はMetaPlanに基づいてECSエンティティを生成する機能を提供する
 Package mapspawner はMetaPlanに基づいてECSエンティティを生成する機能を提供する
maptemplate
Package maptemplate はマップテンプレートの読み込み機能を提供します。
 Package maptemplate はマップテンプレートの読み込み機能を提供します。
menuloop
Package menuloop はメニュー画面の共通ランタイムを提供する。
 Package menuloop はメニュー画面の共通ランタイムを提供する。
messagedata
Package messagedata はメッセージウィンドウに表示するデータ構造を提供する
 Package messagedata はメッセージウィンドウに表示するデータ構造を提供する
oapi
Package oapi provides primitives to interact with the openapi HTTP API.
 Package oapi provides primitives to interact with the openapi HTTP API.
overworld
Package overworld はオーバーワールドのチャンク生成を、worldstream の帯管理と 実 mapgen の mapplanner/mapspawner へ橋渡しする。
 Package overworld はオーバーワールドのチャンク生成を、worldstream の帯管理と 実 mapgen の mapplanner/mapspawner へ橋渡しする。
raw
Package raw はゲームのローデータ定義とユーティリティを提供する。
 Package raw はゲームのローデータ定義とユーティリティを提供する。
render3d
Package render3d はタイル世界を透視投影で画面へ写す幾何を提供する。
 Package render3d はタイル世界を透視投影で画面へ写す幾何を提供する。
resources
Package resources はゲーム固有のリソース管理機能を提供する。
 Package resources はゲーム固有のリソース管理機能を提供する。
save
Package save は ark-serde によるECSワールドのセーブ・ロードを提供する。
 Package save は ark-serde によるECSワールドのセーブ・ロードを提供する。
screeneffect
Package screeneffect は画面全体に適用するポストプロセスエフェクトを提供する。
 Package screeneffect は画面全体に適用するポストプロセスエフェクトを提供する。
skill
Package skill はスキルの成長計算を提供する。
 Package skill はスキルの成長計算を提供する。
states
Package states はゲームステートの実装を提供する。
 Package states はゲームステートの実装を提供する。
steam
Package steam はSteamworks SDKとの統合を提供する。
 Package steam はSteamworks SDKとの統合を提供する。
systems
Package systems はゲームシステムの実装を提供する。
 Package systems はゲームシステムの実装を提供する。
testutil
Package testutil はテストで共通して使用するユーティリティ関数を提供する。
 Package testutil はテストで共通して使用するユーティリティ関数を提供する。
vrt
Package vrt はビジュアルリグレッションテストの共通基盤を提供する。
 Package vrt はビジュアルリグレッションテストの共通基盤を提供する。
vrt/replay
Package replay は実在メニュー state を本番の MainGame ループで Action 列から駆動する。
 Package replay は実在メニュー state を本番の MainGame ループで Action 列から駆動する。
widgets
Package widgets はビジネスロジックと状態管理を持つ高レベルUIコンポーネントを提供する。
 Package widgets はビジネスロジックと状態管理を持つ高レベルUIコンポーネントを提供する。
widgets/entityspec
Package entityspec はエンティティを組み込んだ、具体的なUIの部品を提供する。
 Package entityspec はエンティティを組み込んだ、具体的なUIの部品を提供する。
widgets/hud
Package hud はHUD（Head-Up Display）統合ウィジェットを提供する。
 Package hud はHUD（Head-Up Display）統合ウィジェットを提供する。
widgets/internal/uicore
Package uicore は UI プリミティブの実体。
 Package uicore は UI プリミティブの実体。
widgets/menuframe
Package menuframe はメニュー UI の部品庫。
 Package menuframe はメニュー UI の部品庫。
widgets/messagelog
Package messagelog はゲームメッセージログの表示ウィジェットを提供する。
 Package messagelog はゲームメッセージログの表示ウィジェットを提供する。
widgets/messagewindow
Package messagewindow はストーリーメッセージ表示用のモーダルウィンドウを提供する
 Package messagewindow はストーリーメッセージ表示用のモーダルウィンドウを提供する
widgets/overlay
Package overlay はメニュー画面の上へ重ねる部品を共通化する。
 Package overlay はメニュー画面の上へ重ねる部品を共通化する。
widgets/pagination
Package pagination はリスト表示のペジネーション機能を提供する
 Package pagination はリスト表示のペジネーション機能を提供する
widgets/styled
Package styled は一覧描画の共通データ型を提供する。
 Package styled は一覧描画の共通データ型を提供する。
widgets/theme
Package theme はUI全体のテーマ定数を一元管理する。
 Package theme はUI全体のテーマ定数を一元管理する。
widgets/ui
Package ui は画面層に公開する UI の構成面。
 Package ui は画面層に公開する UI の構成面。
world
Package world はゲームワールドの実装を提供する。
 Package world はゲームワールドの実装を提供する。
world/gameaction
Package gameaction は query と lifecycle を組み合わせた複合的なゲームロジックを提供する。
 Package gameaction は query と lifecycle を組み合わせた複合的なゲームロジックを提供する。
world/lifecycle
Package lifecycle はエンティティの生成・削除・配置を担う。
 Package lifecycle はエンティティの生成・削除・配置を担う。
world/query
Package query はエンティティの状態読み取り・単純な状態変更・純粋計算を提供する。
 Package query はエンティティの状態読み取り・単純な状態変更・純粋計算を提供する。
world/stage
Package stage はシームレスワールドの複数ステージ共存を操作するプリミティブを提供する。
 Package stage はシームレスワールドの複数ステージ共存を操作するプリミティブを提供する。
worldstream
Package worldstream は無限シームレスワールドの「アクティブ帯」を east 方向へ ストリーミングするための基盤を提供する。
 Package worldstream は無限シームレスワールドの「アクティブ帯」を east 方向へ ストリーミングするための基盤を提供する。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.