CSN was originally developed by BetaBlaze and released to BukkitDev. I took over the project in 2014 when the UUID update came around and have been maintaining it since then. Because most of my plugins are already on Spigot I decided to release the latest update here too.
ChestShop Notifier (CSN) is a plugin that records ChestShop transactions to a MySQL database. When a shop owner logs onto the server, they will be presented with an option to view sales from when they were offline.
Commands
- /csn help → Shows available commands
- /csn history [<page>] → Shows sale history and marks them as read
- /csn history [<username> [<page>]] → Shows sale history of another player
- /csn clear [<usernamse>] → Removes all read entries (from the database)
- /csn cleandatabase → Remove database entries. Parameters:
--older-than, -o days → Removes entries older than days
--user, -user username/uuid → Removes entries from a single user only
--read-only, -r → Removes only read entries, default behaviour
--all, -a → Removes all entries - /csn upload → Forces the plugin to upload all data to the database (in v1.1 and higher this should be only used after database connection problems!)
- /csn reload → Reloads configuration and connects to database using new config
- /csn convert → Converts the database table csn to UUIDs. (table csn gets converted in csnUUID and the username table renamed to csnOLD)
Permissions
- csn.user → Allows user to receive notifications when they log in, and access to /csn history.
- csn.admin → Super permission node. Access to all commands. (especially upload, reload and convert)
For all permissions take a look at the plugin.yml.
Config
# Chest Shop Notifier
# Config file for 1.2
logging:
admin-shop: true
notifications:
notify-on-user-join: true
delay-seconds: 5
history:
max-rows: 10
debugging:
verbose: true
database:
host: 'localhost'
port: 3306
dbname: 'database1'
username: 'dbadmin'
password: '123456'
clean-on-startup:
enabled: false
parameters: "--older-than 30 --all"
messages:
sales: "&c ** You made &f{sales} sales&c since you last checked."
history-cmd: "&c ** To see them, type &f/csn history&c."
history-caption: "&dChestShop Notifier // &7Latest Commissions"
history-empty: "&cNothing to show."
history-bought: "&f+ &9{player} &7bought &a{count}x&9{item} &f{timeago} ago &a(+{money})"
history-sold: "&f- &9{player} &7sold you &c{count}x&9{item} &f{timeago} ago &c(-{money})"
history-footer-page: "&c- Page &f{current}&c/&f{pages}&6 - &7/csn history <page>"
history-footer-clear: "&c- To remove all old entries, type /csn clear"
history-clear: "&cHistory cleared! New sales will continue to be recorded."
history-marked-read: "&cUnread entries marked read!"
Requirements
- Functional MySQL server. This plugin only uses MySQL, nothing else.
- ChestShop installed and running.
Installation Instructions
Installing this plugin is simple. Just download and drag ChestShopNotifier.jar into your server's plugins directory.
Next, restart and log into your server. When you try to use /csn history, you'll receive an error that the database isn't connected. Follow these steps to get it working:
- Open the plugin folder (/plugins/ChestShopNotifier)
- Edit the config.yml with your database settings (feel free to change other config as well)
- Save the file
- In-game, run /csn reload to reload config and connect to the database.
If it says the database was connected, you're good to go!
Planned Features
To request features open an issue!
UUIDsupportdone in v1.1.2Look up the sales of offline playersdone in v1.1.2Ignore ChestShop's Admin Shopdone in v1.1.2History paginationdone in v1.2SQLite supportdone in v1.3.3- Auto updater & version checker
- Translation system (partially done in v1.1.2, you can set your own messages in the config)
For all changes take a look at the commits!
Source Code & Dev Builds
- You can retrieve the source code online at https://github.com/ChestShop-authors/ChestShopNotifier
- Development builds are available on the Minebench.de Jenkins build server: http://ci.minebench.de/job/ChestShopNotifier/
Donations
Feel free to comment with your ideas, bugs, or requests, ideally by opening an issue on the github repo.
If you really want to donate monetarily then click here.
Demonstration
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
15.6MSueta
Emotecraft
Create your own emotes in Minecraft.
7.9MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
4.7MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta