tModLoader Logo tModLoader / ドキュメント / トラブルシューティング

トラブルシューティングガイド

Solutions to common tModLoader problems and error messages

15 分で読める トラブルシューティング Updated Sept 2025

Quick Solutions

Try these common fixes first before diving into specific issues:

すべてを再起動

Close tModLoader completely and restart. This fixes 50% of issues.

すべてのModを無効化

Disable all mods and enable them one by one to find conflicts.

インストールの問題

tModLoaderが起動しない

Windowsの解決策:

  • Install .NET Framework 4.7.2 or later
  • Install Visual C++ Redistributable 2015-2022
  • Run as Administrator
  • Add exception to Windows Defender/antivirus
  • Verify Terraria installation integrity

macOS/Linuxの解決策:

  • Install Mono framework (6.0 or later)
  • Check file permissions: chmod +x tModLoader
  • Install required system libraries
  • Try running from terminal to see error messages

Steam-Specific Issues

ライブラリに表示されない

  • Refresh your Steam library
  • Check if download completed successfully
  • Restart Steam client
  • Verify you installed tModLoader, not just added to wishlist

Steam Workshopが動作しない

  • Ensure you're logged into Steam
  • Check Steam community features are enabled
  • Try restarting Steam in online mode
  • Clear Steam download cache

Mod関連の問題

Mod Conflicts and Crashes

問題のあるModの特定

  1. Disable all mods and start with a clean slate
  2. Enable mods one by one, testing after each
  3. When crash occurs, the last enabled mod is likely the culprit
  4. Check mod descriptions for known incompatibilities

Common Conflict Types:

  • Recipe conflicts: Multiple mods changing the same recipes
  • ID conflicts: Mods using the same item/NPC IDs
  • Version incompatibility: Mods designed for different tModLoader versions
  • Dependency issues: Missing required mods or libraries

Performance Issues

低FPSの解決策

  • Reduce graphics settings in Terraria
  • Disable resource-heavy mods
  • Close background applications
  • Update graphics drivers

メモリの問題

  • Limit number of active mods
  • Increase virtual memory
  • Close other programs
  • Consider 64-bit system upgrade

マルチプレイヤーの問題

Cannot Connect to Friends

Mod同期

All players must have the exact same mods enabled:

  • Same mod versions
  • Same mod load order
  • No client-side only mods on server

一般的な解決策

  • Host creates and shares a modpack
  • All players download the same modpack
  • Verify mod list matches exactly
  • Restart both client and server after mod changes

Common Error Messages

System.DllNotFoundException

This error indicates missing system libraries.

解決策:

  • Install Visual C++ Redistributable (Windows)
  • Update to latest Windows version
  • Install missing system dependencies
  • Run Windows Update

System.OutOfMemoryException

The game has run out of available memory.

解決策:

  • Reduce number of active mods
  • Close other applications
  • Increase virtual memory/page file
  • Upgrade system RAM if possible
  • Use 64-bit operating system

Mod Loading Errors

Errors when loading or building mods.

一般的な原因と解決策:

  • Missing dependencies: Install required mod libraries
  • Version mismatch: Update mods to latest compatible versions
  • Corrupted mod files: Re-download and reinstall the mod
  • Invalid mod structure: Verify mod file structure is correct

パフォーマンス最適化

Improve FPS

  • Lower Terraria graphics settings
  • Disable lighting effects
  • Reduce particle effects
  • Use performance-optimized mods
  • Close unnecessary background programs

Reduce Memory Usage

  • Limit active mods to essential ones
  • Avoid texture packs with high-res textures
  • Clear mod cache periodically
  • Restart game session every few hours
  • Use mods designed for performance

追加のヘルプを取得

効果的に問題を報告する方法

ヘルプを求める際にこれらの詳細を含めてください:

  • tModLoaderのバージョン番号
  • オペレーティングシステムとバージョン
  • 有効なModの完全なリスト
  • Exact error message (if any)
  • 問題を再現するための手順
  • Logsフォルダからのログファイル

よくある質問

Can I use tModLoader with pirated Terraria?

No. tModLoader requires a legitimate copy of Terraria to function. We do not support or assist with pirated versions.

Will my vanilla Terraria saves work with tModLoader?

Yes, tModLoader can load vanilla Terraria worlds and characters. However, content added by mods will not be available in vanilla Terraria.

How do I update tModLoader?

Steam version updates automatically. For manual installations, download the latest version from GitHub and replace your existing installation.

Can I play online with modded Terraria?

Yes, but all players must have tModLoader installed with the exact same mods enabled. Vanilla players cannot join tModLoader servers.

Where are my mod files stored?

Mod files are stored in:

  • Windows: Documents/My Games/Terraria/tModLoader/
  • macOS: ~/Library/Application Support/Terraria/tModLoader/
  • Linux: ~/.local/share/Terraria/tModLoader/

まだヘルプが必要ですか?

If you couldn't find a solution here, don't worry! Our community is here to help.