Amethyst Cache Compactor (Previously CamStorage)

This entry is now receiving new releases once again. The plugin is also now open-source! You can grab the source from the GitHub page at https://github.com/CameronRedmore/Amethyst-Cache-Compactor

The page for this plugin on my website: www.amethystdevelopment.co.uk/BukkitPlugins/ACC

CamStorage

Welcome to CamStorage

CamStorage is a plugin that I made that enables Applied Energistics type storage in Bukkit. This storage allows you to store entire inventories to discs enabling you to easily move inventories, store large amounts of items in one place, access all of your items from multiple places and more. CamStorage enables you to create massive inter-world storage systems by simply placing a disc in a dropper. If you've ever thought minecraft needs some better storage options, this plugin is for you.

How to use CamStorage

Obtaining Discs

The main part of CamStorage is the discs, without them you can't store anything. Discs have three different tiers, each with different amounts of storage space. Storage space comes in two forms, the maximum amount of items total and the maximum amount of different types of items. The easiest way to explain this is through an example. A disc which has 128 cobblestone and 10 stone in it, has a total amount of items of 138 but there are only two different types of items. Please note that anything that would not stack with other items like it (i.e an item with custom NBT or damage values) will take up another type of item on the disc. For example, if you had a disc which contained a diamond sword with no enchantments and a diamond sword with sharpness 1 on it, it would have two item types used, if however you had a disc which contained two diamond swords with no enchantments, it would only have one item type used. I bet you're wondering how you obtain one of these discs. All three discs have crafting recipes which are shown here:

Disc Name	Storage Space	Permission	Recipe
Basic Disc	16 item types, 8,192 items total.	camstorage.craft.basic
Advanced Disc	32 item types, 32,768 items total.	camstorage.craft.advanced
Expert Disc	64 item types, 131,072 items total.	camstorage.craft.expert

Using Discs

Now you have your storage disc(s), how do you use them? Well, to use the discs, you need to place them in a dropper which is placed directly next to a chest. Once you have done this, simply click the chest and you will have access to the disc. You can now drop items in and take items out of this inventory. Placing items in is simple, just drop them from your inventory into the interface and they'll be stored on the disc. If you have more types of items than can fit onto the inventory screen, you can click the wool in the bottom right to move between pages of items, once you reach the end, you will go back to the beginning automatically. To take items out click an item's entry on the interface at the top, right clicking will take one item, left clicking will take a full stack of the item, if there isn't enough of the item to take as much as you wish, you will only receive as many as was stored in the disc. You can continue adding different discs to the dropper or even add more droppers and you'll expand your storage space. To view the contents of discs, you will need the permission "camstorage.view", to take items out of discs you need the permission "camstorage.take" and to put items in you will need the permission "camstorage.add". Once you have items stored on a disc, they're stored on it meaning you can take the disc out, move it to other systems etc. and it will still have all of your items which can be accessed by placing it in another dropper next to a chest and accessing the chest.

Copying Discs

If you wish to be able to access the contents of a disc from multiple locations, you can copy the disc by placing some discs you want to copy to in a dropper and placing a hopper above the dropper with the disc you want to copy from in it. When you do this, the discs in the dropper will all be linked to the inventory that the original disc was, you can then take these 'copies' and place them in other systems to access the same sets of items. All of these discs will reflect any change made on any other, I.E taking an item out of one will take the item out of all of them.

Remote Disc Access

This feature is only available in versions of the plugin which are higher than or equal to 1.0.6

If you wish to have remote access to the contents of your discs, you can make a remote disc interface with the following crafting recipe:

Once you have a remote disc interface, you will need to link it to the chest where you access all of your discs. To do this place a hopper above the chest that you use to access your items and place your unlinked remote into the hopper. The linked remote will be inserted into the actual chest so ensure you have no discs in any of your droppers at the time of accessing the chest. You can also get the remote out by simply breaking and replacing the chest. Once you have linked the remote, you can access the contents of that interface anywhere in the world by simply left or right clicking with the remote.

Importing & Exporting

This feature is only available in versions of the plugin which are higher than or equal to 1.0.8 Importing to a network is easy, simple place a hopper above an access terminal into your network and drop items into it, the items will make their way automatically into the discs in the network. This feature is not currently available but is under development, expect it in an update sometime in the future.on Exporting from a network is not currently possible as I'm not sure how to enable users to specify what items they want to be pulled out from the network and what items to leave in place.

How the Discs Work (For server admins)

Well, I wish I could say that they're all interlinked on some kind of fancy network thing, but they're not, they store their items into the storage.yml file in this plugins' folder. Each disc has its own UUID which can be seen at the bottom of each disc's lore and the storage.yml contains all the UUIDs and the items, if you as a server admin wish to empty a disc, completely delete the 'items:' section under the UUID of the disc you want to delete from, reload the server (or just the plugin if you have dynamic plugin reloading capabilities, I'll be adding an in-game config reloading command shortly) and all the items will magically vanish, as if they never even existed.

Seeing Remaining Space

To see how much space you have remaining in a disc, take the disc out of its dropper and place it in your inventory, mouse over the disc and its lore will tell you how much storage being used out of the maximum available. You may need to take it out of your inventory and place it back in for it to update.

Permissions

The permissions have already been placed above but I will include another copy here.

Commands

This feature is only available in versions of the plugin which are higher than or equal to 1.0.8

Future Plans

• Exporting items via hoppers
• No more at the minute, if you have any suggestions, be sure to post a comment!

Servers Running CamStorage

Does your server run CamStorage? Feel free to post a comment below and I'll add your server to this list if you want!

Power and Cable System

This feature is only available in versions of the plugin which are higher than or equal to 1.1.1 To expand networks, you can use cables, these are simply purple stained glass panes. Each cable will be checked for droppers around it to expand your networks. A power system can now also be enabled, make sure energy.consume is set to true in the config.yml and the plugin will hook into Sensible Toolbox for power. To power a system just place one or more Sensible Toolbox Battery Box(es) next to some cable in your network, you must provide power into any Battery Boxes you might have and your system will be powered. The amount of energy networks consumed is configurable in the config.yml. Please note, to get the power options you must first delete your old config.yml if coming from a version of CamStorage that is earlier than 1.1.1.

Automatic Updater

All versions of the plugin from 1.1 upwards have automatic updating support, settings for this (including disabling completely or just disabling automatic downloading) can be found in the config.yml in this plugins' folder.

Metrics

All versions of this plugin from 1.0.3 upwards have Metrics support, you can opt-out of this by editing plugins/Plugin Metrics/config.yml and changing opt-out to true. The metrics data is sent to mcstats.org and uses the MetricsLite class, meaning no custom data is sent. Here is the data that is read and sent to mcstats.org by the class as copied from the MCStats page (https://bukkit.org/threads/mcstats-plugin-metrics-r7-easy-advanced-plugin-statistics.77352/) I suggest you go there for further information about the data collection. The following data is read from the server in some way or another:

• File Contents of plugins/Plugin Metrics/config.yml (created if not existent)
• Players currently online (not max player count)
• Server version string (the same version string you see in /version)
• Plugin version of the metrics-supported plugin
• Mineshafter status - it does not properly propagate Metrics requests however it is a very simple check and does not read the filesystem

The following data is sent to http://mcstats.org:

• Metrics revision of the implementing class
• Server's GUID
• Players currently online (not max player count)
• Server version string (the same version string you see in /version)
• Plugin version of the metrics-supported plugin

The only information I shall be using from this is how many servers currently have the plugin running to see how many people have taken an interest in the plugin. Anyone can access how many servers and how many players are currently using the plugin from the mcstats.org page, you can also view how many servers are running each version of the plugin here.

End Note

Thank you for trying CamStorage, I hope you find it useful and enjoy your usage of it. If you find any issues with the plugin, please open a ticket or post a comment and I'll get back to you about the issue. If you need any of the above information clarifying (it's quite complicated to understand but once you've got it, it becomes easy) post a comment here and I'll explain whatever you need. - Camzie99