CoinsDiscordEngine

Minecraft 版本： 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper purpur

标签： economy social utility

---

? Description

CoinsDiscordEngine (CDE) is an addon that connects the CoinsEngine economy plugin with DiscordSRV.

The main goal of this plugin is to send notifications to a specified Discord channel whenever financial operations occur on your server. This is perfect for public transaction logs or economy administration auditing.

✨ Key Features

• Transaction Logs: Logs /pay commands (player -> player) directly to Discord.
• Admin Monitoring: Notifications when administrators give (add) or take (remove) currency.
• Reason Support: Displays the reason for the transfer or balance change if one was provided.
• Flexible Configuration: Fully customizable messages and command aliases.
• Modern Core: Written in Kotlin, supports Paper and it's forks.

---

? Requirements

To run this plugin, ensure you have the following components:

Component	Requirement
Java	Version 21 or higher
Server Core	Paper, Purpur, Folia (1.21+)
CoinsEngine	Version 2.6.0
DiscordSRV	Version 1.30.3+

---

? Installation

1. Install and configure CoinsEngine and DiscordSRV. Ensure they are working correctly.
2. Download the CoinsDiscordEngine .jar file.
3. Place it into your server's /plugins/ folder.
4. Restart the server.
5. Open plugins/CoinsDiscordEngine/config.conf and set the Discord Channel ID (channelId).
6. Run /cde reload or restart the server.

---

? Commands & Permissions

The plugin uses its own command system that wraps CoinsEngine functionality to trigger notifications.

ℹ️ Note: The main command is /cde (or your custom prefix defined in the config).

Command	Aliases (Configurable)	Description	Permission Required
/cde pay <player> <amount> [reason]	pay, send	Transfer currency to a player	None
/cde add <player> <amount> [reason]	add, deposit	Give currency to a player	coinsengine.command.give
/cde remove <player> <amount> [reason]	remove, withdraw	Take currency from a player	coinsengine.command.take
/cde reload	reload	Reload configuration	coinsengine.command.reload

---

⚙️ Configuration

config.conf

Main plugin settings. Define your channel ID, currency, and command aliases here.

? Show config.conf ```hocon # Prefix for custom commands prefix=mycustomprefix # Whether to enable prefixed commands (e.g. /mycustomprefix pay) prefixed-commands=false # Whether to enable non-prefixed commands (e.g. /pay, /add, etc.) non-prefixed-commands=true # Currency ID from CoinsEngine (default is 'coins') currency-id=coins # Discord Text Channel ID where logs will be sent (CHANGE THIS!) channel-id=0 # Command aliases alias { pay=[ pay, send ] add=[ add, deposit ] remove=[ remove, withdraw ] } # Since CoinsEngine 2.6.0 I need to log operations myself, so these are options log { log-pay-to-file=true # 'operations.log' near config file log-pay-to-console=false } # Toggle notifications for specific actions notification { pay=true add=true remove=true } ```

language.conf

Message configuration. You can use placeholders like {from}, {to}, {target}, {amount}, {reason}, and {purpose}.

? Show language.conf (Default English) ```hocon something-went-wrong="Something went wrong, transaction cancelled" # Player-to-player transaction messages # Placeholders: {from}, {to}, {amount}, {currency}, {purpose} transaction-message="`{from}` sent `{to}` {amount} {currency}" transaction-message-purpose="`{from}` sent `{to}` {amount} {currency}. Purpose: {purpose}" # Admin 'add' messages # Placeholders: {source}, {target}, {amount}, {currency}, {reason} add-message="`{target}` account was replenished with {amount} {currency}" add-message-reason="`{target}` account was replenished with {amount} {currency}. Reason: {reason}" # Admin 'remove' messages # Placeholders: {source}, {target}, {amount}, {currency}, {reason} remove-message="{amount} {currency} were withdrawn from `{target}`'s account" remove-message-reason="`{amount} {currency} were withdrawn from `{target}`'s account. Reason: {reason}" # Currency noun forms (mostly for slavic languge users) # ONE: 1 # FEW: 2-4 # MANY: 11-14 and everything else currency-forms { one=coin few=coins many=coins } ```

---