メインコンテンツまでスキップ

hmcs mod

MOD パッケージの一覧表示、インストール、アンインストールを行います。

クイック例​

hmcs mod list
hmcs mod install @hmcs/assets @hmcs/elmer
hmcs mod uninstall @hmcs/assets

list​

構文​

hmcs mod list

引数​

このサブコマンドには引数はありません。

例​

成功：

 NAME           VERSION  DESCRIPTION
 @hmcs/elmer    1.0.0    Default character model
 @hmcs/menu     1.0.0    Context menu

インストール済み MOD がない場合：

（出力なし）

失敗例：

[stderr]
...pnpm ls failed...

動作​

  • 設定された mods ディレクトリからインストール済み MOD のメタデータを一覧表示します。
  • 内部的に pnpm -C <mods_dir> ls --parseable -P --depth 0 を使用します。

関連​

install​

構文​

hmcs mod install <package>...

引数​

名前必須説明
packageはい1つ以上のパッケージ指定子（例：@hmcs/elmer や pkg@version）。

例​

成功：

hmcs mod install @hmcs/assets @hmcs/elmer

失敗例（無効なパッケージ名）：

hmcs mod install 'foo;rm -rf /'
[stderr]
invalid package name: contains forbidden characters: foo;rm -rf /

失敗例（pnpm add 失敗）：

[stderr]
pnpm add failed with status: ...

動作​

  • pnpm を呼び出す前にパッケージ名を検証します。
  • 設定された mods_dir にインストールします。
  • 検証またはインストール失敗時にゼロ以外で終了します。

関連​

uninstall​

構文​

hmcs mod uninstall <package>...

引数​

名前必須説明
packageはい1つ以上のインストール済みパッケージ名。

例​

成功：

hmcs mod uninstall @hmcs/assets @hmcs/elmer

失敗例（無効なパッケージ名）：

hmcs mod uninstall '../etc/passwd'
[stderr]
invalid package name: contains path traversal: ../etc/passwd

失敗例（pnpm remove 失敗）：

[stderr]
pnpm remove failed with status: ...

動作​

  • pnpm を呼び出す前にパッケージ名を検証します。
  • 設定された mods_dir からパッケージを削除します。
  • 検証またはアンインストール失敗時にゼロ以外で終了します。

関連​