CoinsDiscordEngine

CoinsDiscordEngine

Get notifications about coins engine operations on discord

200 downloads 0 followers

CoinsDiscordEngine

Java Version Minecraft Version License

Seamlessly integrate CoinsEngine economy with Discord via DiscordSRV.
A simple and efficient bridge for transaction logging and notification management.


💎 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
# 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)
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
}


Developed with â¤ī¸ by Animepdf

No gallery available for this project.

Version Minecraft Loader Download

v1.2.1 Decimal fixes

v1.2.1

1.21.10, 1.21.11, 1.21.8, 1.21.9
folia, paper, purpur
Download

v1.2.0 HOCON config + currency forms

v1.2.0

1.21.10, 1.21.11, 1.21.8, 1.21.9
folia, paper, purpur
Download

v1.1.0 CoinsEngine 2.6.0

v1.1.0

1.21.10, 1.21.11, 1.21.8, 1.21.9
folia, paper, purpur
Download

v1.0.0 CoinsEngine 2.5.3

v1.0.0

1.21.10, 1.21.11, 1.21.8, 1.21.9
folia, paper, purpur
Download