🏠 Housing - More Furniture
Documentation related to the jo_housing_more_furniture add-on for the Housing script.
The add-on adds 8,396 furniture to the build mode of Housing: 6,472 in 22 new categories, each with its own icon, and 1,924 in the 16 categories of Housing.
1. Installation
WARNING
The Housing script is required to use this add-on, in version 1.6.7 or later, with jo_libs 2.17.2 or later. With an older version, the add-on stops when the server starts.
To install jo_housing_more_furniture:
- Install Housing 1.6.7 or later and its requirements, with
jo_libs2.17.2 or later. - Download
jo_housing_more_furniturefrom your account. - Unzip it and place the
jo_housing_more_furniturefolder in your resources folder. - Start it after Housing in your
server.cfg:
ensure jo_libs
ensure jo_housing
ensure jo_housing_more_furniture💡 No SQL file, no item
The furniture of the add-on is bought and placed like the furniture of Housing: nothing to add to your database or your inventory. The add-on registers its furniture, prices and category names in Housing each time Housing starts.
2. Usage
The furniture is bought in the build mode of Housing, see Using a house.
Adding furniture
- Enter the build mode of your house.
- Press the "Add Furnitures" key (default:
A). - Pick a category: the 22 new ones are listed with the categories of Housing.
- Browse the thumbnails, or search a model name with the search prompt.
- Buy the furniture, then place it as any furniture of Housing.
Categories
3. Configuration
The configuration files are located in the config folder within the resource. This folder contains two subfolders:
_default.lock/- Contains the default configuration files. Do not edit these files directly as they may be overwritten during updates.custom/- This is where you place your custom configuration files to override the defaults.
How to customize the configuration
- Navigate to
jo_housing_more_furniture/config/_default.lock/ - Copy the file you want to modify (e.g.,
prices.lua) - Paste it into
jo_housing_more_furniture/config/custom/ - Edit the copied file in the
customfolder
The script automatically loads files from custom/ first, and only uses _default.lock/ as a fallback. This system ensures your customizations are preserved when updating the script.
Default configuration files
Prices
prices.lua sets the prices of the furniture of the add-on:
Config.furnituresCategoriesPrices: the price of each of the 22 new categories, used by all its furniture. By default{ money = 100, gold = 1 }: the player pays either $100 or 1 gold.Config.furnituresPrices: the price of one model, used instead of the price of its category.- A price set to
-1removes the category or the model from the menu.
The furniture added to a category of Housing (Beds, Lamps…) uses the price of that category in the configuration of Housing (Config.furnituresCategoriesPrices of jo_housing).
Use the Price Generator to build other prices (items, several payment options…).
The prices and the names of the add-on are sent to Housing: for a same category or model, they replace the ones of the configuration of Housing.
Category names
lang.lua holds the names of the 22 new categories in the build mode menu. A category of Housing added to this file (for example Lang.fur_cat_lamps = "Lights") is renamed too.
4. FAQ
"jo_housing requires an update" or "No such export ... in resource jo_housing"
Your version of Housing is older than 1.6.7, the version the add-on needs. Update Housing (and jo_libs to 2.17.2 or later), then restart both resources.
How do I remove a category or a furniture ?
Set its price to -1 in the configuration of the add-on: a category priced -1 disappears from the menu, a model priced -1 is removed from its category.
For a category of Housing (Beds, Lamps…), -1 only removes the furniture added by the add-on: the one of Housing stays.
Can I rename a category ?
Yes, with the language file of the add-on. A name set there also replaces the name of a category of Housing.