mirror of
https://github.com/the-sane/lug-helper.git
synced 2025-07-01 15:00:35 +00:00
Compare commits
392 Commits
v1.2
...
568f24a15c
Author | SHA1 | Date | |
---|---|---|---|
568f24a15c | |||
6decb35252 | |||
5d83992d05 | |||
1b886fb47f | |||
768a2f93a4 | |||
9378f9c796 | |||
83186e7eb0 | |||
bd473f1f32 | |||
0e47101cfe | |||
c0c0728e38 | |||
c1591f15cb | |||
5c70243448 | |||
0cf1fdc669 | |||
a70d2426ad | |||
e6d79125a6 | |||
c1dae30e5e | |||
69d402cb10 | |||
1f826de2c6 | |||
bc3d7d8fe7 | |||
73c4f7346d | |||
9f9480b99d | |||
342a8ebc2b | |||
239ea780cb | |||
c1fd44eef6 | |||
636c55cf81 | |||
6ddf8e6532 | |||
e9390c5182 | |||
7ee873d2bb | |||
f7580b8fdc | |||
56f61bcb35 | |||
8e5193c173 | |||
36047d7ca5 | |||
04819899fc | |||
514b176e14 | |||
c20bf59ed9 | |||
0fa37aa7e7 | |||
e05f9e18c3 | |||
d034b9bb15 | |||
b399ca7fab | |||
2dd9b51ab1 | |||
dd9bfc3351 | |||
b009265951 | |||
394cfa9392 | |||
5b2e202b4f | |||
0de4032a41 | |||
1acd82b411 | |||
dc48c7acac | |||
d5c3cd66a0 | |||
7d005f2070 | |||
83a90d35f1 | |||
f3a632ec60 | |||
ea4e88d5b2 | |||
5354d498c0 | |||
6af87bb231 | |||
2343bfb733 | |||
464dbe47d7 | |||
0d90486527 | |||
2c6217da60 | |||
1c58b24ed6 | |||
c04b4ca2c2 | |||
6899d3d94b | |||
1ef7e0658d | |||
3b90ed90d0 | |||
946526dcee | |||
278abeb63d | |||
8e55eda9bb | |||
293e994341 | |||
99048021bb | |||
adc627f43c | |||
e1e746cd8f | |||
ffd4d9d3ca | |||
fdfd512bfc | |||
8f86d37b88 | |||
677a789ab5 | |||
1fe9af78b1 | |||
03cf7a9aa0 | |||
7d342416f7 | |||
1a1c3cf0b8 | |||
5cfb306289 | |||
80017b848e | |||
80db33be07 | |||
c497f8e1d8 | |||
eedb5de460 | |||
3a7e0996b5 | |||
402b22ea45 | |||
10812a622d | |||
f5abb87cb5 | |||
bd119c4ce8 | |||
02d8f4b685 | |||
bef1c34491 | |||
7090acf1eb | |||
883163843e | |||
6a665bceac | |||
1844bfda13 | |||
f78f54ddf7 | |||
167edab6ec | |||
1b334db7cc | |||
dc648a8f6f | |||
7426d0ffb3 | |||
1cb9eb6488 | |||
a8c4257430 | |||
b2f542e029 | |||
17b1bfe140 | |||
f19faa8235 | |||
7cc4cca62d | |||
8f857476d0 | |||
652c2fa4a0 | |||
6e4feecc85 | |||
0e5fe688eb | |||
8d130668d6 | |||
142e09800f | |||
1ae94e9b50 | |||
747c799a8b | |||
ba907c44bf | |||
e7a3b30564 | |||
38e646578a | |||
d0dc44dcd9 | |||
9986f1fe8c | |||
bc11c184d2 | |||
02a79aa859 | |||
2eabf019a6 | |||
bdb71475a8 | |||
c627666705 | |||
65ac8ae4cd | |||
b4d9598fe5 | |||
dd81f24be3 | |||
f99fe9b996 | |||
dffa971dc1 | |||
fe1733542d | |||
d6d28f1481 | |||
eb48d00396 | |||
f072378617 | |||
d6376ff9fa | |||
28051a135a | |||
44b1332782 | |||
10c5438189 | |||
57df0a8dd9 | |||
f67c76be2e | |||
d9d58702d1 | |||
3d6e4cc367 | |||
3932fd2754 | |||
314a1ff5ea | |||
26f1377506 | |||
b71f601547 | |||
717a83a512 | |||
ae25785a41 | |||
2f45058e58 | |||
33b8643d47 | |||
faa047546b | |||
5ef3a95a2a | |||
37e487d296 | |||
ab9155b9b8 | |||
7b7347dd64 | |||
9a2c064a06 | |||
6ef58adc12 | |||
3b3abbe8ea | |||
da1fc66571 | |||
bc5d5c4a9b | |||
deb84dd757 | |||
fc70cdc687 | |||
21444076de | |||
4b32177e97 | |||
b4762d4724 | |||
37c94af2ed | |||
6d56599e2f | |||
9909221dff | |||
a328b465ef | |||
8e28327e0f | |||
156a0884d4 | |||
809efb6a54 | |||
5afa8e7c19 | |||
49079818f6 | |||
227038a289 | |||
8f53957f3c | |||
662d78a021 | |||
d10a84c5fe | |||
35e63f5bd5 | |||
f3166c77da | |||
707211962f | |||
5df5cb210d | |||
bf36fc96a9 | |||
702c678716 | |||
dedefebd2d | |||
d24e8b590b | |||
3daeb0b3b1 | |||
e8c93196ff | |||
1561e1a9f6 | |||
a0110720f6 | |||
c1af0383f2 | |||
74c5bd2275 | |||
48d49dd438 | |||
f080ae2bca | |||
72677ff7d5 | |||
42f9992abf | |||
786e3f4c13 | |||
08285946c8 | |||
dafc53615d | |||
3f72676c71 | |||
3d7702dfdd | |||
7ae0bcf330 | |||
8ce1a9a8ea | |||
431df4aabd | |||
9f2c72042e | |||
25b122e891 | |||
a76c3d0a1a | |||
25a773602e | |||
d5d7f75dde | |||
44bcbf8161 | |||
acad90a0a5 | |||
77c6fd46bb | |||
5c112831e0 | |||
274c674681 | |||
cf491f9151 | |||
199e548767 | |||
8087ffe564 | |||
b2b2312ce9 | |||
4ad9603aa3 | |||
709cb6dbae | |||
810f21415e | |||
3e982b3303 | |||
cfeb3a841f | |||
60af93add3 | |||
b64eaf88c5 | |||
e8d96c45a0 | |||
d8826f608c | |||
07a99d3aa1 | |||
b4791a0b7d | |||
e43a59ce7b | |||
fc98118ac5 | |||
4fd9fec8f7 | |||
130704107b | |||
15cad464e3 | |||
cabfd03c29 | |||
33170fae78 | |||
b701ea5e3d | |||
05d75ec82f | |||
2f97a8eb2d | |||
cb3fc5d0d7 | |||
c42d459ef2 | |||
675621c4c3 | |||
c07e673c0d | |||
b85df29d6d | |||
7f3d84a8bc | |||
6533cf98bd | |||
c7c8cd1ecd | |||
e0d149494d | |||
9800420d73 | |||
eae146ce02 | |||
b4248fb264 | |||
d5dbec7b3f | |||
d4e8298743 | |||
8ee730bf35 | |||
b6eea7b224 | |||
c9c3c07866 | |||
2e883423d3 | |||
12a3a51eb4 | |||
aec6ffbfc0 | |||
96b15262f5 | |||
9986f62566 | |||
a2397c28f0 | |||
e8891b42e6 | |||
52f602498e | |||
9279c68d69 | |||
45e5f586dd | |||
9d532f3ac5 | |||
ce7031e873 | |||
8492cdc3a2 | |||
b22e84887e | |||
bfc2822a35 | |||
dfe15f8e78 | |||
8a27a77579 | |||
28edb3393e | |||
978e0adc92 | |||
1ae2d6e4b4 | |||
ae7c407b19 | |||
5caea10a6b | |||
c6b56ac98b | |||
407db0bbcf | |||
70f282d012 | |||
0018591192 | |||
e3d6e4db68 | |||
ca2ce556aa | |||
8e922ae0ef | |||
1d4ff8375e | |||
8bd3a165de | |||
1670c3ccf7 | |||
348bcfe0e4 | |||
5850ec847b | |||
829610b13e | |||
f91422a8c4 | |||
12d9e205f7 | |||
d4c3015a22 | |||
f6ea8c04c7 | |||
b7a36a872b | |||
4a4d8a0f2a | |||
2dd81588b2 | |||
7b7460fa0d | |||
478ff37b8a | |||
1840983431 | |||
693edd56fa | |||
a0d60cf0ee | |||
371accc92c | |||
9af012eaaf | |||
870091faaa | |||
2c6cceb60f | |||
32e4dae92e | |||
7ebaa6d2d2 | |||
8bea7dc005 | |||
5107076b2f | |||
3cf15be6de | |||
7e30f706fc | |||
bc39507e48 | |||
9d8e17bd2a | |||
fe2b9f56c0 | |||
7a4de1ad21 | |||
4b924ba068 | |||
b66d1554e9 | |||
ec3027bc28 | |||
ec794a0fd2 | |||
762c069fb5 | |||
9689a4a60b | |||
6895313492 | |||
0e454883e9 | |||
0ef2481e70 | |||
3a9b4194e0 | |||
9be4f45449 | |||
7d667343d3 | |||
1aa6c3f4c2 | |||
0c80a1f132 | |||
bc608f7ac4 | |||
d2983fa519 | |||
8e6fe1225d | |||
41210bfd1c | |||
71df862879 | |||
2b94fd5e68 | |||
ee5da5d348 | |||
7f9ad04753 | |||
37762b9075 | |||
82c5ccbbab | |||
669ee6eb91 | |||
7c0fbc65b7 | |||
62477143f2 | |||
35fd12b672 | |||
ff30d8d557 | |||
ec860270bb | |||
3ea9fb0f35 | |||
7f7b63caeb | |||
86604f2b7d | |||
5a00c74ddc | |||
089f69ef06 | |||
9e79fd68e0 | |||
d42207d521 | |||
5c55e6795c | |||
5db7fef24c | |||
08f8f1e07c | |||
707d1ad47d | |||
f2dfda5c5b | |||
debf799dad | |||
0d7e4ea2b3 | |||
aaccca1dc9 | |||
b378de0b9e | |||
61e14ed4de | |||
2cdef0f1c4 | |||
d20fc859e1 | |||
4cc8e3331c | |||
a5d372a43b | |||
48582c3a22 | |||
363be810aa | |||
467e1b7164 | |||
85c1f62c22 | |||
758f106efd | |||
43d2b467e8 | |||
aa60600807 | |||
02338ff299 | |||
a2594c3af3 | |||
e63893f50a | |||
fa14c6d9de | |||
8f3efd0b9c | |||
6d7c84c8b6 | |||
c12509bc0c | |||
224c531d64 | |||
32fdc04ec7 | |||
20eb8e984a | |||
0df2659e54 | |||
4a0b053a68 | |||
26030a6c82 | |||
9c44505d27 | |||
7f0f12e61b | |||
da8c63fdcf | |||
6e27ae8449 | |||
be533e842b | |||
dfc2b4f573 |
94
README.md
94
README.md
@ -1,39 +1,85 @@
|
||||
# lug-helper
|
||||
# LUG Helper
|
||||
**Star Citizen's Linux Users Group Helper Script**
|
||||
|
||||
https://robertsspaceindustries.com/orgs/LUG
|
||||
|
||||
*Greetings, fellow Penguin!*
|
||||
### *Greetings, fellow Penguin!*
|
||||
_**This script is designed to help you manage and optimize Star Citizen on Linux.**_
|
||||
|
||||
This script is designed to help you optimize your system to run Star Citizen as smoothly as possible. It presents options to check your system for optimal settings and helps you change them as needed to prevent game crashes.
|
||||
Zenity menus are used for a GUI experience with a fallback to terminal-based menus where Zenity is unavailable.
|
||||
Command line arguments are available for quickly launching functions from the terminal.
|
||||
|
||||
It also gives you a fast and easy way to wipe your Star Citizen *USER* folder as is recommended by CIG after major version updates. It will back up your exported keybinds, delete your *USER* folder, then restore your keybind file(s).
|
||||
|
||||
Zenity menus are used for a GUI experience with a fallback to terminal-based menus where Zenity is unavailable. The game directory paths provided by the user on first run are saved in *$XDG_CONFIG_HOME/starcitizen-lug*.
|
||||
Configuration is saved in *$XDG_CONFIG_HOME/starcitizen-lug/*
|
||||
Keybinds are backed up to *$XDG_CONFIG_HOME/starcitizen-lug/keybinds/*
|
||||
|
||||
## Options:
|
||||
|
||||
`Check vm.max_map_count for optimal performance`
|
||||
- We recommend setting this to at least 16777216 to give the game access to sufficient memory.
|
||||
- The helper will offer to set it for you or show you the commands to do it yourself.
|
||||
`Preflight Check`
|
||||
- Runs a series of system optimization checks and offers to fix any issues.
|
||||
- Checks that vm.max_map_count is set to at least 16777216.
|
||||
- This sets the maxmimum number of "memory map areas" a process can have. While most applications need less than a thousand maps, Star Citizen requires access to more.
|
||||
- Checks that the hard open file descriptors limit is set to at least 524288.
|
||||
- This limits the maximum number of open files on your system. On some Linux distributions, the default is set too low for Star Citizen.
|
||||
|
||||
`Check my open file descriptors limit`
|
||||
- We recommend setting the hard open files limit to at least 524288.
|
||||
- The helper will offer to set it for you and try to auto-detect the correct method to do so.
|
||||
- It is able to update either */etc/systemd/system.conf* or */etc/security/limits.conf*
|
||||
`Install Star Citizen`
|
||||
- Launches Lutris and uses the bundled json to install Star Citizen
|
||||
|
||||
`Delete my Star Citizen USER folder and preserve my keybinds`
|
||||
- The helper will make backups of any exported keybinds, delete your Star Citizen USER folder, then restore your keybind files.
|
||||
- To export your keybinds from within the game, go to:
|
||||
`Deploy Easy Anti-Cheat Workaround`
|
||||
- Applies the workaround to /etc/hosts and deletes the necessary EAC files
|
||||
|
||||
`Manage Lutris Runners`
|
||||
- Quickly install and delete Lutris wine runners
|
||||
|
||||
`Manage Lutris DXVK Versions`
|
||||
- Quickly install and delete DXVK versions for Lutris
|
||||
|
||||
`Maintenance and Troubleshooting`
|
||||
- `Switch the helper between LIVE and PTU`
|
||||
- Toggle between targeting LIVE or PTU for all of the above options. Defaults to LIVE on each run.
|
||||
|
||||
- `Delete my Star Citizen USER folder and preserve my keybinds`
|
||||
- The helper will make backups of any exported keybinds, delete your Star Citizen USER folder, then restore your keybind files.
|
||||
- To export your keybinds from within the game, go to:
|
||||
- *Options->Keybindings->Control Profiles->Save Control Settings*
|
||||
- To re-import your keybinds from within the game, select them from the list:
|
||||
- To re-import your keybinds from within the game, select them from the list:
|
||||
- *Options->Keybindings->Control Profiles*
|
||||
|
||||
`Delete my shaders only`
|
||||
- Sometimes all you need to do between major version updates is delete your shaders directory.
|
||||
- `Delete my shaders`
|
||||
- It is recommended to delete your shaders directory after each game update.
|
||||
|
||||
`Delete my DXVK cache`
|
||||
- A troubleshooting step that sometimes helps fix various issues and crashes.
|
||||
- `Delete my DXVK cache`
|
||||
- A troubleshooting step that sometimes helps fix various issues and crashes.
|
||||
|
||||
`Switch the helper between LIVE and PTU`
|
||||
- Toggle between targeting LIVE or PTU for all of the above options. Defaults to LIVE on each run.
|
||||
- `Display Helper and Star Citizen directories`
|
||||
- Show all the directories currently in use by both the Helper and Star Citizen.
|
||||
|
||||
- `Reset Helper configs`
|
||||
- Delete the configs saved by the helper in *$XDG_CONFIG_HOME/starcitizen-lug/*
|
||||
|
||||
- `Show the LUG Wiki`
|
||||
- Display a link to the LUG Wiki for help with installation and troubleshooting
|
||||
|
||||
`Get a random Penguin's Star Citizen referral code`
|
||||
- Display a referral code for a random member of the Star Citizen Linux Users Group.
|
||||
|
||||
|
||||
|
||||
## Installation:
|
||||
|
||||
**From Source:**
|
||||
1. Download it! https://github.com/starcitizen-lug/lug-helper/releases
|
||||
2. Extract it!
|
||||
3. Run it!
|
||||
|
||||
**Arch Linux:** https://aur.archlinux.org/packages/lug-helper/
|
||||
|
||||
_Dependencies: **bash**, **coreutils**, **curl**, **polkit** (these should be installed by default on most distributions)_
|
||||
_Optional Dependencies: **zenity** (for GUI)_
|
||||
|
||||
## Contributors:
|
||||
- https://github.com/Termuellinator
|
||||
- https://github.com/pstn
|
||||
- https://github.com/gort818
|
||||
- https://github.com/victort
|
||||
- https://github.com/Wrzlprnft
|
||||
- https://github.com/ananace
|
||||
- Runner Downloader inspired by https://github.com/richardtatum/sc-runner-updater
|
||||
|
2447
lug-helper.sh
2447
lug-helper.sh
File diff suppressed because it is too large
Load Diff
BIN
lug-logo.png
Normal file
BIN
lug-logo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 35 KiB |
102
lug-lutris-install.json
Normal file
102
lug-lutris-install.json
Normal file
@ -0,0 +1,102 @@
|
||||
{
|
||||
"count": 1,
|
||||
"next": null,
|
||||
"previous": null,
|
||||
"results": [
|
||||
{
|
||||
"id": 10872,
|
||||
"game_id": 17622,
|
||||
"game_slug": "star-citizen",
|
||||
"name": "Star Citizen",
|
||||
"year": 2016,
|
||||
"user": "ungarscool1",
|
||||
"runner": "wine",
|
||||
"slug": "starcitizen-lutris-install",
|
||||
"version": "LIVE/PTU",
|
||||
"description": "Welcome to the Star Citizen installer maintained by the Star Citizen LUG!\r\nBefore continuing, please see our Quick Start Guide:\r\nhttps://github.com/starcitizen-lug/information-howtos/wiki\r\n\r\nFor help with the installer or to just hang out, we invite Linux Star Citizen players to join us: https://robertsspaceindustries.com/orgs/LUG/",
|
||||
"notes": "Performance may be choppy for the first couple minutes after visiting a new place or performing a new activity while shaders compile. Subsequent arrival should not be choppy.\r\n\r\nIf you receive a Runtime Error you can continue using Star Citizen by dragging the dialog box to the side, but in-game VoIP and FoIP will cease to function until Star Citizen is restarted. Drop in to the LUG group's chat and forums; we have custom runners to work around this problem.\r\n\r\nPlease make sure you have all Wine dependencies properly installed or your game may crash during start-up. See our wiki linked above for more information and instructions.\r\n\r\nTo prevent crashes in areas with lots of geometry, the game needs a Linux resource limit named \"vm.max_map_count\" increased. If you are following our Quick Start Guide and using our LUG Helper, the Preflight Check will do this for you. To set it manually, execute:\r\n\r\nsudo sysctl -w vm.max_map_count=16777216\r\n\r\nConsult your distro's documentation on how to set this permanently or ask a LUG member.\r\n\r\nSee you in the 'verse!",
|
||||
"credits": "",
|
||||
"created_at": "2018-11-15T17:43:07.367000Z",
|
||||
"updated_at": "2023-02-08T15:20:16.896420Z",
|
||||
"draft": false,
|
||||
"published": true,
|
||||
"published_by": 64834,
|
||||
"rating": "",
|
||||
"is_playable": null,
|
||||
"steamid": null,
|
||||
"gogid": null,
|
||||
"gogslug": "",
|
||||
"humbleid": "",
|
||||
"humblestoreid": "",
|
||||
"humblestoreid_real": "",
|
||||
"script": {
|
||||
"files": [
|
||||
{
|
||||
"client": "https://install.robertsspaceindustries.com/star-citizen/RSI-Setup-1.6.4.exe"
|
||||
}
|
||||
],
|
||||
"game": {
|
||||
"arch": "win64",
|
||||
"exe": "drive_c/Program Files/Roberts Space Industries/RSI Launcher/RSI Launcher.exe",
|
||||
"prefix": "$GAMEDIR"
|
||||
},
|
||||
"install_complete_text": "Installation Complete!\r\n\r\nPlease see our Quick Start Guide for instructions on deploying the necessary Easy Anti-Cheat workaround as well as other important configuration requirements:\r\n\r\nhttps://github.com/starcitizen-lug/information-howtos/wiki/Quick-Start-Guide",
|
||||
"installer": [
|
||||
{
|
||||
"task": {
|
||||
"arch": "win64",
|
||||
"description": "Creating Wine prefix",
|
||||
"name": "create_prefix",
|
||||
"prefix": "$GAMEDIR"
|
||||
}
|
||||
},
|
||||
{
|
||||
"task": {
|
||||
"app": "--force arial vcrun2019 win10",
|
||||
"arch": "win64",
|
||||
"description": "Installing dlls",
|
||||
"name": "winetricks",
|
||||
"prefix": "$GAMEDIR"
|
||||
}
|
||||
},
|
||||
{
|
||||
"task": {
|
||||
"arch": "win64",
|
||||
"args": "/S",
|
||||
"description": "Installing client",
|
||||
"executable": "client",
|
||||
"name": "wineexec",
|
||||
"prefix": "$GAMEDIR"
|
||||
}
|
||||
},
|
||||
{
|
||||
"execute": {
|
||||
"description": "Creating game path",
|
||||
"command": "mkdir -p $GAMEDIR'/drive_c/Program Files/Roberts Space Industries/StarCitizen/'{LIVE,PTU}"
|
||||
}
|
||||
}
|
||||
],
|
||||
"system": {
|
||||
"prefer_system_libs": false,
|
||||
"env": {
|
||||
"DXVK_HUD": "0",
|
||||
"__GL_SHADER_DISK_CACHE": 1,
|
||||
"__GL_SHADER_DISK_CACHE_SIZE": "1073741824",
|
||||
"__GL_THREADED_OPTIMIZATIONS": "1"
|
||||
}
|
||||
},
|
||||
"wine": {
|
||||
"dxvk": true,
|
||||
"esync": true,
|
||||
"system_winetricks": false,
|
||||
"dxvk_nvapi": false,
|
||||
"overrides": {
|
||||
"nvapi,nvapi64": "disabled",
|
||||
"libglesv2": "builtin"
|
||||
},
|
||||
"version": "lutris-GE-Proton7-35-x86_64"
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
Reference in New Issue
Block a user