2022-04-19 23:07:19 +00:00
# GrassClipper
Grasscutter launcher for easily switching between Official and Private servers
2022-04-19 23:19:27 +00:00
[Download Here! ](https://github.com/Grasscutters/GrassClipper/releases/ )
2022-04-21 23:10:25 +00:00
# Table of Contents
* [Setup (for users) ](#setup-for-users )
* [Setup (for development) ](#setup-for-development )
* [TODO ](#todo )
* [Common Problems ](#having-problems )
2022-04-23 05:24:45 +00:00
* [White Screen Fix ](#white-screen-fix )
2022-04-25 05:26:31 +00:00
* [Infinite CMD Windows ](#infinite-cmd-windows )
2022-04-23 05:24:45 +00:00
* [Broken Discord/Youtube ](#my-discord-is-not-letting-me-send-messages-or-load-images-my-youtube-is-acting-strange )
* [No internet ](#i-have-no-internet-after-closing-everything-restarting-my-pc )
2022-04-23 06:51:48 +00:00
* [Languages and Translation Credits ](#available-languages-and-translation-credits )
2022-04-21 23:10:25 +00:00
* [Screenshots ](#screenshots )
2022-04-20 23:27:40 +00:00
# Setup (for Users)
1. Download the zip file
2. Extract the zip file somewhere
2022-04-24 04:05:07 +00:00
3. Run `GrassClipper.exe` , install the proxy server, and set your game folder!
2022-04-20 23:27:40 +00:00
# Setup (for Development)
2022-04-19 23:19:27 +00:00
0. Clone the repository
1. Ensure you have [NodeJS ](https://nodejs.org/en/download/ ) installed.
2. Install the `neu` CLI tool: `npm install -g @neutralinojs/neu`
2022-04-19 23:33:59 +00:00
3. Install the dependencies: `npm install` AND `neu update`
2022-04-19 23:19:27 +00:00
4. Compile and run:
* For testing: `npm run dev`
* For production: `npm run build`
# TODO
2022-04-24 00:13:35 +00:00
* Interface/internals
2022-04-21 10:48:10 +00:00
* [x] UI
* [x] Official and Private options
* [x] Server IP input
* [x] Fun fancy CSS styling n stuff (CoD: MW 2019-style vertical menu for choosing between official and private servers? [See this ](https://charlieintel.com/wp-content/uploads/2020/11/MW-new-menu.png ))
2022-04-21 23:14:27 +00:00
* [x] Kill switch script (optional)
2022-04-22 00:17:33 +00:00
* [x] Automatically run `install.cmd` when opening for the first time
2022-04-24 04:36:39 +00:00
* [ ] Detect when in a folder that is inaccessible to the program (eg. `C:/Program Files` ) and warn
2022-04-24 00:13:35 +00:00
* [ ] Custom images for private server sections (anyone is welcome to submit a pull request to add some!)
* [ ] Optional username/password creation for servers before entering (not implemented in Grasscutter yet)
* [ ] Platform detection and bash scripts
* [ ] Integrated banner creator
2022-04-19 23:19:27 +00:00
* Proxy service
2022-04-21 10:48:10 +00:00
* [x] Local proxy server
* [x] Intercept and modify GI requests like with Fiddler, allow anything else to pass through
2022-04-24 00:13:35 +00:00
* [ ] Fix Discord and YouTube issues when proxy is enabled (maybe fixed)
2022-04-20 23:27:40 +00:00
# Having problems?
Below are some scenarios you may encounter and their solutions.
2022-04-25 05:44:58 +00:00
## White Screen Fix
2022-04-23 05:24:45 +00:00
Encountering a white screen? [Ensure WebView2 is installed ](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/#download )
2022-04-25 03:06:21 +00:00
You may also want to run this command as administrator:
`CheckNetIsolation.exe LoopbackExempt -a -n="Microsoft.Win32WebViewHost_cw5n1h2txyewy"`
2022-04-25 05:44:58 +00:00
If all else fails, you can run GrassClipper in `chrome` or `browser` mode. To do so:
* Create a shortcut to `GrassClipper.exe`
* Right click the shortcut, click `properties`
* In the `Target` box, at the very end, add ` --mode=chrome` or ` --mode=browser`
* `chrome` only works if you have Chrome installed, and will create a Chrome window
* `brower` will, you guessed it, open GrassClipper in your default browser
* Click `Ok`
* Run GrassClipper using this shortcut from now on!
## Infinite CMD Windows
2022-04-25 05:26:31 +00:00
If you are getting infinite CMD windows for any of the scripts (such as the proxy installation, or private server start), ensure you have UAC (user access control) set to any option that requires asking. Ensure your user account can open things as Admin.
2022-04-25 05:44:58 +00:00
## My Discord is not letting me send messages or load images/My Youtube is acting strange!
2022-04-20 23:27:40 +00:00
2022-04-21 07:44:32 +00:00
Discord/YouTube (plus surely some others) does not seem to be a fan of the proxy server. You may need to disable it by either closing mitmdump or by disabling your proxy in the Windows proxy settings.
2022-04-20 23:27:40 +00:00
2022-04-25 05:44:58 +00:00
## I have no internet after closing everything/restarting my PC!
2022-04-20 23:27:40 +00:00
The launcher most likely did not close correctly, and was unable to clean your proxy settings back to what they were. Disable your proxy in the Windows proxy settings.
2022-04-23 06:51:48 +00:00
# Available Languages and Translation Credits
2022-04-23 06:43:41 +00:00
2022-04-23 06:51:48 +00:00
Thank you to everyone who has provided translations! < 3
2022-04-23 06:43:41 +00:00
2022-04-23 22:19:51 +00:00
* ZH - nuoxianCN & Scirese
2022-04-24 20:13:27 +00:00
* ZH-TW - Kimi
2022-04-23 06:43:41 +00:00
* PT-BR - na.na
2022-04-23 07:09:50 +00:00
* VIE - labalityowo
* ID - Iqrar99
2022-04-23 23:41:52 +00:00
* FR - linsorak & memetrollsXD
2022-04-24 00:05:21 +00:00
* ES - memetrollsXD
* ND - memetrollsXD
2022-04-24 20:13:27 +00:00
* RU - fitiskin
2022-04-23 06:43:41 +00:00
2022-04-21 07:00:30 +00:00
# Screenshots
2022-04-22 00:43:40 +00:00
2022-04-21 07:00:30 +00:00
2022-04-23 06:21:30 +00:00
2022-04-23 06:20:52 +00:00
2022-04-22 00:43:40 +00:00
2022-04-21 23:07:41 +00:00
