Coder Social home page Coder Social logo

apwlq / webconsole Goto Github PK

View Code? Open in Web Editor NEW

This project forked from mesacarlos/webconsole

0.0 0.0 0.0 195 KB

Spigot plugin to manage your server remotely using a web interface

Home Page: https://mesacarlos.es/webconsole/

License: MIT License

Java 36.86% HTML 12.90% JavaScript 49.83% CSS 0.42%

webconsole's Introduction

WebConsole

Jenkins GitHub release (latest by date) GitHub All Releases

WebConsole is a Spigot plugin for Minecraft 1.8-1.16+ that allows you to view your server console and manage your server from anywhere. It creates a WebSocket server in the background used by the web interface to send commands, receive your console log and manage your server.

Don't worry about privacy or security: all data is stored in your browser locally and your PC will connect directly to your minecraft server. No intermediary web servers, just you and your MC server.

Additional features:

  • Multiuser system and View-only user mode: You can create multiple users and set their role to "Admin" or "Viewer". Users with the role "Viewer" can only read console, CPU and RAM usage. Users with role "Admin" can also run commands on the server. Useful if you want your friends to watch the server console but deny them from typing commands and ruining your server.
  • Command history: Use up/down arrow keys to browse the command history, like in the real console.
  • Colors supported, for both Windows and Linux hosts. (Colors are represented different in each platform).
  • Real-time connected players, machine CPU and server RAM usage information.
  • Capable of keeping active connections to more than one server to keep retrieving console log in the background for them all.
  • English, Spanish, Chinese (thanks to Neubulae and OPhantomO), Czech (thanks to Tada), Deutsch (thanks to NoNamePro0), Dutch (thanks to Twockx), French (thanks to pickatchou999), Italian (thanks to AlexZap), Korean (thanks to XxPKBxX), Portuguese (thanks to AlexandreMuassab and Connect500BR), Russian (thanks to Stashenko) and Turkish (thanks to acarnd03) supported.
  • Free, updated regularly, and many more!

Screenshot

Plugin installation

  1. Download plugin from Releases.

  2. Open and close your server to generate the config.yml file and open it. You will see something like the following:

    useSSL: false
    StoreType: JKS
    KeyStore: plugins/WebConsole/keystore.jks
    StorePassword: storepassword
    KeyPassword: keypassword
    host: 0.0.0.0
    port: 8080
    language: en
    passwords:
       admin:
          user1: mySecurePassword
       viewer: {}

A explanation of the host, port, language and passwords fields follows:

host: Leaving it as 0.0.0.0 will do the trick. If you experience issues , you can change this value to your device IP. If you are in a VPS or dedicated server (or you have a full public IP allocated for your device) type your public IP. If you are at your home (and you don't have a public IP assigned to your device) type your private IP, it is probably something like 192.168.xx.xx.

port: A port where to run this plugin (cannot be the port you are using for Minecraft).

You can modify language to view console and command messages in your preferred language. Valid languages are English (en), Spanish (es), Chinese (zh), Czech (cs), Deutsch (de), Dutch (nl), French (fr), Italian (it), Korean (ko), Portuguese (pt), Russian (ru) and Turkish (tr). IMPORTANT: There is a known issue with Microsoft Windows cmd that shows weird characters when using a language different than English. If you are using Windows to host your server, check this wiki page to solve the problem.

From version 2.0 you can now create more than one user and set them as admin (Permission for both reading console and executing commands) or viewer (Permission for only reading console and CPU and RAM usage). This is configured using the passwords section:

  • By default, a user called user1 with password mySecurePassword is created, please replace or remove it as it is only served as an example.
  • If you want to create a admin user, type below admin: a row like user: password replacing user with your desired username and password with your password.
  • You can create as many admins as you want repeating this step.
  • If you want to create a view-only user, remove the {} after viewer: and do the same process as for admin users below viewer: . You can also create as many viewers as needed.

The rest of the fields are used for SSL configuration. You can learn how to activate SSL here. SSL is not required for WebConsole to work, you can still use it without encription, unless you are hosting your client in a HTTPS server, in this case is mandatory to enable SSL in all your servers due to web browsers restrictions.

Using web interface

  1. You can download web interface (client.zip) from Releases or, if you prefer, you can use my WebConsole Hosted Clients webpage. You can host the client in a web server, or use it offline. That's up to you.
  2. Open index.html if you downloaded the client or click on the latest version if you are using my Hosted Clients website.
  3. To start adding servers, click on Your servers, and then Add server. Fill Server name, IP and WebConsole port (the one you placed into config.yml before), and you are ready to go. You will be prompted for password when connecting.

Check connected WebConsole clients

Since v1.3, you can use /WebConsole command to view how many clients are connected and their IP address. This is the only Minecraft command provided by this plugin. This command requires you to have webconsole.webconsole permission to execute it.

Technical information

You can find how client and server comunicate here.

Bugs, suggestions or problems configuring WebConsole?

You can open an issue on GitHub or ask me at Spigot forums.

webconsole's People

Contributors

mesacarlos avatar bxvcd-732 avatar dependabot[bot] avatar danny8376 avatar minemobs avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.