Configurations
Configurations
Configurations use the Bukkit Material names
- MIN sets the minimum amount that everything will stack to, but will not override higher default values. Ex: MIN: 2 would allow swords/armor/etc. to stack to 2, but dirt/cobble/etc would still stack to 64.
- MAX sets the maximum amount that everything will stack to, but will not override lower default values. EX: MAX: 32 would allow dirt/cobble/etc to only stack to 32, but still allow tools to stack at 1 and snowballs to stack at 16.
Version 1.0 +
Basic structure of items.yml
allWorlds: default: MIN: -1 // See the definitions at the top of this page for details on how to use these MAX: -1 // They can be set underneath default or any playerName, groupName, or inventoryName player: playerName: group: groupName: inventory: inventoryName:
Basics
allWorlds: default: // Everything defined here will be applied to every player, group, inventory within every world UNLESS overridden below snow_ball: 32 // allows snow balls to stack to 32 arrow: 32 // You can add as many materials as you want inventory: chest: snow_ball: 64 // Overrides the default setting to allow snow balls to stack to 64 in chests ender_chest: snow_ball: 4 // Overrides ender chests to only allow snow balls to stack to 4
Advanced
allWorlds: default: MIN: -1 MAX -1 player: haveric: // for setting up the player, just set the name here, it will get replaced with a uuid and an original name as seen below dirt: 100 fa2ebad5-7014-4e60-90fa-321236fdde9f: // autogenerated uuid original-name: haveric // autogenerated from the original setting/uuid dirt: 100 group: admin: MIN: 100 // Sets all items whose stacks are below 100 (with vanilla, that would be all items) to stack to 100. snow_ball: 64 inventory: chest: cobblestone: 16 ender_chest: disabled: true // Disables Ender Chests from being affected by StackableItems for all worlds. testWorld: default: MIN: -1 MAX: -1 group: knights,archers: // Apply configs to multiple groups with a comma tnt: 0 // Disables tnt inventory: chest,dispenser: // Apply configs to multiple inventories with a comma arrow: 100 flatland,creative: // Apply configs to multiple worlds with a comma default: MAX: 16 // Restricts all items to have at most 16 per stack. Will not affect any items with stacks below 16.
Version 0.9.4 - 0.9.5:
World support has been added and configuration has been merged into items.yml
If you are upgrading from an older version, you will need to move your defaultItems.yml and any player.yml or group.yml files you have into items.yml.
See Version 0.9 for an explanation of MIN and MAX. (Most of the time, you want to set the MIN, not the MAX)
Example of items.yml:
allWorlds: default: MIN: -1 // -1 will use default vanilla values. MAX: -1 tnt: 0 // Disables picking up and crafting of tnt dirt: 100 // Override dirt to stack to 100 cobblestone: 127 // Override cobble to 127 '5': 5 // You can use the data values (with or without quotes, it will add the quotes if you don't), Overrides wood planks to 5 admin: // Use permission group names to affect only group members (the group also needs the permission node: stackableitems.stack) tnt: -1 // Gives all admins normal use of tnt overriding the disable in default haveric: // Use any player's name to give them specific overrides MIN: 100 // You can override individual players if you want to give them different stacking amounts. In this case, I'll be able to stack anything to 100 MAX: -1 // If MIN is >= 64, max won't do anything as all values will be higher already and nothing can be brought down from vanilla Chest: // any vanilla inventory can be overridden as well MIN: -1 MAX: -1 diamond_sword: 10 // Allows stacking of diamond swords to 10 only in chests cobblestone: 100 // Allows cobble to be stacked to 100 in chests. rpg: // Create specific stacking rules per world, in this case for the world named "rpg" default: MIN: 32 // All items on rpg will stack to at least 32 (Snowballs will stack to 32, dirt will stay at 64) MAX: 48 // All items on rpg will stack to a max of 48 (Snowballs will stay at 32, dirt will stack to 48) 373: 20 // Override all potions to stack to 20 torch: 40 // Override torches to stack to 40 dirt: infinite // Will not consume dirt when placing, but will still collect it. Dispenser: iron_sword: 3 // Override iron swords to stack to 3 in dispensers.
Version 0.9 or higher:
Replaced "ALL ITEMS MAX" with MIN and MAX
- MIN sets the minimum amount that everything will stack to, but will not override higher default values. Ex: MIN: 2 would allow swords/armor/etc. to stack to 2, but dirt/cobble/etc would still stack to 64.
- MAX sets the maximum amount that everything will stack to, but will not override lower default values. EX: MAX: 32 would allow dirt/cobble/etc to only stack to 32, but still allow tools to stack at 1 and snowballs to stack at 16.
- If you want it to work as before, set both min and max to "ALL ITEMS MAX" (values above 64 only need min set as no default values go that high)
Version 0.8.9 or lower:
Sets all items to a max of 10 except for snowballs which can be up to 100 All items Max: 10 SNOW_BALL: 100 Sets all items to normal except snowballs can be up to 64 All items Max: -1 SNOW_BALL: 64 Sets all steps to 20 except for cobble steps which can be up to 40 and all other items are normal All items Max: -1 STEP: 20 STEP 3: 40 Sets all wool to 20 except white wool which is 30 and all other items are normal All items Max: -1 35: 20 35 0: 30