gcgm-plugin/README.md

3.0 KiB

GCGM - Grasscutter Game Master Dashboard

GCGM is the first Grasscutter plugin (Apart from Magix's test plugin) and it's goal is to implement a dashboard into the dispatch server so that game masters/server administrators can easily administor their server.

Currently Planned Features:

  • Loading basic web page
  • Nice looking CSS
  • Websockets
  • Widgets
  • Server performance stats
  • See players registered to dispatch server
  • See players currently online
  • Send mail to all players
  • Give players items
  • Summon enemies near players

The features listed are to achieve an MVP for the first release.

Important Notes:

This plugin is made to run on the current Development branch of Grasscutter.
This plugin is in very early development and the web dashboard only displays a side panel, so it is not really in a usable state.
If you require support please ask on the Grasscutter Discord. However, support is not guarenteed.

Setup

Download Plugin Jar

Coming soon!

Compile yourself

  1. Pull the latest code from github using git clone https://github.com/Grasscutters/gcgm-plugin in your terminal of choice.
  2. Locate your grasscutter server and copy the grasscutter server jar into the newly created gcgm-plugin/gc-plugin/lib folder
  3. Navigate back into the project root folder called gcgm-plugin folder and run gradlew build (cmd) or ./gradlew build (Powershell, Linux & Mac).
  4. Assuming the build succeeded, in your file explorer navigate to the gc-plugin folder, you should have a gcgm-plugin.jar file, copy it.
  5. Navigate to your Grasscutter server, find the plugins folder and paste the gcgm-plugin.jar into it.
  6. Start your server.
  7. Your server should then start and after a few seconds, you should be greated with these messages and the server will quit.
[WARN] The './plugins/gcgm/www' folder does not exist.
[WARN] Please extract the contents of 'DefaultWebApp.zip' from within './plugins/gcgm' to './plugins/gcgm/www
[WARN] Your server will now exit to allow this process to be completed
  1. Inside the plugins folder there now should be a new folder with the name of gcgm, when you open the folder, there should be a .zip file called DefaultWebApp.zip. Extract the contents of this zip into a folder called www.

Your final plugins folder's directory structure should look similar to this

plugins
│   gcgm-plugin.jar
│   ...
└───gcgm
    │   DefaultWebApp.zip
    │
    └───www
        │   asset-manifest.json
        │   favicon.ico
        │   index.html
        │   logo192.png
        │   logo512.png
        │   manifest.json
        │   robot.txt
        └───static
            └───css
            │   ...
            └───js
            │   ...
            └───media
            │   ...