2
0
mirror of https://github.com/MCSManager/MCSManager.git synced 2024-12-27 07:59:08 +08:00
Go to file
2024-03-11 17:17:44 +08:00
.github Update webpack.yml 2023-11-15 21:44:39 -06:00
common Feat: Add node-pty 2024-03-08 15:05:40 +08:00
daemon Feat: pty resize via named pipe 2024-03-11 17:17:44 +08:00
frontend Feat: isLoading status 2024-03-11 11:12:04 +08:00
languages Fix: Schedule Dialog 2024-03-08 16:49:06 +08:00
panel Feat: quick install 2024-03-05 17:54:57 +08:00
.gitignore Feat: quick install 2024-03-05 17:54:57 +08:00
.npmrc Fix: i18next scanner config 2023-09-06 11:32:08 +08:00
.prettierignore Refactor: language file 2022-09-24 10:28:12 +08:00
.prettierrc.json Feat: change file permission 2022-08-11 14:06:42 +08:00
build.bat Fix: build bat 2023-12-28 22:00:45 +08:00
build.sh Refactor: common code 2023-11-15 21:22:06 +08:00
i18-scanner.config.js Optimize: QuickStartFlow.vue max-height 2023-12-12 17:13:03 +08:00
install-dependents.bat Feat: add workspace "npm install" 2023-11-30 11:05:12 +08:00
install-dependents.sh Feat: add workspace "npm install" 2023-11-30 11:05:12 +08:00
LICENSE Refactor: project structure 2023-08-21 10:49:37 +08:00
npm-dev-macos.sh Fix: auto open page & npm command 2024-01-15 14:41:51 +08:00
npm-dev-windows.bat Fix: auto open page & npm command 2024-01-15 14:41:51 +08:00
package-lock.json Feat: 7zip test 2024-02-06 20:55:10 +08:00
package.json Fix: wavesurfer.js package.json error 2024-02-05 15:20:23 +08:00
README_CN.md [Doc] update readme - zh_cn 2024-02-17 02:28:37 -05:00
README.md Update README.md 2024-02-18 10:37:28 +08:00


What is MCSManager?

MCSManager Panel (or simply MCSM) is an open-source, distributed, lightweight control panel that can be deployed within minutes and supports most game servers or console programs.

MCSM has already gained a certain level of popularity within the community, specifically Minecraft. It provides one-stop management for instances across multiple servers and provides a secure and reliable multi-user permission system. In addition, MCSM continuously offers support to server administrators of Minecraft, Terraria, and Steam games, aiming to provide a healthy and prosperous community.

failed_to_load_screenshot.png


Features

  1. One-click deployment of Minecraft Java/Bedrock Server
  2. Compatible with most Steam game servers. (e.g. Palworld, Squad, Project Zomboid, Teraria, etc.)
  3. Customizable UI, create your own layout
  4. Support Docker virtualization, multiuser, and commercial services.
  5. Manage multiple servers with a single web interface.
  6. More...

Runtime Environment

MCSM supports both Windows and Linux. The only requirement is Node.js and several libraries used for decompression.

Require Node.js 16.20.2 or above.


Installation

Windows

For Windows systems, download the binary from MCSM's official website:

Go to: https://mcsmanager.com/


Linux

One-Command Deployment

wget -qO- https://raw.githubusercontent.com/mcsmanager/Script/master/setup.sh | bash
  • Only supports x86_64 architecture Ubuntu/Centos/Debian/Archlinux.
  • After installation, use command systemctl start mcsm-{web,daemon} to start MCSM.
  • Installation directory: /opt/mcsmanager/.

Linux Manual Installation

  • If the installation script failed to execute correctly, you can try install it manually.
# Create /opt directory if not already
mkdir /opt
# Switch to /opt
cd /opt/
# Download Node.js 20.11. If you already have Node.js 16+ installed, ignore this step.
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz
# Decompress Node.js source
tar -xvf node-v20.11.0-linux-x64.tar.xz
# Add Node.js to system PATH
ln -s /opt/node-v20.11.0-linux-x64/bin/node /usr/bin/node
ln -s /opt/node-v20.11.0-linux-x64/bin/npm /usr/bin/npm

# Prepare MCSM's installation directory
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

# Download MCSManager
wget https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
tar -zxf mcsmanager_linux_release.tar.gz

# Install dependencies
./install-dependency.sh

# Please open two terminals or screens.

# Start the daemon first.
./start-daemon.sh

# Start the web interface at the second terminal or screen.
./start-web.sh

# For web access, go to http://localhost:23333/
# In general, the web interface will automatically scan and add the local daemon. 

This installation method does not automatically register the panel as a system service. Therefore, it is necessary to use the screen software for management. If you want to use the system service to manage MCSManager, please refer to the documentation.


Browser Compatibility

  • Support Chrome Firefox Safari modern browser.
  • Support for IE has been discontinued.

Internationalization (i18n)

MCSManager currently supports English and Simplified Chinese and is capable of supporting more languages in the future.

The translation and software internationalization were completed together by KevinLu2000, Lazy, zijiren233, and Unitwk. Many thanks for their contributions!


Setting Up the Development Environment

This section is intended for developers. General users can safely ignore this section.

MacOS

git clone https://github.com/MCSManager/MCSManager.git
./install-dependents.sh
./npm-dev-macos.sh

Windows

git clone https://github.com/MCSManager/MCSManager.git
./install-dependents.bat
./npm-dev-windows.bat

Build the Compiled Version

./build.bat
# Or
./build.sh

Code Contributing

If you encounter any issues during use, feel free to submit an Issue or fork them yourself and submit a Pull Request.

Submitted code needs to maintain the same coding style. For more information, please refer to this issue.


BUG Reporting

Reporting any bug or issue is welcomed and much appreciated. We will fix any issue promptly and your help will make MCSM better :-D

In case of a severe vulnerability, when it is not appropriate to disclose to the public, please send an email to: mcsmanager-dev@outlook.com. Your name and contribution will be added to the code after the bug is fixed.


License

The source code follows the Apache-2.0 License.

Copyright ©2024 MCSManager.