https://github.com/liebki/simplecrosschat
SimpleCrossChat lets players chat globally across multiple Minecraft servers using the MQTT protocol!
https://github.com/liebki/simplecrosschat
minecraft minecraft-chat-plugin minecraft-plugin mqtt mqtt-client spigot-plugin
Last synced: 27 days ago
JSON representation
SimpleCrossChat lets players chat globally across multiple Minecraft servers using the MQTT protocol!
- Host: GitHub
- URL: https://github.com/liebki/simplecrosschat
- Owner: liebki
- License: gpl-3.0
- Created: 2024-12-14T09:27:27.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-17T17:10:31.000Z (over 1 year ago)
- Last Synced: 2025-04-05T00:28:06.424Z (about 1 year ago)
- Topics: minecraft, minecraft-chat-plugin, minecraft-plugin, mqtt, mqtt-client, spigot-plugin
- Language: Java
- Homepage: https://www.spigotmc.org/resources/%EF%B8%8F-simplecrosschat.121291/
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SimpleCrossChatPlus Plugin
## Description
SimpleCrossChatPlus is an advanced Minecraft plugin for cross-server communication, entity transfer, item transfer, money transfer, and more. It integrates with MQTT brokers and Vault, supporting private messaging, server info, and player location features.
## Java Version
Requires **Java 21** for Minecraft 1.21 and above.
## Features
- **Global chat**: Real-time chat across servers (can be toggled or deactivated).
- **Cross-server private messaging**: Send private messages between servers.
- **Entity transfer**: Transfer animals, owned entities, or any entity type across servers.
- **Item transfer**: Send items between servers.
- **Money transfer**: Transfer money between servers (Vault integration required).
- **Player locate**: Locate players across servers.
- **Server info request**: Request information about other servers.
- **Server list request**: View a list of connected servers.
- **Toggle chat/notifications**: Enable or disable global chat and notifications per player.
- **Admin controls**: Disable/enable cross-server features for specific players.
- **Advanced permissions**: Granular control over all features.
- **Customizable communication security**: Host a private MQTT broker for secure communication.
- **Broadcast message formatting**: Customize message appearance.
- **Vault integration**: Soft-depend on Vault for economy and permissions support.
## Important Notes
### Global Message Handling
- **Every message is sent through the broker**: All global chat and cross-server messages are transmitted via the broker, encrypted but still accessible to parties connected to the broker.
- **Feature deactivation**: Global chat and other features can be deactivated in the configuration to reduce message transmission.
- **Third-party risks**: Using public brokers (e.g., broker.emqx.io) means messages could theoretically be intercepted. Host your own broker for privacy.
- **Message scope**: Only global chat and cross-server messages are sent. Other plugin messages are not transmitted unless using the relevant commands.
## Setup
1. **Install an MQTT Broker** (default: broker.emqx.io, but private broker recommended).
2. **Install the plugin**: Place the JAR in your server's `plugins` folder.
3. **Configure options** (optional): Update `options.yml` for broker address, server name, and message format.
4. **Install Vault** (optional): For money transfer and advanced permissions.
5. **Restart/Reload server** to apply changes.
6. **Verify communication** between servers.
## Commands
- `/scc` - Main command for plugin management and all features. Aliases: `/simplecrosschat`, `/crosschat`
- `/scc com` - Request server list
- `/scc disable ` - Admin disable/enable cross-server features for a player
- `/scc etp ` - Transfer entity
- `/scc get ` - Get item or entity
- `/scc info ` - Request server info
- `/scc itp ` - Transfer item
- `/scc locate ` - Locate player across servers
- `/scc toggle ` - Toggle chat/notifications
- `/scc transfer ` - Transfer money (Vault required)
- `/sccpm ` - Send cross-server private message. Aliases: `/xpm`, `/crosspm`
- `/sccm ` - Alternate command for cross-server private message
## Permissions
- `sccplus.admin.*` - All admin permissions (default: op)
- Includes: `sccplus.admin.disable`, `sccplus.admin.com`, `sccplus.admin.info`, `sccplus.admin.bypass`
- `sccplus.entity.transfer` - Transfer entities cross-server (default: true)
- `sccplus.entity.tier.owned` - Transfer owned entities only (default: true)
- `sccplus.entity.tier.animals` - Transfer all animals (default: op)
- `sccplus.entity.tier.everything` - Transfer any entity type
- Additional permissions for item transfer, money transfer, player locate, etc.
## Security Recommendations
- **Host a private broker** for secure communication.
- **Encryption**: Messages are encrypted (`AES/CBC/PKCS5Padding`), but public brokers are not foolproof.
- **Inform players** about message transmission and privacy risks.
## Version Compatibility
- **Old to New:** Transferring entities and items from older Minecraft versions to newer ones works most often without issues. Newer versions can read and upgrade legacy data formats.
- **New to Old:** Transferring from newer to older versions is unreliable. Items usually fail due to NBT/data differences, while some entities may work if their type and properties exist in both versions.
- **Same Version:** Transfers between servers running the same Minecraft version work as expected.
## Usage
1. Install the plugin in your server's `plugins` folder.
2. Optionally configure the `options.yml` file.
3. Install Vault for extended features (optional).
4. Restart or reload your server.
5. Use the commands to communicate and transfer data across servers.
## Disclaimer
This plugin is provided "as-is" without any warranty. The developer is not liable for privacy concerns, misuse, third-party interception, or legal implications. Server owners are responsible for secure and compliant usage.
---
#### Enable cross-server communication responsibly with **SimpleCrossChatPlus**!