GuildSync

# GuildSync

GuildSync is a modular, server-side Discord bridge for Fabric 1.20.1. It keeps your Discord community connected to your Minecraft server with live status information, configurable slash commands, and optional chat synchronization.

## Features

- Server-side only — players do not need to install GuildSync
- Discord slash commands:
  - `/status` — server status, TPS, player count, and uptime
  - `/players` — currently online players
  - `/server` — configured server information
  - `/info` — creates and continuously updates a server-stats embed
  - `/say` — sends a Discord message to the Minecraft chat
  - `/whitelist add`, `/whitelist remove`, `/whitelist list`
  - `/help`
- Optional Minecraft ↔ Discord chat bridge
- Persistent `/info` embed that survives server restarts
- Role-based access for administrative Discord commands
- Fully configurable through YAML files
- Modular features: enable only what your server needs

## Configuration

GuildSync creates two files in `config/guildsync/`:

- `config.yml` — bot token, Discord IDs, enabled modules, command settings, role access, messages, and server details
- `data.yml` — automatically maintained internal data, including the persistent info-embed message ID

Never share your Discord bot token. Keep it only in your server's `config.yml`.

## Installation

1. Install Fabric Loader and Fabric API for Minecraft 1.20.1.
2. Place GuildSync in the server's `mods` folder.
3. Start the server once to generate the configuration files.
4. Add your Discord bot token and Discord IDs to `config/guildsync/config.yml`.
5. Restart the server.

## Permissions and Security

Administrative commands are disabled by default until one or more Discord role IDs are configured. GuildSync does not provide a Minecraft permission system and does not require Vault, LuckPerms, or an external editor.

## Authors

- TheCoderRBLX — Main
- ENM Development — Development Team

## License

GuildSync is licensed under the MIT License.