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
Code (Text):
# 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!
- UUIDsupport done in v1.1.2
- Look up the sales of offline players done in v1.1.2
- Ignore ChestShop's Admin Shop done in v1.1.2
- History pagination done in v1.2
- SQLite support done 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
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
