node-bungeecord

BungeeCord proxy server configuration and plugin management for XegamesOnline Minecraft network.

Overview

This repo manages the BungeeCord proxy server configuration, modules, and plugins. Changes pushed to release are automatically deployed and the service is restarted.

File Structure

.
├── .forgejo/
│   └── workflows/
│       └── deploy.yml    # Auto-deploy workflow
├── config.yml            # Main BungeeCord configuration
├── locations.yml         # Server locations configuration
├── modules.yml           # Modules configuration
├── modules/              # BungeeCord modules
├── plugins/              # Plugin jars and configurations
├── scripts/
│   └── restart.sh        # Service restart script
└── README.md

Structure

File/Folder	Description
config.yml	Main BungeeCord configuration
locations.yml	Server locations configuration
modules.yml	Modules configuration
modules/	BungeeCord modules
plugins/	Plugin jars and configurations

Deployment

When a pull request is merged into release, the deploy workflow will automatically:

1. SSH into the target server
2. Pull the latest code from the release branch
3. Run scripts/restart.sh which restarts the BungeeCord service

You can also trigger a deploy manually by pushing directly to release:

git push origin release

Setup

Symlinks

Config files are symlinked from this repo to /opt/bungeecord/. To set up symlinks on a new server:

sudo ln -sf ~/node-bungeecord/config.yml /opt/bungeecord/config.yml
sudo ln -sf ~/node-bungeecord/locations.yml /opt/bungeecord/locations.yml
sudo ln -sf ~/node-bungeecord/modules.yml /opt/bungeecord/modules.yml
sudo ln -sf ~/node-bungeecord/modules /opt/bungeecord/modules
sudo ln -sf ~/node-bungeecord/plugins /opt/bungeecord/plugins

Sudoers

Allow the restart script to run without a password prompt:

sudo visudo

Add:

xeplosion ALL=(ALL) NOPASSWD: /usr/bin/systemctl restart bungeecord.service

Runner

Requires the forgejo-runner to be running on the VPS. See the infrastructure-template for setup instructions.