![\"Requires](\"https:\/\/raw.githubusercontent.com\/RecraftorsMC\/.github\/main\/pictures\/unruled-badge.png\"){kind=icon}
<\/p>\nEver wondered why, when a chest is open, items don’t fall in?
\n… Okay, I’ll admit, me neither, not until I had this idea. But when you think of it…
\nIt just makes sense, right?<\/p>\n
So now, you can proudly say that **Chests are chests**! And enjoy making items fall into your storage
\ninstead of lamely putting them in by hand!<\/p>\n
But as items can fall *into* an open box… Shouldn’t they be able to fall *down* from one as well,
\nprovided it was open on the right side?
\nThus, you can make it so barrels, when open and facing down, drop *all* of their content to the ground!<\/p>\n
Going back to the chest, if you can open the lid to make items fall in, shouldn’t the lid throw items away
\nupon being opened?
\nThat’s right! With this mod, you can make it so opening a chest throws all the items standing on it upon opening!
\n(Limited to items only for the sake of one’s life preservation)<\/p>\n
Last but not least, since opening a container has always only been a manual task so far,
\nin order to allow you to automate these new options, opening a container can now be done
\nby activating an *empty* dispenser pointing at said container!<\/p>\n
Now the game will feel more natural, even just a little bit, won’t you agree?<\/p>\n
## Features<\/p>\n
* Inserting items in open containers
\n * default: enabled
\n * gamerule: `chests.insertOpen`
\n* Making item fall from open-from-below containers
\n * default: disabled
\n * gamerule: `chests.barrelFall`
\n * Special item fall (e.g. snowballs falling as actual thrown snowballs)
\n * default: enabled
\n * gamerule: `chests.barrelFall.throwableSpecial`
\n * item tag: `#chests_are_chests:special_fall`
\n* Making chest lids throw items
\n * default: disabled
\n * gamerule: `chests.lidFling`
\n * entity type tag: `#chests_are_chests:flingable`
\n * Horizontal flinging velocity
\n * default: 0.25
\n * gamerule: `chests.lidFling.horizontalPower`
\n * Vertical flinging velocity
\n * default: 0.6
\n * gamerule: `chests.lidFling.verticalPower`
\n* Opening containers by powering empty dispensers
\n * default: enabled
\n * gamerule: `chests.dispenserOpen`
\n * Automated opening duration (in world ticks)
\n * default: 10
\n * gamerule: `chests.dispenserOpen.duration`<\/p>\n
## Dependencies<\/p>\n
<\/p>\n
## Mod compatibilities<\/p>\n
### Internal compatibilities
\nWhile compatibilities are planned, direct implementation by the mods themselves would always be preferred.
\nHence, if a mod of yours is [planned](#planned), [being worked on](#being-worked-on), or even already implemented,
\ndon’t hesitate to [make your own](#make-your-own), and if need be, contact us either for help or to tell us
\nthat we have no need to keep our own compatibility.<\/p>\n
#### Implemented
\n* Anner’s Iron Chests
\n* Mythic Metals Decorations
\n* Reinforced Chests
\n* Expanded Storage
\n* Spectrum<\/p>\n
#### Natural
\n_Known mods that (should) have natural compatibility with this mod, with no extra implementation_
\n* Variant Chests
\n* Variant Barrels
\n* Chest Colorizer
\n* More Chests Variants<\/p>\n
#### Being worked on
\n* Lootr<\/p>\n
#### Planned
\n* myLoot
\n* More Chests
\n* Compact Storage<\/p>\n
#### Internally refused
\n* Iron Chests: Restocked
\n Due to mod author names poorly registered, this mod cannot be easily be dealt with.
\n Hence, it has been decided no to attempt implementing builtin compatibility.<\/p>\n
### Make your own<\/p>\n
#### Container implementation<\/p>\n
The mod tweaks the block entities’ and item entities’ behaviours.
\nIn order to implement compatibility with this mod, you need your custom block entity to implement
\nthe `mc.recraftors.chestsarechests.util.FallInContainer` interface.<\/p>\n
You may as well make use of other interfaces, such as `mc.recraftors.chestsarechests.util.BlockOpenableContainer`
\nor `mc.recraftors.chestsarechests.util.BooleanHolder`, which you can either use as you please, or can exploit
\nif you already extend the vanilla chest or barrel classes.<\/p>\n
Don’t hesitate to look at the
\nchest
\nand barrel
\nimplementations for a reference of how to handle block opening and orientation within the provided methods.<\/p>\n
Also don’t fear about more methods appearing with updates and your mod not implementing them, causing issues.
\nNo methods are planned for deletion, or would include a change of primary version. And all new method
\nwill _always_ come with a default implementation, to avoid pointless issues.<\/p>\n
#### Item implementation<\/p>\n
The mod enables for some item (registered in the appropriate item tag) to have a custom behaviour upon “falling”
\nfrom a container. In order to do that, the item itself must implement the
\n`mc.recraftors.chestsarechests.util.ContainerItemHelper` interface.<\/p>\n
This interface comes up with two methods to be implemented. The first one, optional, indicates the item fall directions.
\nThis allows to specify on which open side of a container can the item come out. (e.g. upwards-gravitated items may
\nspecify an upward fall direction)<\/p>\n
By default, this first method will return `DOWN`.<\/p>\n
The second one makes the actual implementation of a special fall behaviour. It should use the first method to know
\nwhether to run it or not, and execute what is intended. This method’s return value indicates whether the item stack
\nfell (and theoretically is consumed), or not, and therefore shouldn’t be bothered with attempting to make it fall
\nin the same direction, to avoid causing more runtime computing stress.<\/p>\n
Don’t hesitate to look at the
\narrow or
\nsnowball implementations
\nfor a reference of how to handle special item fall.<\/p>\n
Then again, don’t fear about more methods appearing with updates, for all new one will then again include a default
\nimplementation, if possible based on already existing methods.<\/p>\n
#### Examples “`java @Override @Override @Override @Override @Override @Override @Override void onOpen() { “`java public boolean defaultOnOpenTick(ItemStack stack, FallInContainer container, Direction direction, World world, Vec3d pos, Vec3d velocity) { —<\/p>\n ### Showcase<\/p>\n
\nUp to date with version **0.5**<\/p>\n\nContainer implementation<\/summary>\n
\npublic class MyCustomBlockEntity extends BlockEntity implements FallInContainer {
\n private boolean isOpen;
\n private final int size;
\n private final DefaultedList
\n private final Map
\n public boolean chests$tryInsertion(ItemEntity entity) {
\n return FallInContainer.chests$inventoryInsertion(this.content, entity, this::setStack);
\n }<\/p>\n
\n public boolean chests$isOpen() {
\n return isOpen;
\n }<\/p>\n
\n public VoxelShape chests$InputAreaShape() {
\n return FallInContainer.ABOVE;
\n }<\/p>\n
\n public void chests$forceOpen(ServerWorld world, BlockPos at, BlockState from) {
\n this.isOpen = true;
\n this.onOpen();
\n }<\/p>\n
\n public boolean chests$tryForceOpen(BlockState from) {
\n ServerWorld serverWorld = (ServerWorld) this.getWorld();
\n BlockPos blockPos = this.getPos();
\n this.chests$forceOpen(serverWorld, blockPos, from);
\n ChestsAreChests.scheduleTick(serverWorld, blockPos, duration);
\n }<\/p>\n
\n public boolean chests$forceClose() {
\n this.isOpen = false;
\n this.onClose();
\n }<\/p>\n
\n public Map
\n return this.fallUpdateMap;
\n }<\/p>\n
\n \/\/ …
\n \/\/ potential rendering stuff
\n ChestsAreChests.ejectAbove(Direction.UP, this);
\n }
\n}
\n“`
\n<\/details>\n\nItem implementation<\/summary>\n
\npublic class MyCustomItem extends Item implements ContainerItemHelper {
\n public Direction[] chests$getFallDirection(ItemStack stack) {
\n return new Direction[]{Directions.UP};
\n }<\/p>\n
\n if (!ChestsAreChests.isInArray(direction, chests$getFallDirection(stack))) return false;
\n MyGravitatedEntity entity = new MyGravitatedEntity(world, pos.x, pos.y, pos.z, stack.copy());
\n entity.setVelocity(velocity);
\n world.spawnEntity(entity);
\n return true;
\n }
\n}
\n“`
\n<\/details>\n