mirror of
https://github.com/the-sane/lug-helper.git
synced 2025-07-01 20:10:39 +00:00
Compare commits
238 Commits
v1.3
...
f072378617
Author | SHA1 | Date | |
---|---|---|---|
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 |
85
README.md
85
README.md
@ -1,42 +1,79 @@
|
|||||||
# lug-helper
|
# LUG Helper
|
||||||
**Star Citizen's Linux Users Group Helper Script**
|
**Star Citizen's Linux Users Group Helper Script**
|
||||||
|
|
||||||
https://robertsspaceindustries.com/orgs/LUG
|
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).
|
Configuration is saved in *$XDG_CONFIG_HOME/starcitizen-lug/*
|
||||||
|
Keybinds are backed up to *$XDG_CONFIG_HOME/starcitizen-lug/keybinds/*
|
||||||
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*.
|
|
||||||
|
|
||||||
## Options:
|
## Options:
|
||||||
|
|
||||||
|
`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.
|
||||||
|
|
||||||
|
`Install Star Citizen`
|
||||||
|
- Launches Lutris and uses the bundled json to install Star Citizen
|
||||||
|
|
||||||
|
`Deploy Easy Anti-Cheat Workaround`
|
||||||
|
- Applies the workaround to /etc/hosts and deletes the necessary EAC files
|
||||||
|
|
||||||
`Manage Lutris Runners`
|
`Manage Lutris Runners`
|
||||||
- Quickly install and delete Lutris wine runners
|
- Quickly install and delete Lutris wine runners
|
||||||
|
|
||||||
`Delete my Star Citizen USER folder and preserve my keybinds`
|
`Manage Lutris DXVK Versions`
|
||||||
- The helper will make backups of any exported keybinds, delete your Star Citizen USER folder, then restore your keybind files.
|
- Quickly install and delete DXVK versions for Lutris
|
||||||
- To export your keybinds from within the game, go to:
|
|
||||||
|
`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*
|
- *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*
|
- *Options->Keybindings->Control Profiles*
|
||||||
|
|
||||||
`Check vm.max_map_count for optimal performance`
|
- `Delete my shaders folder only`
|
||||||
- We recommend setting this to at least 16777216 to give the game access to sufficient memory.
|
- Sometimes all you need to do between major version updates is delete your shaders directory.
|
||||||
- The helper will offer to set it for you or show you the commands to do it yourself.
|
|
||||||
|
|
||||||
`Check my open file descriptors limit`
|
- `Delete my DXVK cache`
|
||||||
- We recommend setting the hard open files limit to at least 524288.
|
- A troubleshooting step that sometimes helps fix various issues and crashes.
|
||||||
- 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*
|
|
||||||
|
|
||||||
`Delete my shaders only`
|
- `Display Helper and Star Citizen directories`
|
||||||
- Sometimes all you need to do between major version updates is delete your shaders directory.
|
- Show all the directories currently in use by both the Helper and Star Citizen.
|
||||||
|
|
||||||
`Delete my DXVK cache`
|
- `Reset Helper configs`
|
||||||
- A troubleshooting step that sometimes helps fix various issues and crashes.
|
- Delete the configs saved by the helper in *$XDG_CONFIG_HOME/starcitizen-lug/*
|
||||||
|
|
||||||
`Switch the helper between LIVE and PTU`
|
`Get a random Penguin's Star Citizen referral code`
|
||||||
- Toggle between targeting LIVE or PTU for all of the above options. Defaults to LIVE on each run.
|
- 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/
|
||||||
|
|
||||||
|
## 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
|
||||||
|
1792
lug-helper.sh
1792
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 |
91
lug-lutris-install.json
Normal file
91
lug-lutris-install.json
Normal file
@ -0,0 +1,91 @@
|
|||||||
|
{
|
||||||
|
"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 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!",
|
||||||
|
"created_at": "2018-11-15T17:43:07.367000Z",
|
||||||
|
"updated_at": "2021-12-24T00:49:16.775712Z",
|
||||||
|
"draft": false,
|
||||||
|
"published": true,
|
||||||
|
"published_by": 64834,
|
||||||
|
"rating": "",
|
||||||
|
"steamid": null,
|
||||||
|
"gogid": null,
|
||||||
|
"gogslug": "",
|
||||||
|
"humbleid": "",
|
||||||
|
"humblestoreid": "",
|
||||||
|
"humblestoreid_real": "",
|
||||||
|
"script": {
|
||||||
|
"files": [
|
||||||
|
{
|
||||||
|
"client": "https://install.robertsspaceindustries.com/star-citizen/RSI-Setup-1.5.5.exe"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"game": {
|
||||||
|
"arch": "win64",
|
||||||
|
"args": null,
|
||||||
|
"exe": "drive_c/Program Files/Roberts Space Industries/RSI Launcher/RSI Launcher.exe",
|
||||||
|
"prefix": "$GAMEDIR"
|
||||||
|
},
|
||||||
|
"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"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"system": {
|
||||||
|
"env": {
|
||||||
|
"DXVK_HUD": "0",
|
||||||
|
"__GL_SHADER_DISK_CACHE": 1,
|
||||||
|
"__GL_SHADER_DISK_CACHE_SIZE": "1073741824",
|
||||||
|
"__GL_THREADED_OPTIMIZATIONS": "1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"wine": {
|
||||||
|
"dxvk": true,
|
||||||
|
"esync": true,
|
||||||
|
"overrides": {
|
||||||
|
"nvapi,nvapi64": "disabled",
|
||||||
|
"libglesv2": "builtin"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"content": "files:\n- client: https://install.robertsspaceindustries.com/star-citizen/RSI-Setup-1.5.5.exe\ngame:\n arch: win64\n args: null\n exe: drive_c/Program Files/Roberts Space Industries/RSI Launcher/RSI Launcher.exe\n prefix: $GAMEDIR\ninstaller:\n- task:\n arch: win64\n description: Creating Wine prefix\n name: create_prefix\n prefix: $GAMEDIR\n- task:\n app: --force arial vcrun2019 win10\n arch: win64\n description: Installing dlls\n name: winetricks\n prefix: $GAMEDIR\n- task:\n arch: win64\n args: /S\n description: Installing client\n executable: client\n name: wineexec\n prefix: $GAMEDIR\nsystem:\n env:\n DXVK_HUD: '0'\n __GL_SHADER_DISK_CACHE: 1\n __GL_SHADER_DISK_CACHE_SIZE: '1073741824'\n __GL_THREADED_OPTIMIZATIONS: '1'\nwine:\n dxvk: true\n esync: true\n overrides:\n nvapi,nvapi64: disabled\n libglesv2: builtin\n"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
Reference in New Issue
Block a user