A launcher for quickly & easily switching server destinations.

Overview

GrassClipper

Grasscutter launcher for easily switching between Official and Private servers

Download Here!

*Note: some translations are outdated, so if random English text appears or an option seems misleading, this is why. If you notice an issue like this, feel free to make a pull request!

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: setup_win.cmd
  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
    • 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

You may also want to run this command as administrator: CheckNetIsolation.exe LoopbackExempt -a -n="Microsoft.Win32WebViewHost_cw5n1h2txyewy"

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

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.

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 & MrAru
  • ZH-TW - Kimi
  • PT-BR - na.na
  • VIE - labalityowo
  • ID - Iqrar99
  • FR - linsorak & memetrollsXD
  • ES - memetrollsXD
  • ND - memetrollsXD
  • RU - fitiskin
  • TR - lilmayofuksu

Screenshots

image image image image image image image

Comments
  • About a bug

    About a bug

    My system using this program is Windows 10, after opening the program is white, there is no display interface, I can not close the program normally, but I transferred it to my friends, they can open this and display the interface

    opened by LuoTianTime 18
  • Click on the software to flash back点开软件闪退

    Click on the software to flash back点开软件闪退

    ###The following are translated from Microsoft Translation, if you can't understand, please use the Microsoft machine to translate to Chinese and then switch to other translation software translation

    Double-click the launcher after the white screen pops up and displays browser f12, the administrator is still running still not working, and the solution to the white screen problem that has been tried is invalid

    双击启动器在跳出白屏和显示浏览器f12后闪退,已管理员身份运行仍不行,已尝试使用白屏问题的解决方法无效

    opened by friends-xiaohuli 16
  • play on grasscutter still redirects to the official server

    play on grasscutter still redirects to the official server

    First time trying private server, installed the proxy with no problem but when i tried to connect to a private server with grasscutter, it somehow still connect to the official one, no error message was shown on the app

    it is because im running on a modified windows 10 (like the light version)? if thats so do i need to enable certain network services for it to work? or it is because i got some vpn network service installed? thanks in advance

    opened by Shurelia 5
  • The client failed to connect to the server

    The client failed to connect to the server

    When I use GrassClipper to connect to my private server (running on a remote server), the client tells me that the network is busy (502) and the GrassCutter console has the following error (I've set the public port to 443) image

    opened by Pigeon2333 5
  • Update vietnamese translation

    Update vietnamese translation

    gonna save it as draft for a while if anyone want to contribute (as i see a lot of vietnamese coming to this project)

    TODO:

    Translate 'httpsSubtitle', still havent found a way to do this (maybe its better to keep it blank?)

    opened by timing1337 4
  • Fix some translations

    Fix some translations

    1 :I think "GrassClipper" is a proper noun,its inappropriate to translate it literally. 2:"Play(游玩)" is not "launch(启动)". 3:“Genshin Impact Game(原神)” is not translated. 4:"killswitchSubtitle" is completely wrong and seems like machine translate. 5:“set” here is preferably translated as "选择(select)" 6: Change some expressions of "folderNotSet" to let it looks clearer

    opened by Scirese 4
  • JNI error

    JNI error

    im trying to start a private server in genshin but whenever i press "launch server" it shows this:

    Error: A JNI error has occurred, please check your installation and try again Exception in thread "main" java.lang.UnsupportedClassVersionError: emu/grasscutter/Grasscutter has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0

    what does this mean and how do i fix it? i googled it and apparently this means it correlates to java se 8? cuz i tried that and that,,,, didnt do anything,,,,, i may be slow!!!!!!!!!!!!!!!!!!!!!! Grasscutter 26_05_2022 19 10 11

    opened by toelicker5 2
  • No Internet

    No Internet

    Hi! I encountered a problem where I lose internet whenever I close the grasscutter proxy server. I tried following the guide/fix stated disabling the proxy in my windows proxy settings. May I ask for a detailed explanation on how to do this?

    opened by ChiefNyanta 2
  • Error 502, how to fix?

    Error 502, how to fix?

    The discord server doesn't give a proper answer and neither do the pinned comments on it. Google and youtube won't give a proper answer neither and that's literally the last step. What should I do?

    opened by Shibazor 2
  • Application Crash

    Application Crash

    Application Crash:

    问题签名: 问题事件名称: APPCRASH 应用程序名: GrassClipper.exe 应用程序版本: 0.0.0.0 应用程序时间戳: 622a35e6 故障模块名称: GrassClipper.exe 故障模块版本: 0.0.0.0 故障模块时间戳: 622a35e6 异常代码: 40000015 异常偏移: 000000000015a03b OS 版本: 6.1.7601.2.1.0.256.1 区域设置 ID: 2052 其他信息 1: e1c4 其他信息 2: e1c47a81508d156a4c8aa0f541910782 其他信息 3: 2752 其他信息 4: 2752093fa0068d39f9e502f74f276536

    联机阅读隐私声明: http://go.microsoft.com/fwlink/?linkid=104288&clcid=0x0804

    如果无法获取联机隐私声明,请脱机阅读我们的隐私声明: C:\windows\system32\zh-CN\erofflps.txt

    opened by 9588A9588 2
  • Get advice on a language profile

    Get advice on a language profile

    I think we can add language configuration files in future updates. Users can freely modify the language configuration file to achieve the effect of multi language. Also more convenient to use!

    language/translation 
    opened by nuoxianCN 2
  • Entry Point Not Found

    Entry Point Not Found

    I tried opening GrassClipper.exe and it says this following message " GrassClipper.exe - Entry Point Not Found

    The procedure entry point CoIncrementMTAUsage could not be located in the dynamic link library ole32.dll. " Windows 7 here, any help?

    opened by indpack 1
  • Backup and restore registry for seamless transition

    Backup and restore registry for seamless transition

    https://github.com/Grasscutters/GrassClipper/issues/78 I have no experience with javascript, so the best I can do is mess with the batch file I have personally tried it, should work

    opened by huizichin 0
  • Proxy Only mode request

    Proxy Only mode request

    Hi Thank you for making gc so easy for our newbies. I'm a ios player, and use my windows computer to set up proxy and redirect traffic for my tablet to play gc. Is there any possiblity for adding a mode that run the mitm proxy (n probably gc as well) without launching GI? This was used to be done by ignoring the request of admin permission of the GI process, thus its very inconvinient. Beside, is there any possiblity to used the preinstalled mitm proxy 8.0.0 instead of installing a new one with the script? Thank you so much for reading this.

    opened by kbps1024 0
Releases(v0.9.10)
  • v0.9.10(May 19, 2022)

    • Add some endpoints to the proxy script
    • Fix Grasscutter dialog issue
    • Use local axios

    Translations:

    • Add Korean translation
    • Add Thai translation

    * There is a new launcher in the works, being worked on by me and Magix. If GrassClipper doesn't work great for you, it is recommended that you wait for the release of the new launcher.

    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.60 MB)
  • v0.9.9(May 10, 2022)

  • v0.9.8(May 8, 2022)

  • v0.9.7(May 8, 2022)

    Features:

    • Debug mode, enable in options
    • Download data files (keys, drops, etc) seperately
    • Add a fallback build URL in case the latest action did not upload an artifact
    • Add some missing language defaults, should prevent offshoot crashes that basically nobody should encounter in the first place
    • Various fixes. Probably new bugs too, lol
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(2.39 MB)
  • v0.9.6(May 8, 2022)

  • v0.9.5(May 7, 2022)

  • v0.9.4(May 6, 2022)

  • v0.9.3(May 6, 2022)

    This build contains many fixes and tweaks, and a couple new features that will hopefully assist in the user experience

    Features:

    • Starts the PS script in the background, one less window to have open and one less thing to accidentally close!
    • New pop-up when first enabling the local server section, prompting to download Grasscutter
    • Full Japanese translation
    • Full Hindi translation

    Bug fixes:

    • Closes install script when it is opened in admin properly
    • Hopefully fix some path errors
    • Fix folder opening buttons
    • Fix zh-tw translation file
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.58 MB)
  • v0.9.2(May 4, 2022)

    There exist some things that users should be alerted to, and this system is a step towards this!

    Features:

    • Alert users when any folder set contains Chinese characters, since Grassclipper does not support them currently (EN and ZH)
    • Fix folder buttons beside folder setting buttons
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.58 MB)
  • v0.9.1(May 3, 2022)

  • v0.9.0(May 3, 2022)

    Biiiig update! This allows users to download Grasscutter and it's resources straight from GrassClipper!

    Features:

    • New downloads section! Right beside the settings icon :)
    • Choose between downloading stable or development branches
    • Automatically grabs Grasscutter resources, no need to find them yourself!
    • Automatically enables the server launcher portion and automatically sets/overwrites the server jar path
    • Download resources separately. If you have an existing Grasscutter installation, this will download resources just like in the GC installer
    • Detects Java installation, lets you know if you have to install a different version!

    Smaller fixes:

    • Language files should show up properly
    • Small script modifications
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.58 MB)
  • v0.8.7(May 3, 2022)

  • v0.8.6(May 3, 2022)

  • v0.9.1-preview(May 2, 2022)

  • v0.9.0-preview(May 2, 2022)

    Big update! This is a preview, which means stuff may not work correctly. There is also only an english translation for this change. It is recommended that you use this installation separately from v0.8.5 Java version checking is also not included in the version, but will be including in the final version

    Features:

    • New downloads section! Right beside the settings icon :)
    • Choose between downloading stable or development
    • Automatically grabs Grasscutter resources, no need to find them yourself!
    • Automatically enables the server launcher portion and automatically sets/overwrites the server jar path
    • Download resources separately. If you have an existing Grasscutter installation, this will download resources just like in the GC installer
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.58 MB)
  • v0.8.5(Apr 30, 2022)

  • v0.8.4(Apr 30, 2022)

    Features:

    • Refresh button - Works just as well as restarting the app, so if there is a change that needs to applied, this should be enough! Found in the top right of the window
    • Update notification - If there is an update available, a small notification will come from the bottom right of the screen

    Fixes:

    • Fixed opening folder of the game or Grasscutter
    • Use disabled web security build of Neutralino properly (this is not a bad thing, this just allows the app to send web requests!)
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.57 MB)
  • v0.8.3(Apr 30, 2022)

  • v0.8.2(Apr 28, 2022)

  • v0.8.1(Apr 28, 2022)

  • v0.8.0(Apr 27, 2022)

    Features:

    • Turkish translation- lilmayofuksu
    • Russian translation - fitiskin
    • Login and register screens
      • In the near future, Grasscutter will have an authentication system, this is an implementation of a login screen before this happens so everyone is ready when it comes!
      • For now it will not pop up, but once servers start enabling authentication it will!
    • Open game and Grasscutter folders in Windows explorer by pressing the white folder icon
    • Make certificate trusting command more clear after installing the proxy server
    • Misc. fixes and changes

    * If you are a translator and would like to assist in translating the login page, pull requests are appreciated!

    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.57 MB)
  • v0.7.4(Apr 26, 2022)

  • v0.7.3(Apr 26, 2022)

  • v0.7.2(Apr 26, 2022)

    This makes a few of the scripts not require admin, as well as open without the need for a weird VBS workaround, which should help in some people not being able to use the buttons.

    Also defaults to 127.0.0.1 instead of localhost when launching in Grasscutter mode, but you still of course use localhost if you know it works.

    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.40 MB)
  • v0.7.1(Apr 25, 2022)

    This patch fixes a long-standing problem with WIndows screen scaling.

    Features:

    • Dragging the top bar works perfectly with any Windows scaling value.
    • UI now fits properly no matter what scaling (tested on 100%, 125%, 150%, and 175% scaling modes)
    • Changes background position so that it should fit properly in any mode
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.40 MB)
  • v0.7.0(Apr 24, 2022)

    New features:

    • Specify port to connect to!
      • You can favorite the same IP with multiple ports and they will show up separately.
      • Defaults to 443 if one is not provided
    • Specify whether to use HTTPS or HTTP in settings
    • Install script will automatically un-grey the Grasscutter button once completely

    New languages:

    • RU - fitiskin
    • ZH-TW - Kimi
    Source code(tar.gz)
    Source code(zip)
    GrassClipper.zip(3.40 MB)
  • v.0.6.5(Apr 24, 2022)

  • v0.6.4(Apr 23, 2022)

  • v0.6.3(Apr 23, 2022)

  • v0.6.2(Apr 23, 2022)

Owner
Software & utilities to emulate a certain anime game.
null
Grupprojekt för kurserna 'Javascript med Ramverk' och 'Agil Utveckling'

JavaScript-med-Ramverk-Laboration-3 Grupprojektet för kurserna Javascript med Ramverk och Agil Utveckling. Utvecklingsguide För information om hur utv

Svante Jonsson IT-Högskolan 3 May 18, 2022
Hemsida för personer i Sverige som kan och vill erbjuda boende till människor på flykt

Getting Started with Create React App This project was bootstrapped with Create React App. Available Scripts In the project directory, you can run: np

null 4 May 3, 2022
Kurs-repo för kursen Webbserver och Databaser

Webbserver och databaser This repository is meant for CME students to access exercises and codealongs that happen throughout the course. I hope you wi

null 14 Jan 3, 2023
A starter project that includes theme switching functionality with Stitches CSS-in-JS and Remix SSR.

Welcome to Remix! Remix Docs Development From your terminal: npm run dev This starts your app in development mode, rebuilding assets on file changes.

Ross Moody 13 Dec 22, 2022
Awesome books app is a basic website that allows users to add/remove books from a list. It is a single page app (SPA) which allow switching to different pages of the app without page load. Built with JavaScript.

Awesome Books ES6 In this project, I build a basic website that allows users to add/remove books from a list. using ES6 syntax and make it more organi

Abdulhamid 11 Jul 1, 2022
Page switching like a Boss. Inspired by jQuery mobile

Roadcrew.js / Roadcrew.dart =========================== Roadcrew.js is a simple JavaScript snippet which allows "page transitions" like in jQuery mob

Christian Grobmeier 49 Aug 20, 2018
Javascript library for switching fixed elements on scroll through sections. Like Midnight.js, but without jQuery

Library for Switching Fixed Elements on Scroll Sometimes designers create complex logic and fix parts of the interface. Also they colour page sections

Vladimir Lysov 38 Sep 19, 2022
A Minecraft launcher written in Rust, with an Electron frontend.

RustMine A Minecraft launcher written in Rust, with an Electron frontend. Why? I thought it would be fun to use two of my most familiar languages, Rus

sussyimpostor 1 Oct 16, 2022
A launcher for Mindustry built with Node.JS.

MindustryLauncher A custom launcher for Mindustry built with TypeScript and Node.JS. Features Logging Version selection Automatic version download Aut

null 5 Jun 23, 2022
MacOS launcher & command palette

About If you ever liked tools like Raycast and Alfred, but wanted to own them and tweak them yourself, then SOL is the tool for you. All the affordanc

Oscar Franco 1.4k Dec 30, 2022
Shizuku Launcher is a simple AWS Virtual Machine helper.

shizuku-launcher-web Shizuku Launcher is a simple AWS Virtual Machine helper. Shizuku Launcher offers multiple solutions to keep your credential secur

Seraphim Lou 16 Oct 11, 2022
An Anime Game launcher for Linux with automatic patching fixing detection of Linux/Wine and telemetry disabling

An Anime Game launcher for Linux with automatic patching fixing detection of Linux/Wine and telemetry disabling

An Anime Team 367 Jan 4, 2023
Shizuku Launcher is a simple AWS Virtual Machine helper. Now in Next.js

Shizuku Launcher Shizuku Launcher is a simple AWS Virtual Machine helper. Shizuku Launcher offers multiple solutions to keep your credential security

Seraphim Lou 50 Jan 3, 2023
A JupyterLab extension to create custom launcher entries.

jupyter_app_launcher A JupyterLab extension to create custom launcher entries jupyter_app_launcher helps users customize the JupyterLab launcher with

Duc Trung Le 17 Dec 28, 2022
Open source app to beautify screenshots, quickly and easily

Codename: Pika What it does Lets you quickly beautify screenshots by adding rounded corners, background colors, shadows and more. You can copy the bea

Rishi Mohan 458 Dec 29, 2022
A comprehensive collection of useful tools developed with the help of Ethers.js to interact with the Ethereum Blockchain to develop great DeFi apps as quickly and easily as possible.

hudi-packages-ethersfactory How to install Installing with npm For more information on using npm check out the docs here. npm i @humandataincome/ether

HUDI 6 Mar 30, 2022
Chat View let's you quickly and easily create elegant Chat UIs in your Markdown Files.

Obsidian Chat View Plugin Chat View let's you quickly and easily create elegant Chat UIs in your Markdown Files. Usage Every chat message must be pref

Adifyr 96 Dec 27, 2022
This provides an extension integration with Docker Desktop to run k9s quickly and easily through the Docker Desktop interface.

k9s extension for Docker Desktop This provides an extension integration with Docker Desktop to allow k9s quickly and easily through the Docker Desktop

James Spurin 14 Dec 16, 2022