How to use Godot on Linux?

Instructions about using Godot on Linux written in Simplified-Chinese.

# 在 Linux 上使用 Godot 引擎时，需关注系统兼容性、驱动依赖、输入设备、权限配置等多个维度

sudo apt install nvidia-driver-550 # （Ubuntu/Debian）安装NVIDIA官方驱动，适合NVIDIA显卡
sudo apt install mesa-vulkan-drivers #（Ubuntu/Debian）安装Mesa系列官方驱动，适合AMD和Intel显卡/核显

# 安装Godot的必要Linux依赖库

sudo apt install libx11-6 libgl1-mesa-glx libxcursor1 libxinerama1 libxi6 libxrandr2 libxss1 libasound2 # Ubuntu/Debian
sudo pacman -S libx11 libgl libxcursor libxinerama libxi libxrandr libxss alsa-lib # Arch/Manjaro
sudo dnf install libX11 libglvnd libXcursor libXinerama libXi libXrandr libXScrnSaver alsa-lib # Fedora

# 安装游戏手柄支持（依赖joyutils或SDL2）

sudo apt install joystick # Ubuntu/Debian
sudo pacman -S sdl2 # Arch

# 注意：若手柄映射异常，可通过 Steam 的protontricks工具配置，或使用 antimicrox自定义映射。

# user:// 路径权限
# Godot 的user://路径默认指向~/.local/share/godot/app_userdata/项目名/，需确保该目录对当前用户有读写权限。
# 若因权限问题无法保存数据，可手动创建目录并赋予权限：
# （这里以一个名为MyGame的Godot项目为例）

mkdir -p ~/.local/share/godot/app_userdata/MyGame
chmod 755 ~/.local/share/godot/app_userdata/MyGame

# 若项目使用视频或音频文件，需确保系统安装对应的编解码器（如gstreamer插件）

sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad # Ubuntu/Debian

# 注意：Linux 的音频系统（ALSA、PulseAudio）可能导致音频延迟或卡顿，
# 可在 Godot 的项目设置（Project Settings...）→音频（Audio）→输出后端/音频驱动（Driver）中切换为PulseAudio或ALSA，并测试效果。

# 终端输出与日志
# Linux 下 Godot 的错误日志会直接输出到终端，
# 启动时可通过命令行查看详细信息，便于调试：

./godot.x86_64 --verbose # 启用详细日志