-
Notifications
You must be signed in to change notification settings - Fork 0
Troubleshooting
LangPack Studioを使用中に発生する可能性のある問題と解決方法をまとめています。問題が解決しない場合は、GitHubのIssuesページでお知らせください。
症状: ダブルクリックしても何も起こらない 原因:
- Visual C++ Redistributableが不足
- Windows Defenderによるブロック
- 管理者権限が必要
解決方法:
- Microsoft Visual C++ Redistributable をインストール
- Windows Defenderの除外設定に追加
- 右クリック→「管理者として実行」
症状: "開発元を確認できないため開けません" 解決方法:
- システム設定 > プライバシーとセキュリティ
- 「このまま開く」をクリック
- または、ターミナルで
xattr -cr /Applications/LangPack-Studio.app
症状: 実行権限エラー 解決方法:
chmod +x LangPack-Studio.AppImage
./LangPack-Studio.AppImage症状: npm install 時にエラー
解決方法:
# Node.js 18以上をインストール
nvm install 18
nvm use 18
npm install症状: パッケージインストールの失敗 解決方法:
# キャッシュクリアして再インストール
npm cache clean --force
rm -rf node_modules package-lock.json
npm install症状: "サポートされていない形式です" 対応形式:
-
.json(JSON形式) -
.lang(LANG形式)
解決方法:
- ファイル拡張子を確認
- ファイル内容がJSON/LANG形式になっているか確認
- 文字エンコーディングをUTF-8に変更
症状: "ファイルの解析に失敗しました" 原因:
- JSON構文エラー
- 不正な文字が含まれている
- ファイルが不完全
解決方法:
- JSON Validatorでファイルをチェック
- テキストエディタで構文を確認
- バックアップから復元
症状: 10万エントリー以上で動作が重い 解決方法:
- ファイルを分割して処理
- 不要なエントリーを事前に削除
- バッチサイズを小さくする
症状: ファイルが受け付けられない 解決方法:
- 最新版のブラウザを使用
- JavaScript設定を確認
- ファイル選択ボタンを使用
症状: "ファイルにアクセスできません" 解決方法:
- ファイルの読み取り権限を確認
- 管理者権限で実行
- ファイルを別の場所にコピー
症状: "Invalid API key" エラー 解決方法:
- APIキーが正しいか確認
- Cloud Translation APIが有効か確認
- 請求情報が設定されているか確認
症状: "Authentication failed" 解決方法:
- Free/Proプランのキーを正しく使用
- 月間利用制限を確認
- アカウント状態を確認
症状: "Access denied" 解決方法:
- APIキーとリージョンが正しいか確認
- Azureリソースが作成されているか確認
- 適切なサブスクリプションプランか確認
症状: "Rate limit exceeded" 解決方法:
- 使用量制限を確認
- より低いレートでリクエスト
- 上位プランにアップグレード
原因:
- 文脈の理解不足
- 専門用語の未対応
- APIの制限
解決方法:
- 翻訳サービスを変更（DeepL、OpenAI推奨）
- カスタム用語集を作成
- 翻訳後に手動で修正
原因:
- 特殊文字やコードが含まれる
- 文字数制限超過
- APIの制限
解決方法:
- フィルター設定を確認
- 手動で翻訳
- 別のAPIを試す
症状: 途中で翻訳が停止 解決方法:
- インターネット接続を確認
- VPN使用時は無効にしてみる
- ファイアウォール設定を確認
症状: 大量のテキスト処理時にクラッシュ 解決方法:
- バッチサイズを小さくする
- 他のアプリケーションを終了
- PCを再起動
症状: "リソースパック生成に失敗しました" 解決方法:
- 十分な空きディスク容量があるか確認
- 書き込み権限があるフォルダか確認
- ウイルスソフトを一時無効
症状: Minecraftで認識されない 解決方法:
- パックフォーマット番号を確認
- JSON構文をチェック
- Minecraftバージョンとの対応を確認
症状: リストに表示されない 解決方法:
- ファイルを
.minecraft/resourcepacks/に配置 - ZIPファイルが破損していないか確認
- ファイル名に日本語が含まれていないか確認
症状: ゲーム内で英語のまま 原因:
- 言語設定が間違っている
- Modが対応していない
- ファイル構造が間違っている
解決方法:
- Minecraft言語設定を確認
- 対象のModが起動しているか確認
- assets/[modid]/lang/ 構造を確認
症状: レイアウトが崩れる 解決方法:
- ウィンドウサイズを調整
- ズーム設定を100%にする
- ブラウザを再起動
症状: テーマが正しく適用されない 解決方法:
- ヘッダーのテーマボタンをクリック
- ブラウザの設定をリセット
- 開発者ツールでキャッシュクリア
症状: "？？？" や四角が表示される 解決方法:
- システムの言語設定を確認
- フォントが正しくインストールされているか確認
- 文字エンコーディングをUTF-8に設定
症状: 10万エントリー以上で処理が遅い 解決方法:
- データを分割して処理
- 不要な機能を無効化
- システムリソースを確認
症状: 長時間使用で動作が遅くなる 解決方法:
- アプリケーションを再起動
- 大きなファイルを分割
- 他のアプリケーションを終了
場所:
- Windows:
%APPDATA%/LangPack-Studio/backups/ - macOS:
~/Library/Application Support/LangPack-Studio/backups/ - Linux:
~/.config/LangPack-Studio/backups/
- バックアップフォルダを確認
- 最新のファイルを復元
- 手動でファイルを再インポート
Windows:
rmdir /s %APPDATA%\LangPack-StudiomacOS/Linux:
rm -rf ~/.config/LangPack-Studio- 既存のアプリケーションをアンインストール
- 設定フォルダを削除
- 最新版を再インストール
問題が解決しない場合は、以下の情報を含めてIssueを作成してください：
## 環境情報
- OS: Windows 11 / macOS 14.0 / Ubuntu 22.04
- LangPack Studio バージョン: v1.0.0
- Node.js バージョン: 18.17.0
## 問題の詳細
- 何をしようとしていたか
- 期待する結果
- 実際に起こったこと
- エラーメッセージ（あれば）
## 再現手順
1. ...
2. ...
3. ...
## スクリーンショット
（可能であれば添付）場所:
- Windows:
%APPDATA%/LangPack-Studio/logs/ - macOS:
~/Library/Logs/LangPack-Studio/ - Linux:
~/.local/share/LangPack-Studio/logs/
含めるべき情報:
-
main.log: メインプロセスのログ -
renderer.log: UIプロセスのログ -
error.log: エラーログ
このトラブルシューティングガイドで問題が解決しない場合は、遠慮なくサポートチームまでお問い合わせください。可能な限りサポートいたします。