SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

Piles!

by Pursec · for Vintage Story

A modding library for adding coal-style piles simply and easily

6.3KDownloads
1.19.1Latest game version
Vintage Story ModDBSource

About Piles!

From Vintage Story ModDB

A modding library for adding coal-style piles simply and easily

This a modding library/tool for adding custom piles in the style of coal and charcoal from Vanilla entirely through external content mods. 



By default piles for Rot, Salt, and All types of vanilla Grain and included. 
These piles have now been extracted out to their own mod.
Check out: Granary


This library adds the following relevant classes: BlockPile, BlockEntityPile, & BehaviorPileItem

To add your own pile with this mod installed it is as follows:


  1. Create a new content mod with a blocktype file for each of the piles you wish to create (if they are variant piles such as grain, you only need 1 with variant groups)
  2. Each of these blocktypes assign them the class BlockPile and entityclass BlockEntityPile
  3. (Optional) add an attributes section to the block type to specify parameters of that pile. Any not-specified attribute will be given a default value. If the attributes array is not presnt at all, all values will be default.

    The attributes are as follows:

    "attributes":
    {
       "addItemLabel" : "String" or "LangKey",
       "removeItemLabel": "String" or "LangKey",
       "defaultAddQuantity": Integer (default: 2),
       "defaultTakeQuantity": Integer (default: 2),
       "bulkTakeQuantity": Integer (default: 4),
       "maxStackSize": Integer (default: 16),
       "interactSoundPath" : "domain:pathToSound",
       "allowUnstablePlacement": true/false (default: false)
    }
  4.  Assign a texture to the blockPile you created just as you would a vanilla block.
    1. The piles support assignment by face if desired (such as defining a different texture for "up"/the top face and a seperate texture for the sides. If wanting the same texture for all sides use the vanilla "all" key for the textures field
  5. Create a patch adding/appending BehaviorPileItem to the item you wish to pileable, with a properties array pointing to the corresponding code of the newly created blocktype.
    1. If using variants such as for example "grain" they may be defined as "grain-flax" or generically "grain-{type}", in which case you can specify the code of the pile blocktype created as "grainPile-{type}" and make sure that the blocktype for "grainPile" as the corresponding variantgroups array to have different piles per type of grain with only one blocktype file.
    2. For specifying those variant textures simply point the texture-path to the location and use the variant group {type} as you would with normal variant texturing

      The source code and example implementation from the default piles can be found at: https://github.com/Pursec/PilesPilesPiles


<pre class="language-csharp">Example of a patch file for grain supporting variantgroups:
[
    {
        "file": "game:itemtypes/food/grain",
         "op": "add",
         "path": "/behaviors",
         "value": [
                          {
                              "name": "BehaviorPileItem",
                              "properties": { "pileBlockCode": "gespiles:grainPile-{type}"}
                          }
                      ]
   }
]


<pre class="language-csharp">Example of grainPile.json

{
  "code": "grainPile",
  "class": "BlockPile",
  "entityClass": "BlockEntityPile",
  "variantgroups": [
    {
      "code": "type",
      "states": [ "spelt", "rice", "flax", "rye", "amaranth", "sunflower" ]
    }
  ],
  "creativeinventory": {
    "general": [ "" ],
    "decorative": [ "" ]
  },
  "behaviors": [
    { "name": "UnstableFalling" }
  ],
  "attributes": {
    "addItemLabel": "Add Grain",
    "removeItemLabel": "Remove Grain",
    "allowUnstablePlacement": true
  },
  "blockmaterial": "Soil",
  "lightAbsorption": 0,
  "sidesolid": { "all": false },
  "sideopaque": { "all": false },
  "textures": {
    "all": { "base": "game:block/food/grain/{type}" }
  },
  "replaceable": 100,
  "resistance": 2,
  "collisionbox": {
    "x1": 0,
    "y1": 0,
    "x2": 1,
    "y2": 0,
    "z2": 1
  },
  "selectionbox": {
    "x1": 0,
    "y1": 0,
    "x2": 1,
    "y2": 0,
    "z2": 1
  },
  "drops": [],
  "materialDensity": 600
}



If you wish to support me do so at:
Ko-fi
<a title="Patreon" href="https://patreon.com/user?u=54887552&amp;utm_medium=clipboard_copy&amp;utm_source=copyLink&amp;utm_campaign=creatorshare_creator&amp;utm_content=join_link" target="_blank" rel="noopener">Patreon

Highlights

From source data

Game versions

Supports 2 Vintage Story versions, the newest being 1.19.1.

Footprint

Rated a light load on a server.

Piles! on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Piles! on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “QoL”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Runs on your server

From source side support

Vintage Story ModDB lists Piles! as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.19.1 and 1 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓AuthorPursec, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Piles! , answered

Generated from the mod’s own source data.

Do my players need to install Piles! ?

Vintage Story ModDB lists Piles! as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Piles! is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Piles! on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Piles! in one click.