راه‌انداز یکپارچه برای بازی‌های ویندوز در لینوکس (umu) به این منظور ایجاد شده است تا ابزار Proton[2] شرکت Valve و پروژهٔ protonfixes[3] را خارج از کلاینت Steam در دسترس قرار دهد، و روشی استاندارد برای سایر کلاینت‌ها (مانند Lutris، Heroic Games Launcher، Bottles یا Rare) به‌منظور اجرای بازی‌ها از طریق Proton و پیکربندی پیشوندهای WINE فراهم آورد.

در نتیجه، کلاینت‌ها:

دیگر نیازی به نصب بودن Steam یا فایل‌های اجرایی باینری Steam ندارند
می‌توانند در توسعهٔ protonfixes مشارکت کرده و به‌طور خودکار از آن بهره‌مند شوند
می‌توانند بازی‌ها را از طریق Proton طوری اجرا کنند که گویی یک بازی بومی Steam است
می‌توانند به یک پایگاه داده برخط و یکپارچه از رفع اشکال‌های بازی (protonfixes) ارجاع دهند

می‌توانید umu را مستقیماً از یک شبیه‌ساز ترمینال یا در صورت پشتیبانی، از طریق راه‌انداز دلخواه خود اجرا کنید.

مثال‌ها (EXAMPLES)

مثال ۱. اجرای یک بازی

$ WINEPREFIX=~/.wine PROTONPATH=~/GE-Proton9-4 umu-run foo.exe

مثال ۲. اجرای یک بازی و اعمال یک protonfix مشخص

# Applies the Star Citizen fix to the current WINE prefix
$ WINEPREFIX=~/.wine GAMEID=umu-starcitizen PROTONPATH=~/GE-Proton9-4 umu-run foo.exe

مثال ۳. اجرای یک بازی از طریق فایل پیکربندی

# config.toml
[umu]
prefix = "~/.wine"
proton = "~/GE-Proton30"
game_id = "0"
exe = "~/foo.exe"
launch_args = ["-opengl", "-SkipBuildPatchPrereq"]
store = "gog"
$ umu-run --config config.toml

مثال ۴. ایجاد یک پیشوند WINE برای umu

$ WINEPREFIX=~/foo PROTONPATH=~/GE-Proton9-4 umu-run ""

مثال ۵. اجرای یک بازی و تنظیم خودکار Proton

# Uses the latest UMU-Proton and automatically removes old UMU-Proton builds
$ WINEPREFIX=~/.wine umu-run foo.exe

مثال ۶. اجرای یک بازی، تنظیم خودکار Proton و ایجاد پیشوند WINE

# Creates the prefix as $HOME/Games/umu/umu-default and uses the latest UMU-Proton
$ umu-run foo.exe

مثال ۷. اجرای یک بازی و تعیین صریح یک دستور معتبر Proton

$ WINEPREFIX=~/.wine GAMEID=0 PROTONPATH=~/GE-Proton9-4 PROTON_VERB=waitforexitandrun umu-run foo.exe

مثال ۸. اجرای یک بازی و فعال‌سازی لاگ‌های اشکال‌زدایی

$ UMU_LOG=debug WINEPREFIX=~/.wine PROTONPATH=~/GE-Proton9-4 umu-run foo.exe

مثال ۹. اجرای یک بازی و تعیین Proton با نام نگارش آن

# Checks for GE-Proton9-1 at $HOME/.local/share/Steam/compatibilitytools.d
$ WINEPREFIX=~/.wine PROTONPATH=GE-Proton9-1 umu-run foo.exe

مثال ۱۰. اجرای یک بازی و استفادهٔ خودکار از جدیدترین GE-Proton

$ WINEPREFIX=~/.wine PROTONPATH=GE-Proton umu-run foo.exe

مثال ۱۱. اجرای دستورات winetricks

$ PROTONPATH=GE-Proton umu-run winetricks quartz wmp11 qasf

مثال ۱۲. اجرای یک بازی بدون اعمال protonfixes

$ GAMEID=umu-genshin PROTONPATH=GE-Proton PROTONFIXES_DISABLE=1 umu-run foo.exe

متغیرهای محیطی (ENVIRONMENT VARIABLES)

GAMEID

اختیاری. می‌تواند یک مقدار دلخواه یا یک شناسهٔ معتبر در umu-database[4] باشد. در صورت تعیین‌نشدن، به‌طور پیش‌فرض برابر با umu-default است (هیچ وصله‌ای را به‌طور خودکار اعمال نمی‌کند).

PROTONPATH

اختیاری. مسیر دایرکتوری Proton، نام نگارش (مانند GE-Proton9-5) یا نام رمز (مانند GE-Proton).

در غیر این صورت، به‌طور پیش‌فرض از UMU-Proton استفاده می‌شود.

نام‌های رمز معتبر عبارتند از: GE-Proton

WINEPREFIX

اختیاری. مسیر دایرکتوری پیشوند WINE. در غیر این صورت، پیش‌فرض $HOME/Games/umu/$GAMEID خواهد بود. اگر هیچ GAMEID مشخص نشده باشد، پیش‌فرض برابر با $HOME/Games/umu/umu-default است.

UMU_LOG

اختیاری. لاگ‌های اشکال‌زدایی را برای راه‌انداز فعال می‌کند.

برای فعال‌سازی همهٔ لاگ‌ها، مقدار را برابر با 1 قرار دهید.

STORE

اختیاری. می‌تواند یک مقدار دلخواه یا یک شناسهٔ معتبر فروشگاه در umu-database باشد.

PROTON_VERB

اختیاری. باید یک فعل/دستور (verb) معتبر در Proton باشد. در غیر این صورت، به‌طور پیش‌فرض برابر با waitforexitandrun است.

UMU_RUNTIME_UPDATE

اختیاری. به‌روزرسانی‌های خودکار Steam Linux Runtime[5] را غیرفعال می‌کند.

برای غیرفعال‌سازی به‌روزرسانی‌ها، مقدار را برابر با 0 قرار دهید.

UMU_NO_PROTON

اختیاری. فایل اجرایی را به‌صورت بومی درون Steam Linux Runtime اجرا می‌کند. برای بازی‌های بومی لینوکس در نظر گرفته شده است.

برای اجرای فایل اجرایی به‌صورت بومی درون SLR، مقدار را برابر با 1 قرار دهید.

UMU_HTTP_TIMEOUT

اختیاری. مهلت زمانی بر حسب ثانیه را برای هر درخواست HTTP تعیین می‌کند. در غیر این صورت، پیش‌فرض 5 است.

برای غیرفعال کردن مهلت زمانی درخواست‌های HTTP، مقدار را 0 قرار دهید. برای لغو مقدار پیش‌فرض، یک عدد صحیح مثبت تعیین کنید.

UMU_HTTP_RETRIES

اختیاری. تعداد دفعات تلاش مجدد برای خطاهای احتمالی کاذب شبکه. در غیر این صورت، پیش‌فرض 3 است.

برای غیرفعال‌سازی تلاش مجدد درخواست‌های HTTP، مقدار را برابر با 0 قرار دهید. برای لغو مقدار پیش‌فرض، یک عدد صحیح مثبت تعیین کنید.

همچنین ببینید (SEE ALSO)

umu(5), winetricks(1)

نکات (NOTES)

1.: https://github.com/Winetricks/winetricks
2.: https://github.com/ValveSoftware/Proton
3.: https://github.com/Open-Wine-Components/umu-protonfixes
4.: https://github.com/Open-Wine-Components/umu-database
5.: https://gitlab.steamos.cloud/steamrt/steam-runtime-tools/-/blob/main/docs/container-runtime.md

نویسندگان (AUTHORS)

توسط اعضای Open Wine Components نگهداری می‌شود و سایر مشارکت‌کنندگان متن‌باز نیز در آن همکاری داشته‌اند. برای کسب اطلاعات بیشتر دربارهٔ توسعهٔ umu، به https://github.com/Open-Wine-Components/umu-launcher مراجعه کنید.