Grasscutters/GrassClipper
3
0
Fork 0
mirror of https://github.com/Grasscutters/GrassClipper.git synced 2024-11-24 17:19:35 +00:00
Code Issues Projects Releases Wiki Activity
195 Commits 5 Branches 43 Tags 5.3 MiB
JavaScript 53.2%
HTML 16.3%
Batchfile 15%
CSS 11.6%
Python 3.2%
Other 0.7%
crossplatform
Go to file
SpikeHD 7e826312fd differentiate between install scripts
2022-04-24 15:55:19 -07:00
languages Merge pull request #24 from nuoxianCN/main 2022-04-24 13:29:44 -07:00
proxy specify port when connecitng 2022-04-24 00:32:17 -07:00
resources differentiate between install scripts 2022-04-24 15:55:19 -07:00
scripts fix linux install script 2022-04-24 15:55:18 -07:00
.gitignore custom private server background and build steps 2022-04-20 16:46:46 -07:00
LICENSE Initial commit 2022-04-19 16:07:19 -07:00
manifest.json version bump 2022-04-23 21:31:52 -07:00
neutralino.config.json version bump 2022-04-23 21:31:52 -07:00
package.json version bump 2022-04-23 21:31:52 -07:00
README.md Update README.md 2022-04-24 13:13:27 -07:00

README.md

GrassClipper

Grasscutter launcher for easily switching between Official and Private servers

Download Here!

Table of Contents

Setup (for Users)

  1. Download the zip file
  2. Extract the zip file somewhere
  3. Run GrassClipper.exe, install the proxy server, and set your game folder!

Setup (for Development)

  1. Clone the repository
  2. Ensure you have NodeJS installed.
  3. Install the neu CLI tool: npm install -g @neutralinojs/neu
  4. Install the dependencies: npm install AND neu update
  5. Compile and run:
    • For testing: npm run dev
    • For production: npm run build

TODO

  • Interface/internals
    • UI
    • Official and Private options
    • Server IP input
    • Fun fancy CSS styling n stuff (CoD: MW 2019-style vertical menu for choosing between official and private servers? See this)
    • Kill switch script (optional)
    • Automatically run install.cmd when opening for the first time
    • Detect when in a folder that is inaccessible to the program (eg. C:/Program Files) and warn
    • 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
    • Fix Windows scaling issues? (partially done)
    • Integrated banner creator
  • Proxy service
    • Local proxy server
    • Intercept and modify GI requests like with Fiddler, allow anything else to pass through
    • Fix Discord and YouTube issues when proxy is enabled (maybe fixed)

Having problems?

Below are some scenarios you may encounter and their solutions.

White Screen Fix

Encountering a white screen? Ensure WebView2 is installed

My Discord is not letting me send messages or load images/My Youtube is acting strange!

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.

I have no internet after closing everything/restarting my PC!

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.

Available Languages and Translation Credits

Thank you to everyone who has provided translations! <3

  • ZH - nuoxianCN & Scirese
  • ZH-TW - Kimi
  • PT-BR - na.na
  • VIE - labalityowo
  • ID - Iqrar99
  • FR - linsorak & memetrollsXD
  • ES - memetrollsXD
  • ND - memetrollsXD
  • RU - fitiskin

Screenshots

image image image image image image image