MCSManager/README.md

Official Website | Team Homepage | Panel Project | UI Project | Daemon project

English | 简体中文

Environment

The control panel support Windows and Linux platforms, without database and any system configuration, just install the node environment to run quickly, it is a lightweight Minecraft server control panel.

Must be Node 14.17.0 or above, it can run out of the box without database and any system configuration changes.

Data directory

Configuration file: data/SystemConfig/config.json

User data files: data/User/*.json

Remote daemon configuration: data/RemoteServiceConfig/*.json

Install

Windows

For Windows systems, has been integrated into a direct-run version, download and run (run with administrator privileges):

Go to: https://mcsmanager.com/

linux

One line command to install quickly

wget -qO- https://raw.githubusercontent.com/mcsmanager/Script/master/setup_en.sh | bash

• Script only works on AMD64 architecture Ubuntu/Centos/Debian/Archlinux
• After the execution is complete, use systemctl start mcsm-{web,daemon} to start the panel service.
• The panel code and runtime environment are automatically installed in the /opt/mcsmanager/ directory.

Manual installation

• If the one-click installation does not work, you can try this step to install it manually.

# Switch to the installation directory, if there is no such directory, please execute mkdir /opt/
cd /opt/
# Download the runtime environment (if you have Node 14+, it can be ignored)
wget https://npmmirror.com/mirrors/node/v14.17.6/node-v14.17.6-linux-x64.tar.gz
# unzip files
tar -zxvf node-v14.17.6-linux-x64.tar.gz
# link the program into the environment variable
ln -s /opt/node-v14.17.6-linux-x64/bin/node /usr/bin/node
ln -s /opt/node-v14.17.6-linux-x64/bin/npm /usr/bin/npm

# Prepare the installation directory
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

# Download the panel (Web) program
git clone https://github.com/MCSManager/MCSManager-Web-Production.git
# rename the folder and enter
mv MCSManager-Web-Production web
cd web
# install dependencies
npm install --production
cd /opt/mcsmanager/

# Download the Daemon program
git clone https://github.com/MCSManager/MCSManager-Daemon-Production.git
# rename the folder and enter
mv MCSManager-Daemon-Production daemon
cd daemon
# install dependencies
npm install --production

# Open two terminals or two terminal windows of Screen software
# Start the daemon first
cd /opt/mcsmanager/daemon
# start up
node app.js

# Then start the panel side process
cd /opt/mcsmanager/web
# start up
node app.js

# Visit http://localhost:23333/ to enter the panel.
# By default, the panel will automatically scan the daemon folder and automatically connect to the daemon.

• Note that this installation method does not automatically register the panel to the system service (Service), so it must be managed using the screen software.

How to Update

If you are upgrading from 9.X to a later version, under Linux system, please go to /opt/mcsmanager/web, /opt/mcsmanager/daemon and execute git pull to update .

To update under the Windows system, please go to the official website to download the latest installation package and overwrite all files to take effect.

Note, it is recommended to back up the data directory before updating.

Projects

The entire software requires the cooperation of the three projects to run. The code you normally install is the product of compilation and integration.

Control panel side

• Role: Control Center
• Responsibilities: Responsible for providing the back-end interface of the front end of the web page, providing API interfaces, user data management, and communicating and authorizing the daemon.

Web Frontend

• Role: User interface of the Control Center
• Responsibilities: Display data in the form of web pages, send requests, and have the ability to communicate with daemons. The final product of this project is pure static files.

Daemon

• Role: Controlled
• Responsibility: Controls all instances of localhost, the actual manager of the real process, has the ability to communicate with any object.

Build the development environment

This paragraph is intended for developers, normal users do not need to pay attention and do not need to do it.

After all projects are running in the development environment, development and preview can be carried out. Please be sure to follow the open source agreement.

Control Panel (MCSManager)

git clone https://github.com/MCSManager/MCSManager.git
cd MCSManager
npm install
npm run start
# By default, ts-node will be used to directly execute Typescript code
# run on port 23333 by default

Web Frontend (UI)

git clone https://github.com/MCSManager/UI.git
cd UI
npm install
npm run serve
# Visit http://localhost:8080/ to preview the interface
# All API requests will be automatically forwarded to port 23333

Daemon

git clone https://github.com/MCSManager/Daemon.git
cd Daemon
npm install
npm run start
# After running, please connect the daemon on the control panel side
# run on port 24444 by default

Browser

• Support modern mainstream browsers such as Chrome Firefox Safari Opera.
• IE browser support has been dropped.

Globalization

MCSManager has supported Chinese and English two languages, and has achieved full coverage of internationalization.

Software internationalization is done by Lazy, zijiren233 and Unitwk

Panel permissions

The control panel will detect whether the user is empty at runtime, and if it is empty, it will automatically create a default administrator account.

If you forget the administrator account, you can only backup the existing user profile folder and regenerate a new administrator account to overwrite.

Contribute

If you find any problems during use, you can submit an Issue or submit a Pull Request after fork modification.

The code needs to keep the existing format, and no redundant code should be formatted. For details, please refer to here.

Problem report

Feedback on any problems found is welcome and must be fixed in time.

If you find a serious security vulnerability and it is inconvenient to publish it publicly, please send an email to: mcsmanager-dev@outlook.com.

The name of the bug discoverer will be appended to the code after the security issue is fixed.